SPINALINK SETUP

//////////////////////////////////////////////////////////////
Spinalink Demo V 3.0 This is a Demonstration Version Only!
//////////////////////////////////////////////////////////////
SPINALINK V3
©Spinalink Link Selector description and instructions
Spinalink Demo

Part1 General Description
Part2 Setting Up Spinalink on your page
Part3 Common Questions and Remedies

Part1 General Description
Spinalink can be included on any html webpage and does not require a Java server. A visitor can view your links by selecting an arrow button. Once the desired link is in view it may be followed by clicking on the select button. Spinalink can hold as many links as required, however Searchlink is recommended for more than 20 links. "©Searchlink is another product from Silk Webware"
Part2 Setting Up Spinalink on your page
Spinalink is easy to set up and use, if you have any trouble please do not hesitate to email us at support@silk.webware.co.nz.
1: Simple setup: RegistrationID Note: The sample file afSpinalink.html is included SpinDemo1.html. In the simple setup below no links will appear in the link Window.
<applet
code=afSpinalink.class
width=340
height=78 >
<param name=RegistrationID value="Q7182">
</applet>
In the simplest setup these html tags are included on the page that you wish spinalink to be on. Within the same directory as this html file you must include three files afSpinalink.class, afSpin2.class and afSpin3.class
Once you have purchased your RegistrationID enter it in as a parameter;
Note: Each RegistrationID is unique and is to be used in accordance with the Single Site License Spinalink will display Unregistered version if the incorrect RegistrationID is used when Spinalink is on the Internet
"if your RegistrationID is du8765 then the following will work"
<param name=RegistrationID value="du8765">
2: Simple setup: Height Width parameters
You can change the width of Spinalink by changing the width paramter. You should keep the height parameter set at 78.
<applet
code=afSpinalink.class
width=340
height=78 >

<param name=RegistrationID value="RegistrationID">

</applet>
3: Adding the links to Spinalink
The following example adds a single link to spinalink. The NumberofItems parameter must contain the exact number of links within spinalink. The Title(n) parameter is the name of the link name that will appear in the link name window. The (n) is the link number. The Address(n) parameter is the http address "URL" of the corresponding Title parameter. The (n) of the Title parameter must match with the respective (n) of the Address parameter.
<applet
code=afSpinalink.class
width=340
height=78 >

<param name=RegistrationID value="RegistrationCode">

<param name=NumberofItems value=1>
<param name=Title1 value="Silk Webware">
<param name=Address1 value="http://silk.webware.co.nz">
</applet>
Spinalink in this case would contain the link name "Silk Webware" in its links name window and clicking on the enter button would open the Silk Webware homepage at http://silk.webware.co.nz
The following would add 4 links to Spinalink.
<applet
code=afSpinalink.class
width=340
height=78 >

<param name=RegistrationID value="RegistrationCode">

<param name=NumberofItems value=4>
<param name=Title1 value="Silk Webware">
<param name=Address1 value="http://silk.webware.co.nz">
<param name=Title2 value="Microsoft">
<param name=Address2 value="http://www.microsoft.com">
<param name=Title3 value="Gamelan">
<param name=Address3 value="http://www.gamelan.com">
<param name=Title4 value="Javasoft">
<param name=Address4 value="http://www.javasoft.com">

</applet>

4:Optional setup: Frame parameter
With this version of Spinalink we have included the option of allowing the "Linked" page to be opened in the frame of your choice. If you decide to ignore this option, Spinalink will open the page in the current frame . The following are the values which are currently accepted. Spinalink follows the current standard HTML conventions with respect to frames.
"_self" ---show in the current frame <default>
"_parent" -----show in the parent frame
"_top" -----show in the top most frame
"_blank" ------show in a new unnamed top-level window
<other> -----show in new top-level window named <other>
Example:
<param name=Frame value="_blank">
This will cause Spinalink to open the "linked" page in a new unnamed top-level window.
5:Optional setup: BackImage parameter Some designers have asked that we include a background image, this allows you to improve the general appearance of Spinalink. You may wish to set this parameter to the current background of the page. Please experiment with BackImage as certain colors and patterns can enhance the general appearance dramatically. Please note that only .jpg and .gif formats are acceptable. Hint: keep the patterns and colors within the graphics files as soft as possible. Spinalink will automatically "wallpaper" the Spinalink panel, so the size of the image is not important ,however larger images do take longer to load!
Add a BackImage like this;
<param name=BackImage value="marble2.gif">
Example:
<applet
code=afSpinalink.class

width=340
height=78 >
<param name=RegistrationID value="L6162">
<param name=Frame value="_self">

<param name=BackImage value="marble2.gif">

<param name=NumberofItems value=4>
<param name=Title1 value="Silk Webware">
<param name=Address1 value="http://silk.webware.co.nz">
<param name=Title2 value="Microsoft">
<param name=Address2 value="http://www.microsoft.com">
<param name=Title3 value="Gamelan">
<param name=Address3 value="http://www.gamelan.com">
<param name=Title4 value="Javasoft">
<param name=Address4 value="http://www.javasoft.com">

