Previous Next Up FAQ Table of Contents

7.1.2 VolanoChat Applet Properties

The properties file

The VolanoChat applet has more than 250 properties you can modify in order to customize the language, banner applet, colors, fonts, images, text, and sounds of your chat rooms. Whenever the VolanoChat, MyVolanoChat, or WebVolanoChat applet is downloaded to a Web page, the applet determines its appearance by reading from its properties file. The properties file is defined by the value of the applet's text parameter:

<param name="text" value="filename.txt">

where filename.txt is the name of the properties file. For a complete description of the applet tag and the VolanoChat applet parameters, see the previous section. Volano provides six sample property files, each with a different language translation:

english.txt
an English language property file.
french.txt
a French language property file.
german.txt
a German language property file.
italian.txt
an Italian language property file.
portuguese.txt
a Portuguese language property file.
spanish.txt
a Spanish language property file.
dutch.txt
a Dutch language property file.
your-translation.txt
a translation into any other language that you can provide.

These translations are just a set of samples you can use to translate the entire VolanoChat, MyVolanoChat and WebVolanoChat user interfaces into any language—even non-Western languages such as Japanese, Chinese and Korean. Please see the [8.1] Translating VolanoChat feature page for information on translating into non-Western character sets. For languages using Western character sets, simply copy and edit one of the files listed above.

Removing properties

To remove a property value, set it equal to nothing, like this example:

banner.code=

This example removes the rotating banner player at the top of the chat window. If you delete the property definition, or comment it out by putting the character "#" at the beginning of the line, the VolanoChat applet will use the internal default value for the property. By setting the property value to nothing, you can make sure to override the default value and disable the property.

Property names and values

To customize the appearance of your chat rooms, simply edit the properties file that will be used by the applet. The files are located by default in the vcclient directory. All of the applet properties are defined below, showing the default value for each property. In cases where the internal default differs from the default value in the properties file, the internal default is also noted so that you will know the result of commenting out or removing that property.

