Volano Chat

Now you can add LIVE CHAT to your Professional Plan or higher web site account. The Volano chat system is a combination of server and client side Java programs. The client side Java applet (30k to 100k depending on browser) is downloaded by the browser and then executed on the user's local machine. The client applet then communicates with the software located on the server to create a live real-time chat environment.

Note that the downloading of the chat applet and any custom images you create for the applet are counted as data transfer.

To implement the chat applet on your site follow these two simple steps:

Step 1:

Create an HTML file called chat.html in your root directory with the below applet code in it and save it in the root directory of your site.

<applet codebase="http://www.your-domain.com/cgi-image/vcclient"
code="COM.volano.MyVolanoChat.class" width=500 height=65>

<param name="cabbase" value="COM/volano/MyVolanoChat.cab">
<param name="color" value="
<param name="group" value="
Chat Room Name">
<param name="text" value="

You can modify the color of the chat applet, the name of the chat room, and the language of the text used by modifying the values within the "color", "group", and "text" parameters above. The language value can be any of the following: english.txt, french.txt, german.txt, italian.txt, portuguese.txt, or spanish.txt

Step 2:

Create an absolute link somewhere on your site that links to your newly created chat.html page like this:

<a href="http://www.your-domain.com/chat.html">Enter our chat room</a>

Note: You must reference your full domain name for your account, including the www., or the chat will not work. You also cannot reference the chat using a machine name or a domain pointer. Users are only allowed one chat room per account. Also, the chat.html page with the above applet code in it must be located in the root directory of your account and must be named chat.html.

You're done!
That's all it takes to add LIVE CHAT to your site!

Customizing Volano Chat

Note: Volano Chat is a third party product and, as such, we do not provide support for the product. For more information about Volano Chat and how to customize it, please visit the Volano web site. The following instructions should be enough to get you started, but they are not intended to act as comprehensive documentation. Also, don't worry too much about making mistakes; you can always start over.

To customize the Volano Chat applet, download one of the below language configuration files. This is the file that has the default language settings that will be used in the chat applet. You can then modify this file, upload it to your site, and reference it in your chat applet code.

The default language settings come in several different languages. Download the one that is appropriate for your use:

(Note: hold the SHIFT key when clicking on one of the below links to save it locally instead of viewing it in the browser.)

Note that many of the settings in these files will not apply to your chat applet because we only allow one chat room per account and we do not offer many of the enhanced features such as kick, ban, and usage stats. If you are not sure about what you are doing, it may be best not to modify any of the existing lines. Many of the customization options you may wish to make involve adding additional lines of code to these files, which we explain how to do below.

Customizing Volano Chat involves modifying or adding to your personal language configuration file. After making your desired changes, upload the file to your domain in ASCII mode. Then you will need to configure the applet code in your chat.html page to use your customized configuration file. To do this, you will need to modify the "text" parameter in the <applet> html tag.

<applet codebase="http://www.your-domain.com/cgi-image/vcclient"
code="COM.volano.MyVolanoChat.class" width=500 height=65>

<param name="cabbase" value="COM/volano/MyVolanoChat.cab">
<param name="color" value="#FFFFFF">
<param name="group" value="Chat Room Name">
<param name="text" value="


Changing the Banner Ads

By default, the banner advertisement settings are not in the language files. In order to modify the banners you will need to add the following code to your custom language configuration file:

# Advertisement settings.

# Advertisement banners.
ad.1=20 /my_ads/ad1.gif http://www.volano.com/
ad.2=20 /my_ads/ad2.jpg http://www.yahoo.com/
ad.3=20 /other_ads/cnn_ad.gif http://www.cnn.com/
ad.4=20 /other_ads/cnn_ad2.gif http://www.cnn.com/

You can turn advertising on or off by setting ad.on to true or false. The width and height are the size of the banner ad images in pixels. The target can be any window name allowed by the HTML target attribute, including the magic values of _blank, _self, _parent, and _top.

Ads can be either images (as GIF or JPEG files) or Java applets. Don't use animated GIFs because they don't seem to work well, if at all. Also, keep your image file sizes small (less than 20k each) to help prevent any problems.

Ads for images must have three items, separated by a single space:

  1. the time (in seconds) to display the ad,
  2. the banner image location
    ( begin URL with forward slash:   /ad_dir/image.gif )
  3. the URL to display when the user clicks on the ad

The numeric suffix on each property (ad.1, ad.2, ..., ad.n) must be sequential and start with the number 1. This suffix gives the sequence of the advertisement banners.

You must define at least 4 banner ads in order to override each of the 4 default Volano banner ads. For instance, if you only define ad.1 and ad.2, then users will see the default Volano banner ads ad.3 and ad.4 after your ads. If you want to have only 1 banner ad, just list that one banner four times.

Changing the Chat Room Colors

By default, the chat room is gray with black text. You can change these colors by adding the following code to your language configuration file:

# Applet window colors.

The color.background attributes define the background color of the chat room. The color.foreground attributes define the text color of the chat room.

The colors are standard RGB colors whose values range from 0 to 255. For example:
white: (red=255, green=255, blue=255)
black: (red=0, green=0, blue=0)
yellow: (red=255, green=255, blue=0)

Changing the 'Enter Chat Room' buttons

By default, your chat applet will display a 'Volano' button which users click to enter the chat room. This too can be customized by adding the following code to your language configuration file:

# Applet images.

image.button1 is the 'Volano' button that you push to enter the chat room.

image.button2 is the 'Chat' button that appears when you move your mouse over the 'Volano' (image.button1) button.

Important Note: If you do not notice any changes you made to your chat applet, clear your browser's cache. Just hitting 'reload' or 'refresh' most often will not be enough. You may even need to quit and restart your browser to adequately clear your cache.

For more information about configuration options, visit the Volano web site.


Send mail to webmaster@ab-web.com with questions or comments about this web site.
Content Copyright 1998-2001 by ab-WEB Corporation, All Rights Reserved.
Any mentioned name, registered trademark, trademark, or service mark, is the exclusive property of its respective owner and is only mentioned here as a reference to that company's product and/or service.