|Table of Contents|
11.1 Hosted VolanoChatPro Chat Rooms
If you have been provided with a VolanoChatPro Personal Chat Room through your hosting provider, the following information will assist you with customization options, some technical support issues, and a review of certain limitations.
- VolanoChat Personal Chat Rooms & Web Hosting Providers
- VolanoChat Personal Chat Room limitations
- Technical Support issues
- Verio Customers (Verio, Hiway, Rapidsite, etc.)
- Hostway Customers
- TierraNet Customers
- Modifying & Customizing your VolanoChat Personal Chat Room
Any problems you are having with your Personal Chat Room need to be addressed directly with your Web hosting provider. Please write to the webmaster or administrator of the Website where you are having trouble, and if necessary, we will work directly with them to assist in solving the problem.
Volano Software has made no special arrangements, agreements, licensing conditions, or other contractual arrangements with your Web hosting provider other than our standard Software License Agreement distributed with our product.
The only VolanoChat server that is run by Volano Software as a demonstration of our software is located at:
Although many Web hosting providers put links on their web pages to our online Administrator Guide, please note that this documentation provides complete technical information for our customers who have purchased a full version of VolanoChat or VolanoChatPro directly from Volano Software to run on their own Web servers, such as your web hosting provider. Much of this information is not applicable to a single Personal Chat Room offered as a service by a Web hosting provider. The following information is the limit of our technical support responsibilities. All other inquiries should be directed to your Web hosting provider.
VolanoChat Personal Chat Rooms provide for a community chat room for your Web site. Your Web hosting provider can provide the following information about your Personal Chat Room:
- the maximum number of people allowed per room (This is an administrator setting determined by your Web hosting provider)
- the number of rooms your web hosting providers allows you to have (Most web hosting providers only allow for one Personal Chat Room per Web Site.)
- customizing your Personal Chat Room including fonts, colors, banner advertisements, logos, etc. (Also listed below)
- whether you can display remote advertisements through the VolanoChat server's Proxy Servlet (This depends upon whether your Web hosting provider is running the built-in servlet runner, and the Port settings.)
VolanoChat Personal Rooms offered by web hosting providers do not have the following features:
- monitoring (ability to remove, kick, and ban users).
- word filters
- administrative control
- chat room embedded into a web page
These features are available only to the owner or administrator of the VolanoChat server (except for word filters, which are not currently available). Please see our online store for information about purchasing and running your own VolanoChat server on your own dedicated machine.
If you are experiencing difficulty accessing your chat room, or received any of the following error pages:
- Unauthorized Access
- Unauthorized Web Page
- Unable to connect
these are problems that only your web hosting provider can correct. These problems may include the following:
- Your web hosting provider's machines may be down for maintenance.
- Your web hosting provider may not have set up your account properly to allow access to the VolanoChat server from your Web site.
- Your HTML tags calling the MyVolanoChat applet are not correct per your web hosting provider's instructions.
- The Personal Chat Rooms offered by web hosting providers (using the "MyVolanoChat" applet) derive their name from the URL that called the applet. The URL is case sensitive, and must be set up exactly as your web hosting provider has indicated. If not, you will receive an error message when you try to connect to the VolanoChat server.
- Your web hosting provider may be hosting several Web sites with chat rooms on this VolanoChatPro server, and it may, indeed, be full.
If you are a customer of Verio, or any of their companies (Verio, Hiway, Rapidsite, etc.), the instructions for including a VolanoChat Personal Chat Room on a web page is located at:
Verio provides for one (1) VolanoChat Personal Chat Room per domain name and requires that the referring URL for the "chat.html" page must be in the following format:
Any variations will cause you to receive the "Unauthorized Access" error page. The most common reason results from omitting "www." from the referring URL.
Hostway purchased a VolanoChatPro-50 Version 2.0 license from us to run on their machines. Hostway is supporting hundreds of their customers with an earlier version of our software that only allows 50 people to connect and chat at one time.
If you are having problems accessing or entering your chat room, the most likely reason is that this 50-user limit has been reached.
Hostway purchased the software from Volano to run on their own machines, to which we have no access. Hostway administers the software and is responsible for the customization, installation, and administration of their VolanoChatPro server.
Any problems, concerns, complaints, or questions regarding use of the VolanoChatPro server by Hostway should be directed to them.
If you are a customer of TierraNet, the instructions for including a VolanoChat Personal Chat Room on a web page is located at:
Below are answers to the most common questions regarding modifying the chat applet, modifying and displaying banner advertisements, and translating to other languages.
Modifying Chat Applet Properties
Using the MyVolanoChat Applet (Personal Chat Rooms), you can override the properties in the default properties file (
english.txt by default) by including them in the applet's HTML. For more information, please the information about the MyVolanoChat applet in our Administrator Guide. If your Web Hosting Provider is using an earlier version of our software, many of these applet properties may not be available.
For a complete description of the properties included in the
english.txt file, please see VolanoChat Properties
Please note that most web hosting providers do not allow you to modify the
english.txt file directly. You can use the link above as a descriptive guide for overriding the properties directly on your web page in your applet tags, as below.
For example, the following three properties are found in the
english.txt file and are used to display colors and fonts in the chat room.
color.background=#C0C0C0 color.foreground=#000000 font.default=TimesRoman-15
To override these using the MyVolanoChat applet on your Web page in your applet HTML tags, you would do so in the following format:
<param name="x" value="y">
Where "x" is the property, and "y" is the value. For example, to change the colors and fonts, you would add the properties as applet parameters as follows:
<param name="color.background" value="#FFFFFF"> <param name="color.foreground" value="#C0C0C0"> <param name="font.default" value="Helvetica-12">
This displays 12 point Helvetica in gray type on a white background. Images, buttons and logos that you are using to override the defaults are relative to the directory of the applet's codebase. A Java applet can only connect back to, or call resources (jpegs, gifs, etc.) from the machine from which it was served. If you are calling resources from a different machine/host, you must use the Proxy Servlet, provided that your web hosting provider has started it. For more information, please see Proxy Servlet.
Modifying BannerPlayer Applet Properties
To customize the BannerPlayer applet embedded in the banner space of the chat room, the properties for the embedded applet can be defined with the prefix "banner.param". For example, you can define the background parameter of the embedded BannerPlayer applet with the following MyVolanoChat applet parameter:
<param name="banner.param.background" value="#FFFFFF">
To change an image, for example, you might specify the following:
<param name="banner.param.banner.n" value="x y z">
Where "n" is a positive integer that defines the sequence number of the banner image. The numbers must be sequential and start with the number 1. The "x" value is the time, in seconds (a value of "0" displays the image until the applet is stopped); "y" is the image source, usually requiring a complete URL; and "z" is the absolute or relative URL to which this image is linked, or the keyword "null" if the image has no link. Note that the three values are separated by a space or tab and MUST be all on one line. (Make sure that your HTML editor does not word-wrap these lines.)
For more information, please see BannerPlayer Applet.
Images and banners that you are using to override the defaults are relative to the directory of the applet's codebase. A Java applet can only connect back to, or call resources (jpegs, gifs, etc.) from the machine from which it was served. If you are calling resources from a different machine/host, you must use the proxy servlet, provided that your web hosting provider has started it. For more information, please see Proxy Servlet.
Also, see Remote Ad Servers.
If (and only if) your web hosting provider is using the default servlet runner port of 8080, then calling banner ads from your own directory using the proxy servlet could look something like the following. This parameter must be all on one line (cannot "word-wrap").
<param name="banner.param.banner.n" value="x y z">
- n = a positive integer that defines the sequence number of the banner image.
- x = the time, in seconds (a value of "0" displays the image until the applet is stopped)
- y = the image source called through the proxy servlet in the following format:
http://[codebase host]:8080/servlet/proxy?src=[image URL]
- z = the absolute or relative URL to which this image is linked, or "null"
In the applet tags, your host has instructed you to list a specific "codebase", for example:
In this case, "www.hostname.com" is the host where the VolanoChatPro server is running.
Further, let's say your image ("image.gif") is at the following location:
This would translate as follows (and must be all on one line):
And then your parameter in the HTML on your web page would look something like the following (but all on one line; do not word wrap):
<param name="banner.param.banner.1" value="10 http://www.hostname.com:8080/servlet/proxy?src=http://www.mydomain.com/image.gif http://www.mydomain.com">
If this does not work for you, then please check with your hosting provider for the following conditions:
- Your hosting provider may not have started the Proxy Servlet, or has disabled it.
- Your hosting provider has disabled the use of banner ads entirely.
- Your hosting provider is using a port for the Proxy Servlet other than the default of 8080.
- Your hosting provider may not allow overriding applet parameters.
Translating Applet Properties
VolanoChat can be translated into any language, including double byte and non-Western characters, simply by translating the client applet's parameter values.
Again, for information on the VolanoChat client applet properties files, please see VolanoChat Properties.
For example, in the default applet's properties file, you are prompted for your name and profile in English. In the
english.txt file (as explained earlier), the properties are as follows:
text.main.username=Your name: text.main.profile=Your profile:
To override this property and change it to Spanish, you would include the following parameters in your applet's HTML:
<param name="text.main.username" value="Su nombre:"> <param name="text.main.profile" value="Su perfil:">
For double byte and non-Western characters, you must convert the values of the parameters from the native language into an ASCII representation of unicode values. For more information, please see Translating VolanoChat.
If you have followed the instructions, above, then any of your visitors who also have their operating system and web browser set up for these languages will have no problem seeing the menus and chat in that language. Please keep in mind that VolanoChat is not a "translating" software. The information above assumes that both speakers of the language have localized versions of their operating systems installed on their machines in order to chat in that respective language.
|XHTML 1.0||Table of Contents|