</applet>

6:Optional setup: ShowButton parameter If you set this parameter to false Spinalink will not display the "green ring" button. Links can be followed by clicking once over the selection. By default ShowButton is set to true.
<param name=ShowButton value="false">
Example:
<applet
code=afSpinalink.class

width=340
height=78 >
<param name=RegistrationID value="L6162">

<param name=ShowButton value="false">

<param name=BackImage value="marble2.gif">
<param name=Frame value="_self">
<param name=NumberofItems value=4>
<param name=Title1 value="Silk Webware">
<param name=Address1 value="http://silk.webware.co.nz">
<param name=Title2 value="Microsoft">
<param name=Address2 value="http://www.microsoft.com">
<param name=Title3 value="Gamelan">
<param name=Address3 value="http://www.gamelan.com">
<param name=Title4 value="Javasoft">
<param name=Address4 value="http://www.javasoft.com">

</applet>

7:Optional setup: Link Attributes
These are the other optional parameters that Spinalink accepts.
- ShowNumber <param name=ShowNumber value="true">
 If you wish to display the number "index" of the link, set this parameter to true. By default ShowNumber is false.
- LoopLinks <param name=LoopLinks value="true">
 If you wish the Links to loop at the limits of the list, set this parameter to true. By default LoopLinks is false.
- Bold <param name=Bold value="true">
 Set this to true for a Bold typeface. By default Font is false.
- Font <param name=Font value="TimesRoman">
 If you wish to change the Font enter it here. The default Font is TimesRoman.
- LinkColor <param name=LinkColor value="FF0000">
 If you wish to change the Link Color please enter your hexidecimal color here. The default color is "FF0000" RED
8:Full Setup Example This sample setup shows all the HTML tags required show the marble2.gif both as the background of the page but also the background of Spinalink.
<html>
<head>
<title> Spinalink</title>
</head>
<body background="marble2.gif">
 
<center>

<applet
code=afSpinalink.class
width=340
height=78 >
<param name=RegistrationID value="L6162">
<param name=ShowButton value="false">
<param name=Frame value="_self">
<param name=BackImage value="marble2.gif">
<param name=NumberofItems value=4>
<param name=Title1 value="Silk Webware">
<param name=Address1 value="http://silk.webware.co.nz">
<param name=Title2 value="Microsoft">
<param name=Address2 value="http://www.microsoft.com">
<param name=Title3 value="Gamelan">
<param name=Address3 value="http://www.gamelan.com">
<param name=Title4 value="Javasoft">
<param name=Address4 value="http://www.javasoft.com">

</applet>
</center>
</body>
</html>
Part3 Common Questions and Remedies
The most Common mistake webpage designers make when using Spinalink is incorrect "case". Follow the sample html files using uppercase and lowercase respectively.
Q1: Why canÆt I see Spinalink on my page?
a: You may have made a mistake in the HTML tags used to embed Spinalink on your page. Check both the Spelling and the Case.
b: Have you included the appropriate .class files in the same directory as the page containing Spinalink The following are all required.
afSpinalink.class
afSpin2.class
afSpin3.class
c: Are you using a Java enabled browser? Find out how to get one. Most browsers released today are Java enabled.
Q2: Why can't I see my links and why won't they open?
a: Have you supplied the correct address "URL".

b: Have you used the correct case when entering the Title, Address and NumberofItems parameters.
c: Have you given the "NumberofItems" parameter the exact value of links. Example: if you have 10 links

<param name=NumberofItems value=10>

d: Remember each new link requires a new number after each set of Title and Address parameters. Please see previous examples.
e: Is the link still valid?
Q3: Why does Spinalink display "Unregistered version!"
a:Have you a correct RegistrationID, check the sequence and case.
b:Is the Version of Spinalink SpinalinkV3 or afSpinalink this is the only version that accepts RegistrationID, "Older versions that accept UserCodes will not accept RegistrationID"
c: If you have a RegistrationID and Spinalink still displays Unregistered version!, Email us at support@silk.webware.co.nz, we will check out the problem for you.
Q4: Why is there no background image?
a: Check your Html parameters, spelling and case
b: The image you are referring to may be a .gif not a .jpg (vs/vs)
c: Is the image file in the same directory?

Q5: Why does the Link Color stay red?
a: You must supply the color in hexidecimal format. Here are some examples, white "FFFFFF" , red "FF0000" ,green "00FF00", blue "0000FF", yellow "FFFF00", orange "FFA500", aqua "00FFFF"
Q6: I have just changed the parameters of Spinalink but it appears the same as before.

a: You must reload the page in a new browser window, and completely clear the cache.
If you have any questions regarding the correct setup of Spinalink, please email us at support@silk.webware.co.nz For more exciting webpage enhancements please visit Silk Webware
at Silk Webware