home *** CD-ROM | disk | FTP | other *** search
/ Hot Shareware 35 / hot35.iso / ficheros / 9INET / 6PACKV3.ZIP / ICONBAR1.ZIP / README.TXT < prev    next >
Text File  |  1997-09-23  |  11KB  |  231 lines
  1. ///////////////////////////////////////////////////////////////////
  2. Please load the file Readme.html into your web browser to view iconbar
  3. and the graphical instuctions. This applet is shareware. Full version
  4. available at www.buydirect.com or silk.webware.co.nz
  5. //////////////////////////////////////////////////////////////////
  6.  
  7. Applet IconBar V 1.0
  8.                         ⌐Applet IconBar V 1.0 Icon Graphics Site Navigation
  9. Silk Webware
  10. Support
  11. Single site License
  12.                                                                         
  13.  
  14.                                     Go to IconBar Demonstrations 
  15.  
  16. Part1 General Description 
  17. Part2 Setting Up IconBar on your page 
  18. Part3 Common Questions and Remedies 
  19.  
  20.      Part1 General Description
  21.      IconBar is a graphical Java Applet that can be included on any Web Page. It is used as a Web site/Internet navigation
  22.      tool. The icons you see are placed on a single .gif or .jpg image which allows fast loading, a template Image is included
  23.      on which you will place your Icons.
  24.                                                              template.gif 
  25.      IconBar also lets you to add an .au "AU format sound file" which will sound when an Icon button is pressed.
  26.  
  27.      Part2 Setting up IconBar on your page
  28.  
  29.      First of all, try loading the file afIconBar.html into your web browser, it can be used as a sample HTML file
  30.      which you can customize with your own Icons and URL Links.
  31.  
  32.      1: Constructing your ImageBar
  33.      Load the file template.gif into a graphics program that supports the .gif format. Each of the Icons that you create must fit
  34.      inside each square of the template. After you have created up to seven Icons and pasted them onto the template save
  35.      the Image with an appropriate name, this will be the name you will use to reference the Image when setting up IconBar.
  36.      Each individual Icon must not exceed 30x30 pixels in size. 
  37.  
  38.                                                                   
  39.  
  40.      2:Simple Setup To View IconBar on your page without any Links or Images the following HTML tages are required. 
  41.  
  42.      <applet
  43.      code=afIconBar.class
  44.      width=527
  45.      height=52 > 
  46.  
  47.      <param name=NoLinks value=7> 
  48.      </applet> 
  49.  
  50.      The NoLinks is the number of Icons and Links that you wish IconBar to display. IconBar will not accept any more than
  51.      seven. If you want more Icons and links than this simply set up another IconBar. In this simple setup NoLinks is set to
  52.      7. Remember No Icons will be visible at this time. 
  53.  
  54.      If you want IconBar to appear horizontally across your page the height parameter must be set to 52 and the width must
  55.      be set to: width = (NoLinks x 75)+2 
  56.  
  57.      Horizontal Setup 
  58.      height = 52
  59.      width = (NoLinks x 75)+2 
  60.  
  61.      If you want IconBar to appear vertically down your page the width parameter must be set to 77 and the height must be
  62.      set to: height = (NoLinks x 50)+2 
  63.  
  64.      Vertical Setup 
  65.      width = 77
  66.      height = (NoLinks x 50)+2 
  67.  
  68.      3: Adding the Icons to IconBar Use the IconImage parameter to reference the Image that contains your Icons. If this
  69.      image is called MyIcons.gif then the following will work. 
  70.  
  71.      <applet
  72.      code=afIconBar.class
  73.      width=527
  74.      height=52 > 
  75.  
  76.      <param name=NoLinks value=7> 
  77.      < param name=IconImage value="MyIcons.gif"> 
  78.      </applet> 
  79.  
  80.      At this stage IconBar should be displaying the Icons you have created. 
  81.      Note: If this Image is located in another directory you must specify the full URL of its location. 
  82.  
  83.      4:Adding LinkName(n),Description(n) and Url(n) Parameters 
  84.  
  85.      LinkName(n)The name of the link that appears below each icon. 
  86.      Description(n)The description of the link that appears in the web browser's status bar. This will appear when the
  87.      mouse over a specific Icon . If you choose to leave Description(n) out of the IconBar parameters the Url of the link will
  88.      show instead. 
  89.      Url(n)The URL of the link, this can either be a full URL starting with "http://" or a name of a file within the same
  90.      directory as IconBar. 
  91.      (n) is the link number. Start with 1 then 2 ..... 
  92.      Example LinkName1, Description1, Url1
  93.  
  94.      The following Horizontal setup has 5 Icons, 5 LinkNames, 5 Descriptions and 5 Urls 
  95.  
  96.      <applet
  97.      code=afIconBar.class
  98.      width=377
  99.      height=52 > 
  100.  
  101.      <param name=NoLinks value=5> 
  102.      < param name=IconImage value="MyIcons.gif"> 
  103.  
  104.      <param name=LinkName1 value="Home"> 
  105.      <param name=LinkName2 value="Applets"> 
  106.      <param name=LinkName3 value="Purchase"> 
  107.      <param name=LinkName4 value="Support"> 
  108.      <param name=LinkName5 value="Contact"> 
  109.  
  110.  
  111.      <param name=Description1 value="Silk Webware homepage"> 
  112.      <param name=Description2 value="Silk Webware Applets"> 
  113.      <param name=Description3 value="Purchase your full licensed versions "> 
  114.      <param name=Description4 value="Customer help"> 
  115.      <param name=Description5 value="Company information and contacts"> 
  116.  
  117.  
  118.      <param name=Url1 value="display.html"> 
  119.      <param name=Url2 value="http://silk.webware.co.nz/Products"> 
  120.      <param name=Url3 value="http://silk.webware.co.nz/Order"> 
  121.      <param name=Url4 value="http://silk.webware.co.nz/Support"> 
  122.      <param name=Url5 value="http://silk.webware.co.nz/Contact"> 
  123.      </applet> 
  124.  
  125.      5: RegistrationID
  126.  
  127.      Once you have purchased IconBar you will receive a RegistrationID, enter it in as a parameter; Note: Each
  128.      RegistrationID is unique and is to be used in accordance with the Single site License IconBar will show Unregistered
  129.      version when on the Internet if the incorrect RegistrationID is used
  130.  
  131.      "if your RegistrationID is F-d8ca8765-I1 then the following will work" 
  132.  
  133.      <param name=RegistrationID value="F-d8ca8765-I1"> 
  134.  
  135.      6:Optional Parameters Not required for simple setup.
  136.  
  137.      a: Frame Once you press the selected Icon, IconBar will open the page in the current frame, default "_self". To
  138.      change the frame where the page is opened use the Frame paramter. IconBar follows the standard HTML frames rules 
  139.  
  140.      "_self" ---show in the current frame <default>
  141.      "_parent" -----show in the parent frame
  142.      "_top" -----show in the top most frame
  143.      "_blank" ------show in a new unnamed top-level window
  144.      <other> -----show in top-level window named <other>
  145.  
  146.      Example:
  147.      <param name=Frame value="_blank"> 
  148.      This will cause IconBar to open the selected page in a new unnamed top-level window. 
  149.  
  150.      b:LinkNameCenter If you wish the LinkName to appear on top of the Icon, set LinkNameCenter to true. By default
  151.      LinkNameCenter is set to false
  152.      <param name=LinkNameCenter value=true> 
  153.  
  154.      c:BarFramed Setting BarFramed to true will give the effect of indenting IconBar into the page. This can be used in
  155.      conjunction with HTML tables to meet your required effect. By default BarFramed is set to false
  156.      <param name=BarFramed value=true> 
  157.  
  158.      d:BackColor IconBars default color is LightGray, if you wish to change this you can by changing BackColor.
  159.      BackColor accepts the "Hexidecimal Color format". If you change this color please ensure that the background color
  160.      within the IconImage is also changed to compliment your new color. 
  161.      <param name=BackColor value="909090"> This will change IconBars color to a darker gray 
  162.      <param name=BackColor value="ffffff"> This will change IconBars color to white 
  163.      <param name=BackColor value="ff0000"> This will change IconBars color to red 
  164.  
  165.      e:ClickSound If you want IconBar to sound when an Icon as been clicked use ClickSound. The format must be "Sun's
  166.      AU format". If you do use this option try to keep the sound file small so loading time is kept minimal. 
  167.      <param name=ClickSound value="chirp1.au"> 
  168.  
  169.      f: AllUp If you want IconBars buttons to appear all the time, rather than only when the mouse is over an Icon, set
  170.      AllUp to true. All up by default is set to false. 
  171.      <param name= AllUp value=false> 
  172.  
  173.      g: LinkNameColor The color of the LinkNames that appear on IconBar are usually black, if you want to change this
  174.      color, set LinkNameColor to the color of your choice. Note: LinkNameColor also uses the "Hexidecimal Color
  175.      format". 
  176.      <param name=LinkNameColor value="ff0000"> will color LinkName Red. 
  177.  
  178.      h: LinkNameBold If you wish LinkName to appear BOLD set this to true. 
  179.      <param name=LinkNameBold value=false> 
  180.  
  181.      i: LinkNameFont To change the FONT face from Helvetica use LinkNameFont. 
  182.      <param name=LinkNameFont value="Helvetica"> Default value 
  183.      <param name=LinkNameFont value="Courier"> 
  184.      <param name=LinkNameFont value="TimesRoman"> 
  185.  
  186.      j: LinkNameSink If you wish the LinkName to appear sunken into the IconBar set this to true. LinkNameSink by
  187.      default is false. 
  188.  
  189.      Part3 Common Questions and Remedies 
  190.  
  191.      If you have problems contact support@silkwebware.com
  192.      The most Common mistake webpage designers make when using IconBar is incorrect "case". Follow the sample html
  193.      files using uppercase and lowercase respectively. 
  194.  
  195.      Q1: Why canÆt I see IconBar on my page? 
  196.      a: You may have made a mistake in the HTML tags used to embed the Control Pad on your page. Check both the
  197.      Spelling and the Case. 
  198.      b: Have you included the appropriate .class files in the same directory as the page containing the IconBar Control Pad?
  199.      The following are both required.
  200.  
  201.      afIconBar.class
  202.      afIcon2.class
  203.  
  204.  
  205.      If you want to use IconBar on many pages within your site you can add Codebase after "code=" This means you only
  206.      have to keep the two files in one place. 
  207.      code=afIconBar.class codebase=http://www.yoursite.com/DirectoryWithClassfiles/ 
  208.      c: Are you using a Java enabled browser? Find out how to get one. Most browsers released today are Java enabled. 
  209.  
  210.      Q2: Why wonÆt a IconBar linked page open? 
  211.      a:Have you entered the correct URL in the Url(n) parameter 
  212.      b:Does the page IconBar is trying to open (still) exist 
  213.  
  214.      Q3: Why are my Icons messed up? 
  215.      a:Have you used the template.gif as your base to draw your Icons. 
  216.      b:Dose the BackColor of IconBar match the back ground color of the Icons. 
  217.  
  218.      Q4: Why are there no IconImage images? 
  219.      a: Check your Html parameters, spelling and case 
  220.      b: The image you are referring to may be a .gif not a .jpg (vs/vs) 
  221.  
  222.      Q5: I have just changed the parameters of the IconBar Control Pad, but it appears the same as before. 
  223.      a: You must reload the page in a new browser window, and completely clear the cache. Also try:
  224.      (tm)Netscape: press the shift key and the Reload button at the same time. 
  225.      (tm)Internet Explorer: press the refresh button. 
  226.  
  227.                  If you have any questions regarding the correct setup of IconBar, please email us at
  228.            support@silk.webware.co.nz For more exciting webpage enhancements please visit Silk Webware
  229.                                             at Silk Webware
  230.  
  231.