Note that for file path names, you must specify the path in Web notation (using a forward slash "/" instead of the Windows backslash "\"). Uniform Resource Locators (URLs) may be relative or absolute, with relative URLs assumed relative to the location of the applet properties file. There can be no spaces on either side of the equals sign.

If you use an absolute URL in a property definition, make sure you understand the security restrictions of Java applets, described in the VolanoChat Servlets Chapter. That chapter shows you how you can use the VolanoChat proxy servlet to safely bypass the applet network security restrictions.

General

override.myvolanochat=true
indicates whether or not people using the MyVolanoChat applet to create personal chat rooms in your VolanoChat server may override any of the applet properties by specifying different values for them directly on the Web page. Specify true if you want to allow people creating personal chat rooms to define their own text, colors, fonts, and banner advertisements for their chat rooms. Otherwise, specify false.
server.port=8000
the port number at which your VolanoChat server accepts chat connections. The value must be the same as the VolanoChat server server.port property value in your properties.txt file in order for the client applet to connect to the correct server port number.
limit.public=5
limits the number of chat rooms any one person connecting to your VolanoChat server may enter. A value of zero prevents the person from entering any chat rooms. -1 means there is no limit on the number of chat rooms any one person may enter. Monitors and administrators can enter an unlimited number of rooms.
limit.private=5
limits the number of private chat sessions any one person connecting to your VolanoChat server may create and the number of private chat requests any one person can receive. A value of zero allows no private chat sessions at all. A value of -1 allows an unlimited number of private chat sessions for each person. Monitors and administrators can initiate an unlimited number of private chat sessions.
history.enable=false
determines whether or not the chat message history is enabled. A value of true allows the up and down arrow keys to scroll through the list of messages sent in a manner similar to Microsoft's DOSKEY command recall feature. A value of false disables the up and down arrow keys in the chat message text field.
filter.enable=false
determines whether the Room Filter label and text field are displayed. A value of true displays the Room Filter label and text field as in earlier versions of the VolanoChat applet. Otherwise, the Room Filter label and text field are removed in the VolanoChat applet.
send.private.disable=false
When true, this property disables the initiation of private chat sessions from the applet. Otherwise, it allows the initiation of private chat sessions.

Membership

member.document=
defines the Uniform Resource Locator (URL) of the member profile link that is placed in front of the profiles of members. The link will be dynamic if specified as a CGI script with parameters for the member name and name of the person requesting the member profile. See the section [5.7] Member Database Support for more information about the membership CGI scripts.
member.editable.name=true
indicates whether the name field is editable when a name is provided with the username applet parameter. A value of true allows the name to be changed on the main chat window. A value of false prevents the name from being modified.
member.editable.profile=true
indicates whether the profile field is editable when a profile is provided with the profile applet parameter. A value of true allows the profile to be changed on the main chat window. A value of false prevents the profile string from being modified.
member.monitor=false
enables the monitoring user interface in the VolanoChat applet when true, but allows it to work only for authorized member-monitors. For more information, see the Member Monitor section of the [7.1.5] Monitor Interface page.

Custom Label

label.text=
An extra line of linked text that can be put below the status and profile area of the applet.
label.link=
An optional URL for the label text.
label.url=
A dynamic URL service which overrides the static label above to fetch a text string and corresponding link from an advertisement or announcement Web service. The service should return in its HTTP response Java properties with the names defined below.
label.url.text=
Defines the name of the Java property returned whose value is the text string to display.
label.url.link=
Defines the name of the Java property returned whose value is the URL for linking the text.

For example, if a dynamic text-based ad service at the following address:

http://www.yourdomain.com/textad.php

returns the following content:

alt=Get your chocolate here!
href=http://aaa.bbb.ccc/chocolate.html

you would define your VolanoChat applet properties as:

label.url=http://www.yourdomain.com/textad.php
label.url.text=alt
label.url.link=href

Note that, as with remote banner advertisement services, you may need to use the VolanoChat ProxyServlet if the remote ad server is on a machine other than the one running your VolanoChat server. Web browsers allow Java applets to connect only to the machine that delivered them, so they need a proxy service to connect through to any remote ad servers.

Banner applet

banner.code=COM.volano.BannerPlayer.class
the name of the Java applet to be embedded in the banner area above each chat room. Any Java applet class file may be defined. The applet must be placed in the same codebase as the VolanoChat applet. For information on the BannerPlayer applet provided with VolanoChat, see the [7.4] BannerPlayer Applet page. For information on replacing the banner player with another Java applet, see the [7.5] Adding Other Applets page. To remove the banner player above the chat room, set this property to nothing.
banner.parameters=BannerPlayer.txt
the Java properties file containing the parameters of the banner player Java applet, specified as name and value pairs. The parameters you define are specific to the Java applet embedded in the chat rooms.
banner.width=468
the width in pixels to reserve for the Java applet above the chat room.
banner.height=60
the height in pixels to reserve for the Java applet above the chat room.

Logo applet

logo.code=COM.volano.BannerPlayer.class
the name of the Java applet to be embedded in the logo area of the main VolanoChat applet window. Any Java applet class file may be defined. The applet must be placed in the same codebase as the VolanoChat applet. For information on the BannerPlayer applet provided with VolanoChat, see the [7.4] BannerPlayer Applet page. For information on replacing the banner player with another Java applet, see the [7.5] Adding Other Applets page. To remove the banner player from the logo area, set this property to nothing.
logo.parameters=LogoPlayer.txt
the Java properties file containing the parameters of the banner player Java applet running in the logo area, specified as name and value pairs. The parameters you define are specific to the Java applet embedded in the logo area.
logo.width=100
the width in pixels to reserve for the Java applet in the logo area.
logo.height=220
the height in pixels to reserve for the Java applet in the logo area.

Colors and fonts

All colors are specified in standard web notation #RRGGBB, where RR is the red hexadecimal value, GG is the green hexadecimal value, and BB is the blue hexadecimal value.

color.background=#A0B8C8
the background color of the main chat window and all the chat rooms, If undefined, the internal default is #FFFFFF.
color.background.button=#FFFFCC
The actual color of the button. If undefined, the internal default is #FFFFFF.
color.background.list=#DCDCDC
The background color of any lists such as the list of users and list of rooms. If undefined, the internal default is #FFFFFF.
color.background.text=#DCDCDC
The background color of any non-editable text areas. If undefined, the internal default is #FFFFFF.
color.background.text.editable=#FFFFFF
The background color of any editable text area.
color.foreground=#000000
the foreground color of the main chat window and all chat rooms, specified in the notation #RRGGBB, where RR is the red hexadecimal value, GG is the green hexadecimal value, and BB is the blue hexadecimal value. The foreground color defines the color of the text and window borders.
color.foreground.button=#000000
The color of the text on buttons.
color.foreground.list=#000000
The text color of any lists such as the list of users and list of rooms.
color.foreground.text=#000000
The actual text color of any non-editable text field.
color.foreground.text.editable=#000000
the standard text color in all editable fields.
color.foreground.text.editable.inactive=#FF0000
When someone is sending in messages faster than the configured rate, the text color changes to this color.
color.foreground.text.link=#0000FF
The color of any link text in the status areas below the chat window.
font.default=SansSerif-13
the default font for all user interface text. The font specification is in the format "name[-style][-size]". For the best cross platform support, the name should be specified as Serif, SansSerif, Monospaced, Dialog, and DialogInput. The style is one of italic, bold, or bolditalic, and should be omitted for a plain style. The size is the font point size. For example, you could specify the font "Helvetica-bold-13".

Option defaults

alert.entrance.default=false
defines the initial state of the entrance alerts option of the VolanoChat applets. A value of true makes the entrance alerts enabled by default. A value of false makes the entrance alerts initially disabled. The setting of the entrance alerts can be modified by the user regardless of the initial setting, unless this item is omitted from the options menu.
accept.private.default=true
defines the initial state of the option to accept incoming private chats. A value of true allows incoming private chats by default, while a value of false prevents incoming private chats. This setting can be modified by the user regardless of the initial setting, unless this item is omitted from the options menu.
alert.audio.default=false
defines the initial state of the audio alerts option of the VolanoChat applets. A value of true makes the audio alerts enabled by default, playing a sound any time a new user enters the room or another user rings them. A value of false makes the audio alerts initially disabled. The setting of the audio alerts can be modified by the user regardless of the initial setting, unless this item is omitted from the options menu.
alert.count.default=false
defines the initial state of the room count alerts option of the VolanoChat applets. A value of true makes the count alerts enabled by default, displaying a count of the total number of people in a room each time the count changes. A value of false makes the count alerts initially disabled. The setting of the room count alerts can be modified by the user regardless of the initial setting, unless this item is omitted from the options menu.
webtouring.default=false
defines the initial state of the Web touring option of the VolanoChat applets. A value of true makes the Web touring option enabled by default, opening a Web page when its URL is displayed in a chat message. A value of false makes the Web touring option initially disabled. The setting of the Web touring option can be modified by the user regardless of the initial setting, unless this item is omitted from the options menu.

Link Preferences in Status Area

These properties specify preferences for displaying profile and referrer links in the status area of the applets.

link.prefix=http:// ftp:// news: mailto:
defines the list of prefixes used to detect and link text in the status area when displaying profile text and referrer links. The property can be used to restrict links to certain Web locations, as in this example restricting links to Volano's Web sites:
link.prefix=http://www.volano.com/ http://www.volano.net/
link.profile.disable=false
setting this to a value of true disables the automatic linking of URLs in the profile field.
link.profile.url=%0
allows the substitution of a different link for any links found in the profile text. The default value of %0 treats links normally. Any other value will cause the browser to be redirected to that link instead. This can also be used in scripts like this:
http://www.volano.com/incoming.cgi?%0
which sends the original link in the profile to the incoming.cgi script. Setting this property to nothing causes URLs to look like links but do nothing.
link.referrer.disable=false
disables the link in the profile area to the referring web page of a dynamic room.
link.referrer.url=%0
allows the substitution of a different link for the link from the referring webpage of a dynamic chat room. The default value of %0 treats links normally. Any other value will cause the browser to be redirected to that link instead. This can also be used in scripts like this:
http://www.volano.com/incoming.cgi?%0
which sends the original link in the profile to the incoming.cgi script. Setting this property to nothing causes URLs to look like links but do nothing.

Buttons and logos

The images defined for the buttons and logos of the applet may be in GIF or JPEG format. Make sure you set the size properties to match the actual image sizes or they may appear distorted. The properties look for images in your vcclient directory, by default.

image.button.border=true
indicates whether to create a shaded, interactive, 3-dimensional border around the image that appears on the applet's Web page.
image.button1=button1.gif
the image that appears on the applet's Web page to allow entry into the chat rooms.
image.button2=button2.gif
the image that appears when you move your mouse cursor over the button.
image.button.width=88
the width in pixels of the button image.
image.button.height=31
the height in pixels of the button image.
image.logo=logo.gif
the image that appears on the left of the main chat window. This image only appears if you set logo.code=. Otherwise the default banner player or your own Java applet will appear in this space instead.
image.logo.width=100
the width in pixels of the logo image.
image.logo.height=200
the height in pixels of the logo image.
image.logo.background=#FFFFFF
the background color of the logo image specified in the notation #RRGGBB, where RR is the red hexadecimal value, GG is the green hexadecimal value, and BB is the blue hexadecimal value. The background color appears if the logo image has any transparency or when the main chat window is resized to expose a logo area larger than the image.

String limits

These properties specify the maximum number of characters for each user input string, to prevent any one user from flooding the server. The values must be the same as the values of these properties for the VolanoChat server, since the server will disconnect any user sending character strings longer than it expects.

length.chattext=200
the maximum length in characters of any chat message.
length.profile=200
the maximum length in characters of any profile string.
length.roomname=100
the maximum length in characters of any room name.
length.username=20
the maximum length in characters of any nickname or member name.

Flood Control

A more detailed explanation of flood control can be found on the [8.2] Flood Control Feature page. The following values are in milliseconds, and define the amount of time before the client can send in another request to the server.

delay.keystroke=0
Defines a delay between each keystroke when inputting text. This flood control occurs only on the client side.
delay.access=0
This is the first request sent in by the VolanoChat clients, in order to establish communication.
delay.authenticate=0
A delay after client-server authentication occurs, assuming authentication has been enabled.
delay.beep=1000
Defines the delay after using the "ring" function.
delay.chat=1000
Defines a delay after a chat message is sent to the server.
delay.enter.private=1000
A delay after sending a request to enter private chat, regardless of the success or failure of the request (due to private chat being disabled).
delay.enter.room=1000
A delay after the chatter enters a room.
delay.exit.private=0
A delay after leaving a private chat.
delay.exit.room=0
A delay after leaving a chat room.
delay.kick=0
Defines a delay after a monitor or administrator uses the kick function.
delay.ping=0
Ping is an internal request that the server sends to the client to detect dead sessions. The ping is initiated by the server, so the delay would apply only to the ping response sent from the client. Use of this delay is not recommended.
delay.room.list=0
A delay after the room list is presented or refreshed.
delay.user.list=0
Defines a delay after requesting the user list, such as when clicking on a room name in the main chat window. In most cases this is not recommended. It might be useful on an older server that can't handle the speed of requests.
unconfirmed.chat=0
When there are a certain number of outstanding unconfirmed chat messages, the text color changes and the applet does not accept the Enter key until the number of unconfirmed chat messages reaches the limit again. The limit is defined by this property, with a default of allowing no outstanding unconfirmed messages.

Web pages

These properties define the location of the Web pages displayed when the applet encounters errors accessing the server or when the user requests help. You can modify these Web pages or translate them into another language.

page.newwindow=false
indicates how to open Web pages when the applet is closing. A value of true causes the applet to open a new browser window when displaying Web pages defined by the page.access.* and page.exit properties. When false, the applet displays these pages by replacing its own page.
page.use.document.base=false
indicates where to load relative Web page addresses. A value of true causes the applet to load its Web pages relative to the location of the Web page. A value of false causes the applet to load its Web pages relative to its own code base directory.
page.access.document=document.html
the page shown when the Web page is denied access.
page.access.host=host.html
the page shown when the host from which the user is connecting is denied access.
page.access.password=password.html
the page shown when an incorrect password is entered.
page.access.unable=unable.html
the page shown when the applet is unable to connect to the server.
page.access.version=version.html
the page shown when the applet is at a version incompatible with the version of the VolanoChat server.
page.access.duplicate=duplicate.html
the page shown when when someone tries to connect with a host IP address that is already connected to the server. This page is only shown if duplicate.addresses=false
page.java.version=java.html
The page shown if client authentication is enabled and the user's Java Virtual Machine is too old to support this feature. The client authentication requires the Microsoft virtual machine version 1.1 or later (in Internet Explorer 4.01 or later), the Apple Java virtual machine version 1.1.8 or later, or the Sun Java 2 Plug-in version 1.3 or later.
page.help=help.html
the page shown when the user selects the Help Topics menu item of the Help menu. This page is always shown in a new window.
page.about=about.html
the page shown when the user selects the About VolanoChat menu item of the Help menu. This page is always shown in a new window.
page.exit=
the page shown when the VolanoChat or MyVolanoChat applet is closed. By default, no page is displayed when the applets are closed.
page.exit.error=
the page shown when the VolanoChat or MyVolanoChat applet is closed after being disconnected from the VolanoChat server. By default, no page is displayed when the applets are closed after being disconnected.

Sounds

Each sound property gives the location of its sound file. Sound is disabled if no sound URL is defined. Sound files must be encoded in the Next/Sun 8000 Hz mono 8-bit µ-law format (usually with the file extension ".au").

sound.start=
is played when the visitor connects to the chat server by pressing the VolanoChat applet button on the Web page.
sound.stop=
is played when the visitor disconnects from the chat server by closing the VolanoChat applet main chat window.
sound.enter=
is played when the visitor enters a chat room.
sound.exit=
is played when the visitor leaves a chat room.
sound.rooms=
is played when the visitor refreshes the list of public chat rooms.
sound.users=
is played when the visitor selects a room name to display the list of users in the chat room.
sound.profile=
is played when the visitor selects a user name to view the profile.
sound.alert=drip.au
is played when an audio alert is received and audio alerts are enabled by the visitor.

Keys

The key properties specify a list of key codes to ignore when the Alt, Ctrl, Meta, or Shift keys are pressed. The Meta key is also known as the Command key on the Macintosh. You should use the Unicode escape sequences with the key codes in hexadecimal. To specify more than one key code, simply list additional Unicode escape sequences on the same line with no spaces.

key.ignore.alt=
the key codes to ignore when the Alt key is pressed.
key.ignore.ctrl=\u0016
the key codes to ignore when the Ctrl key is pressed. The default value is to ignore Ctrl-V (Decimal 22, Hexadecimal 16).
key.ignore.meta=\u0076
the key codes to ignore when the Meta key (or Macintosh Command key) is pressed. The default value is to ignore Command-V (Decimal 118, Hexadecimal 76).
key.ignore.shift=\u0401
the key codes to ignore when the Shift key is pressed. The default value is to ignore Shift-Ins (Decimal 1025, Hexadecimal 401).

Characters

The character properties specify one list of characters to be replaced by their corresponding entries in another list. If one list is longer than the other, all extra characters beyond those in the shortest list are ignored. For non-printable ASCII characters, you must use their Unicode escape sequences.

char.replace.old=\u000a\u000d\u00a0
lists the Line Feed (\u000a), Carriage Return (\u000d), and Non-breaking Space (\u00a0) characters.
char.replace.new=\u0020\u0020\u0020
specifies that a Line Feed, Carriage Return, or Non-breaking Space are to be replaced by a regular space character (\u0020).

Function keys

The function keys act as macro hot keys so that predefined phrases can be automatically filled into the chat message text field. Each property below defines a template in which words in the chat text field are filled into the template as the variables %0 through %9. For example, if we define:

text.f1=Hello, %0! Welcome to my chat room.

we can simply type John and press F1 to get the chat message string:

Hello, John! Welcome to my chat room.
text.f1=
the macro template for function key F1.
text.f2=
the macro template for function key F2.
text.f3=
the macro template for function key F3.
text.f4=
the macro template for function key F4.
text.f5=
the macro template for function key F5.
text.f6=
the macro template for function key F6.
text.f7=
the macro template for function key F7.
text.f8=
the macro template for function key F8.
text.f9=
the macro template for function key F9.
text.f10=
the macro template for function key F10. Note that F10 is often reserved by Windows and UNIX systems for windowing functions, such as accessing the menu bar.
text.f11=
the macro template for function key F11.
text.f12=
the macro template for function key F12.

Web page text

These text strings appear on the Web page containing the applet or in the Web browser status area.

text.button.status=Start VolanoChat
the message displayed in the Web browser status area when the mouse is positioned over the VolanoChat applet button.
text.button.message=Click button to start.
the message displayed below the applet button after the applet is loaded.
text.button.connecting=Contacting host %0...
the message displayed below the applet button when the button is clicked. %0 is the host name of the VolanoChat server, and %1 (not used by default) is the port number.
text.button.accessing=Host contacted, requesting access...
the message displayed below the applet button after establishing a connection but before being granted access.
text.button.authenticating=Access granted, authenticating client...
The message displayed below the applet button while the client is authenticating, if client authentication is enabled on the server.
text.button.notconnected=Unable to connect to host %0 on port %1.
the message displayed below the applet button if the applet is unable to connect with the server. %0 is the host name of the VolanoChat server, and %1 is the port number.
text.button.admin=Administrator password:
the label for the administrator password text field when the applet parameter admin is true.
text.button.monitor=Monitor password:
the label for the monitor password text field when the applet parameter monitor is true.

Membership text

These text strings appear on the Web page or chat windows and pertain to members and member profiles.

text.member.name=Member name:
the label for the member name text field when the applet parameter member is true.
text.member.password=Member password:
the label for the member password text field when the applet parameter member is true.
text.member.profile=[Member Profile]
the string displayed in front of a member's profile and linked to the member document URL (defined by the member.document property) when the applet parameter member is true.

Main window text

These text strings appear on the main chat window.

text.main.title=VolanoChat Applet
the window title of the main chat window.
text.main.logo=
the text above the logo on the main chat window.
text.main.rooms=Rooms:
the text displayed above the list of rooms on the main chat window before the list has been obtained from the server.
text.main.norooms=Rooms:
the text above the list of rooms when there are no rooms in the list.
text.main.oneroom=1 room:
the text above the list of rooms when there is only one room in the list.
text.main.manyrooms=%0 rooms:
the text above the list of rooms when there is more than one room in the list, where %0 is the number of rooms in the list.
text.main.users=People:
the text displayed above the list of users on the main chat window before the list has been obtained from the server.
text.main.nousers=People:
the text above the list of users when the selected room is empty.
text.main.oneuser=1 person:
the text above the list of users when the selected room contains only one user.
text.main.manyusers=%0 persons:
the text above the list of users when the selected room contains more than one user, where %0 is the number of users in the room.
text.main.onstage=On stage:
the text above the list of users when the selected room is an event auditorium.
text.main.filter=Room filter:
the text above the box to filter the list of rooms based on a search term.
text.main.username=Your name:
the label for the user nickname text field on the main chat window.
text.main.profile=Your profile:
the label for the user profile text field on the main chat window.
text.main.broadcast=Broadcast:
the label for the message broadcast text field on the main chat window. This label and its field appear only when the applet's admin parameter is set to true.
text.main.getrooms=Get Rooms
the text on the button for updating the list of rooms.
text.main.enter=Enter Room
the text on the button for entering a room.
text.main.connect=Connect
the label for the connect button (not currently used).
text.main.disconnect=Disconnect
the label for the disconnect button (not currently used).

Chat room window text

These text strings appear in the chat rooms.

text.chat.status=Select a name for the profile. Double click a name for private chat.
the text displayed in the chat room status area when a user first enters a chat room.
text.chat.event.status=Type your question and press Enter to send it.
the text displayed in the chat room status area when an audience member enters an event auditorium.
text.chat.event.sent=Your question has been submitted to the moderator.
the text displayed in the chat room status area when an audience member submits a question to the moderator.

Menu text

These text strings appear in the applet window menus. To remove a menu or menu item, simply remove the associated text string defined for it.

text.menu.places=Places
the text for the main menu of the main chat window.
text.menu.getrooms=Get Rooms
the menu item text for updating the list of rooms.
text.menu.enter=Enter Room
the menu item text for entering a chat room.
text.menu.exit=Exit
the menu item text for closing the VolanoChat applet and disconnecting from the chat server.
text.menu.options=Options
the text for the options menu of the main chat window and the chat room windows.
text.menu.font.name=Font Name
the menu item text for select a font name.
text.menu.font.style=Font Style
the menu item text for selecting a font style.
text.menu.font.regular=Regular
the checkbox menu item text for selecting a regular font style.
text.menu.font.italic=Italic
the checkbox menu item text for selecting an italic font style.
text.menu.font.bold=Bold
the checkbox menu item text for selecting a bold font style.
text.menu.font.bolditalic=Bold Italic
the checkbox menu item text for selecting a bold and italic font style.
text.menu.font.increase=Increase Font
the menu item text for increasing the font size.
text.menu.font.decrease=Decrease Font
the menu item text for decreasing the font size.
text.menu.accept.private=Accept Private Chats
the checkbox menu item for allowing incoming private chat sessions
text.menu.alert.entrance=Entrance Alerts
the checkbox menu item for enabling entrance alerts.
text.menu.alert.audio=Audio Alerts
the checkbox menu item for enabling audio alerts.
text.menu.alert.count=Show Count Changes
the checkbox menu item for enabling room count alerts.
text.menu.webtouring=Web Touring
the checkbox menu item for enabling Web touring.
text.menu.help=Help
the text for the help menu of the main chat window and the chat room windows.
text.menu.topics=Help Contents
the menu item text for displaying the help contents Web page.
text.menu.about=About VolanoChat
the menu item text for displaying information about the VolanoChat applet.
text.menu.room=Room
the text for the main menu of the chat room windows.
text.menu.close=Close
the menu item text for closing the chat room window and leaving the room.
text.menu.people=People
the text for the people menu item of the chat room windows.
text.menu.people.ring=Ring %0
the menu item text for sending an audio alert to a user, where %0 is the name of the selected user.
text.menu.people.ignore=Ignore %0
the menu item text for ignoring a user, where %0 is the name of the selected user.
text.menu.people.unignore=Unignore %0
the menu item text for unignoring a user, where %0 is the name of the selected user.
text.menu.people.count=Count
the menu item text for displaying a count of the number of people in the chat room.
text.menu.monitor=Monitor
The title for the monitor menu. This menu is only displayed to monitors and administrators.
text.menu.monitor.remove=
the menu item text for removing a user from the chat room. This menu item is available only to monitors and administrators. In the monitor.txt file this property is defined as text.menu.monitor=Remove %0,where %0 is the name of the selected user.
text.menu.monitor.kick=
the menu item text for kicking a user off the chat server. This menu item is available only to monitors and administrators. In the monitor.txt file this property is defined as text.menu.monitor=Kick %0,where %0 is the name of the selected user.
text.menu.monitor.ban=
the menu item text for Banning a user from the chat server. This menu item is available only to monitors and administrators. In the monitor.txt file this property is defined as text.menu.monitor=Ban %0,where %0 is the name of the selected user.

Menu links

These text strings appear in the applet window menus when defined.

text.menu.links.title=Links
the text for the menu of administrator-defined Web links.
text.menu.links.names=Java - Get It Now!
the list of names for each of the Web links, separated by the "|" vertical bar character. The order of the names must be the same as their corresponding addresses.
text.menu.links.locations=http://www.java.com/
the Web addresses (URLs) for each of the Web links, separated by the "|" vertical bar character. The order of the addresses must be the same as their corresponding names.

Themes

This section defines the themes menu and the actual construction of various themes. For more information see the [8.5] Themes Feature page.

text.menu.themes.title=Themes
defines the menu name for your Themes menu.
text.menu.themes.names=Plum | Desert | Marine | Pumpkin | Lime | - | High Contrast Black | High Contrast Black (large) | High Contrast White | High Contrast White (large)
The ordered list of theme names.
text.menu.themes.default=Standard
defines the name of the menu item to reset the theme to the default colors and fonts defined by color.background.*, color.foreground.*, and font.default above.

# Plum
theme.1.color.background=#CC99CC
theme.1.color.background.button=#EEEEEE
theme.1.color.background.list=#FFCCFF
theme.1.color.background.text=#FFCCFF
theme.1.color.foreground.text.editable.inactive=#996699
theme.1.color.foreground.text.link=#330033

# Desert
theme.2.color.background=#CCCC99
theme.2.color.background.button=#FFFFCC
theme.2.color.background.list=#EDEDCA
theme.2.color.background.text=#EDEDCA
theme.2.color.foreground.text.editable.inactive=#999966
theme.2.color.foreground.text.link=#333300

# Marine
theme.3.color.background=#6699CC
theme.3.color.background.button=#EEEEEE
theme.3.color.background.list=#B6CBEB
theme.3.color.background.text=#B6CBEB
theme.3.color.foreground.text.editable.inactive=#336699
theme.3.color.foreground.text.link=#000033

# Pumpkin
theme.4.color.background=#FF9966
theme.4.color.background.button=#FFFFCC
theme.4.color.background.list=#FFCC99
theme.4.color.background.text=#FFCC99
theme.4.color.foreground.text.editable.inactive=#CC6633
theme.4.color.foreground.text.link=#660000

# Lime
theme.5.color.background=#83D8A4
theme.5.color.background.button=#C8ECD4
theme.5.color.background.list=#C8ECD4
theme.5.color.background.text=#C8ECD4
theme.5.color.foreground.text.editable.inactive=#53A874
theme.5.color.foreground.text.link=#004814

# Skip theme.6 for separator "-".

# High Contrast Black
theme.7.color.background=#000000
theme.7.color.background.button=#000000
theme.7.color.background.list=#000000
theme.7.color.background.text=#000000
theme.7.color.background.text.editable=#000000
theme.7.color.foreground=#FFFFFF
theme.7.color.foreground.button=#FFFFFF
theme.7.color.foreground.list=#FFFFFF
theme.7.color.foreground.text=#FFFFFF
theme.7.color.foreground.text.editable=#FFFFFF
theme.7.color.foreground.text.editable.inactive=#808080
theme.7.color.foreground.text.link=#8080FF

# High Contrast Black (large)
theme.8.color.background=#000000
theme.8.color.background.button=#000000
theme.8.color.background.list=#000000
theme.8.color.background.text=#000000
theme.8.color.background.text.editable=#000000
theme.8.color.foreground=#FFFFFF
theme.8.color.foreground.button=#FFFFFF
theme.8.color.foreground.list=#FFFFFF
theme.8.color.foreground.text=#FFFFFF
theme.8.color.foreground.text.editable=#FFFFFF
theme.8.color.foreground.text.editable.inactive=#808080
theme.8.color.foreground.text.link=#8080FF
theme.8.font.default=SansSerif-18

# High Contrast White
theme.9.color.background=#FFFFFF
theme.9.color.background.button=#FFFFFF
theme.9.color.background.list=#FFFFFF
theme.9.color.background.text=#FFFFFF
theme.9.color.foreground.text.editable.inactive=#808080

# High Contrast White (large)
theme.10.color.background=#FFFFFF
theme.10.color.background.button=#FFFFFF
theme.10.color.background.list=#FFFFFF
theme.10.color.background.text=#FFFFFF
theme.10.color.foreground.text.editable.inactive=#808080
theme.10.font.default=SansSerif-18

The actual theme components. These are the themes defined in the english.txt file shipped with VolanoChat. If no themes are defined, the applet simply displays the 'standard' choice on the menu. See the [8.5] Themes Feature page for more information.

Monitor Menu

The following items are displayed on the monitor pop-up menu.

recent.user.limit=50
defines the number of chatters to include on the recent user limit menu of the monitor interface. More information on the special monitor options can be found in section [7.1.5] Monitor Interface.
text.monitor.title.remove=Remove From Room
The text displayed on the title bar of the pop-up menu when a monitor selects the 'remove' option.
text.monitor.title.kick=Kick From Server
The text displayed on the title bar of the pop-up menu when a monitor selects the 'kick' option.
text.monitor.title.ban=Ban From Server
The text displayed on the title bar of the pop-up menu when a monitor selects the 'ban' option.
text.monitor.label.remove=Select the name to remove:
The text displayed above the list of names on the 'remove' pop-up window.
text.monitor.label.kick=Select the address to disconnect:
The text displayed above the list of names on the 'kick' pop-up window.
text.monitor.label.ban=Select the address to ban:
The text displayed above the list of names on the 'ban' pop-up window.
text.monitor.okay=OK
The text displayed on the OK button in any of the monitor function pop-up windows.
text.monitor.cancel=Cancel
The text displayed on the Cancel button in any of the monitor function pop-up windows.

Keyboard focus messages

These text strings appear in the main chat window status area when the keyboard focus is changed by tabbing through the components of the window.

text.status.focus.rooms=List of rooms.
the status message when a visitor tabs to the list of rooms.
text.status.focus.users=List of people in room.
the status message when a visitor tabs to the list of users in a room.
text.status.focus.filter=Filter for list of room names.
the status message when a visitor tabs to the room filter field.
text.status.focus.username=Your name or nickname.
the status message when the visitor tabs to user name text field.
text.status.focus.profile=Optional personal information such as a Web or e-mail address.
the status message when the visitor tabs to the user profile text field.
text.status.focus.getrooms=Get list of room names matching filter.
the status message when the visitor tabs to the get rooms button.
text.status.focus.enter=Enter a room.
the status message when the visitor tabs to the enter room button.
text.status.focus.membername=Your member name.
the status message when a visitor tabs to the member name text field.
text.status.focus.memberpassword=Your member password.
the status message when a visitor tabs to the member password text field.

Status messages

These text strings appear as messages in the main chat window status area or on the Web page of the applet.

text.status.selectroom=Select a room to enter.
the message when a visitor attempts to enter a room without having selected a room to enter.
text.status.entername=Enter a name to join %0.
the default message displayed when a name has not been entered on the main chat window.
text.status.enterpassword=Enter your password.
the message when a monitor or administrator attempts to connect to the server without having entered the password.
text.status.entermembername=Enter your member name.
the message when a member attempts to connect to the server without having entered the member name.
text.status.entermemberpassword=Enter your member password.
the message when a member attempts to connect to the server without having entered the member password.
text.status.enterprofile=Enter an optional profile.
the message displayed when the applet prompts for the optional profile text.
text.status.enter=Press Enter Room to enter %0.
the default message displayed when a name has been entered on the main chat window.
text.status.enteringroom=Entering %0...
the message after requesting to enter a room, where %0 is the name of the selected room.
text.status.enteringprivate=Starting private chat with %0...
the message after requesting a private chat session, where %0 is the name of the person with whom the private chat session is requested.
text.status.gettingrooms=Getting list of rooms...
the message when a visitor requests an update to the list of rooms.
text.status.gettingusers=Getting list of people in room...
the message when a visitor selects a room name to obtain the list of people in the room.
text.status.gettingprofile=Getting %0's profile...
the message when a visitor selects a person's name to request the profile.
text.status.nosuchroom=Room no longer exists. Press Get Rooms.
the message when a visitor selects a room name or attempts to enter a room that no longer exists in the server.
text.status.nosuchuser=User is no longer in room.
the message when a visitor performs an action with another visitor who is no longer present in the chat room.
text.status.nametaken=The name %0 is already taken in %1.
the message when a visitor attempts to enter a chat room with a name that is already taken, where %0 is the requested name and %1 is the chat room name.
text.status.membertaken=The name %0 belongs to a member. Please choose another name.
the message when a visitor attempts to enter a room with a name reserved by a member, where %0 is the reserved member name.
text.status.alreadyinroom=Already in %0.
the message when a visitor attempts to enter a room for a second time, where %0 is the chat room name.
text.status.roomfull=%0 is full. Select another room or try again later.
the message when a visitor attempts to enter a chat room that is full, where %0 is the chat room name.
text.status.roomcount=Room count = %0.
the message that displays the count of people in a room.
text.status.publiclimit=You are limited to %0 chat rooms.
the message when a visitor reaches the limit on the number of rooms that can be entered at the same time, where %0 is the limit on the number of concurrent chat rooms per visitor.
text.status.privatelimit=You are limited to %0 private chat sessions.
the message when a user reaches the limit on the number of private chat sessions that can be active at the same time, where %0 is the limit on the number of concurrent private chat sessions per visitor.
text.status.noprofile=%1 %0 has no profile.
the message when a visitor has given no profile, where %0 is the visitor's name and %1 is the visitor's Internet Protocol (IP) address. The IP address will only display to monitors and administrators.
text.status.profile=%1 %0: %2
the message that displays a visitor's profile, where %0 is the visitor's name, %2 is the profile string specified by the visitor, and %1 is the visitor's Internet Protocol (IP) address. The IP address will only display to monitors and administrators.
text.status.closing=Closing VolanoChat...
the message when a visitor closes the VolanoChat applet and disconnects from the server.

System messages

These text strings appear in the chat room text area as system messages. In each message, the date can be removed or replaced with a different prefix string. You may want to add a special prefix to these messages, such as the string "***", so that they can be distinguished from the normal chat messages in the chat rooms.

text.system.entrance=[%0] %2 %1: %3
If entrance alerts are enabled, this text appears when a new visitor enters the room. %0 is the date, %1 is the new visitor's name, %2 is the visitor's IP address, if available, and %3 is the visitor's profile text.
text.system.audio=[%0] Audio alert from %1.
If audio alerts are enabled, this text appears when receiving an audio alert. %0 is the date and %1 is sender's name.
text.system.broadcast=[%0] %1
This string formats an administrator broadcast message, where %0 is the date and %1 is the broadcast message text.
text.system.partnerleft=[%0] %1 left private chat.
the message when your private chat partner leaves the private chat session, where %0 is the date and %1 is the name of the private chat partner.
text.system.disconnected=[%0] Disconnected. Close VolanoChat and restart.
the message when disconnected from the chat server, where %0 is the date.

Previous Next Up FAQ XHTML 1.0 Table of Contents

2014-07-11 — An updated version of the VOLANO chat server that supports the latest Java 8 Plug-in is now available. More…

The VOLANO® chat software for the Java™ platform lets you build on-line communities and add real-time social networking to your Web site. More…

John Neffenger <john@status6.com>
More…

A PROJECT OF STATUS:6®