8/18/97 - Installing the Server Push Ticker Version 2.0 :

The Ticker applet, Scrollpush.class has been compiled to run
from your domain and must be installed in a subdirectory of that
domain named "jticker". 

Just copy the Scrollpush.class file to that directory along with 
the sample parameter files (ads.txt, myads.txt, channels.txt, etc.).
NOTE: be sure to copy/ftp the Scrollpush.class file as BINARY, the 
other files are text files and can be copied as ascii.

  scroll.html is the basic test file.

  frametest.html is a framed version of the test file.

for example if your domain is http://www.kacweb.com and the 
absolute path is /usr/bin/httpd/kac
you'd create a directory called jticker so the full path would
be 
   /usr/bin/httpd/kac/jticker
Copy all the files to this directory on your server.




Parameters:

The applet tag should MINIMALLY look like:

<applet codebase="http://www.kacweb.com/jticker" code="Scrollpush.class" Width=200 height=15>
<param Name=channel Value=ads>
</applet>

Many (if not all <G>) of the characteristics of the applet can be 
controlled by applet parameters and parameters in the 
driver files (explained below)



Here is an applet tag that uses ALL possible parameters:


<applet codebase="http://www.kacweb.com/jticker" code="Scrollpush.class" Width=250 height=15>
<param Name=channel Value=ads>
<param name=backcolor value=F2D7C6>
<param name=bordercolor value="00ff00">
<param name=highlighttextcolor value=0000FF>
<param name=channelboxcolor value=FFFFFF>
<param name=channelcolor value=00ff00>
<param name=channelshadowcolor value=FF0000>
<param name=fontsize value=12>
<param name=font value="Dialog">
<param name=horizpixshift value=4>
<param name=vertpixshift value=2>
<param name=delay value=50>
<param name=messagewait value=2000>
<param name=reloadloops value=20>
<param name=browserreload value=true>
<param name=targetframe value=main>
</applet>

All parameters except "channel" have defaults if not specified in 
the applet tag. The defaults are:

<param name=backcolor value=FFFFFF>          - white
<param name=bordercolor value="FF0000">      - red
<param name=highlighttextcolor value=>       - disabled (i.e. same as text)
<param name=channelboxcolor value=FF0000>    - red
<param name=channelcolor value=FFFFFF>       - white
<param name=channelshadowcolor value=000000> - black
<param name=fontsize value=12>
<param name=font value="TimesRoman">
<param name=horizpixshift value=4>
<param name=vertpixshift value=1>
<param name=delay value=100>                 - milliseconds
<param name=messagewait value=5000>          - milliseconds (i.e. 5 seconds)
<param name=reloadloops value=infinite>      - disabled
<param name=browserreload value=true>	     - enables reloading of messages 
					       when reload on on browser is clicked
<param name=targetframe value=main>          - default is _self

Note that all colors are specified as rgb hex colors just like
in html, but without a leading '#'.

You can set the background color to whatever you would like 
or leave the parameter line out for default white.

If the highlighttextcolor parameter is included the scrolling 
text will highlight that color when the user rolls over the 
applet.

The font size is adjustable, but be careful that you adjust the 
applet size and font to match/fit. 
If you change the font using the "font" parameter it must be 
one of the valid java fonttypes (i.e. Helvetica, TimesRoman, 
Courier, Dialog, DialogInput, ZapfDingbats). 
Note that the results will vary depending on the users computer
and operating system. 

Font color is determined in the driver file (see below).

The height and width of the applet are adjustable, but again, be careful that
you match the font size/style and strings you are displaying.

The delay parameter determines the speed of the scrolling the 
bigger the number, the slower the scrolling. It is actually the
wait between repainting the image.

The messagewait parameter determines the pause length when 
scrolling vertically. No pause is available for horizontal 
scrolling.

The reloadloops parameter will let the applet automatically
reload the current channel file after looping through it the 
number of times specified as the value of reloadloops. Be carful
with this as you don't want to be constantly pinging your server.
If not used the channel file is only loaded once when selected or
if the user manually reloads using "control-click".

The browserreload parameter allow you to cause the applet to update the
messages whenever the user clicks the browsers reload button. The default
is disabled if this parameter is not used and it can be set to eithe 
true or false. Note that actual operation of this feature may vary from
browser to browser.

The channel parameter determines what driver file is used. If
the channel value is set to "ads" it will look for a file called
ads.txt in the same directory as the class file (i.e. in the 
jticker subdirectory).

You can use whatever filenames you want other than "channels.txt" which is 
reserved, but they must be named XXXXXX.txt as that is what 
the applet will look for.

the channel box (on the right side of the applet) colors 
are adjustable using the three parameters:
<!-- param name=channelboxcolor value=FFFFFF -->
<!-- param name=channelcolor value=0000FF -->
<!-- param name=channelshadowcolor value=FFFFFF -->
channelboxcolor sets the background color
channelcolor sets the sponsor text color
and
channelshadowcolor set the text drop-shadow color.

The actual channel string displayed is set in the channel 
driver file.



The Driver files.

The driver files are simply text files with each item 
separated by "|" of the following form:
#ofitems|channel name|url1|scrolltype|color|text to scroll|
It must be terminated with a "|".


For example the ads.txt file looks like:
3|advertisers|http://www.kacweb.com|vertical|FF0000|KAC Website Design|http://www.caird.com|left|000000|Mandy Caird Webmistress Extrordinaire!|http://www.j-art.com|down|E000E0|J-Art Graphic Design|

Note: these must be one single long line of text -- this may change
in future releases. (While this still works version 2.0 has additional
features. See note below)

the url must be a full url.

color should be specified as a 6 digit hex number (no leading #) just
as text colors in the html are specified.

the scrolltype must be one of
vertical
up
down
right
left

vertical and up do the same things the text rises from the bottom of 
the applet.
down will scroll the text down from the top of the applet
left and right scroll horizontally.

The easiest thing to do is copy one of the sample files and edit it.
Be sure to set the number of items as the first item!

One special file is the channels.txt 
It must have this exact name and the file is like the other driver files
but lists the channel file names rather than urls.
It looks like:

3|Channels|headlines|vertical|000000|CH 1 - Headlines|sites|vertical|E000E0|CH 2 - Sites|ads|vertical|000000|CH 3 - Advertisements|

It is easiest to just copy the channels.txt file and 
edit it to put your driver file names in place you want 
to use. Note the names are without the extensions.

To use the channel feature just shift-click on the applet and it 
will read and display the channel information.


NOTE: Alternately (with version 2.0 and up) rather than separate each item by 
a "|" you may place each item on a separate line. 
For Example:

3
Advertisers
http://www.kacweb.com
vertical
FF0000
KAC Website Design
http://www.caird.com
left
000000
Mandy Caird Webmistress Extrordinaire!
http://www.j-art.com
down
E000E0
J-Art Graphic Design





Additional questions to:

kenny@kacweb.com
or via
http://www.kacweb.com

Best Wishes,
KAC

8/18/97