ADVENTIA CHAT SERVER 3.0 PREMIUM
INSTALLATION NOTES

• SOFTWARE REQUIREMENTS
• INSTALLATION INSTRUCTIONS
• CONFIGURATION OF SETTINGS
• ADMINISTERING THE CHAT
• MODERATING THE CHAT
• FILE MANIFEST
• COMMENTS

SOFTWARE REQUIREMENTS

Before running Adventia Chat Server you need to install the following software in your computer:

• Windows 2000 or Windows NT 4.0
• Microsoft Internet Information Server 5.0/4.0 (or Microsoft Personal Web Server) with ASP
• Any browser that supports frames and cookies

INSTALLATION INSTRUCTIONS

1.Unzip chatpro30.zip into a directory with permissions for script execution (e.g. C:\Inetpub\scripts\adventia\chat\)

• Launch the Internet Service Manager (On NT 4.0 click on Start Menu/Programs/Windows NT 4.0 Option Pack/Microsoft Internet Information Server/Internet Service Manager)
  
• Navigate to the directory where the scripts reside (e.g. scripts/adventia/chat). Right-click on it and choose the Properties menu option.
  
• Click on the Directory tab.
  
• Click on the Create button (located in the Application Settings area). Once the Name textbox becomes enabled, type Adventia Chat as the new name.
  
• In the Permissions section, verify that either the Script or Execute radio buttons are selected.
  
• In the Content Control section, clear the Directory browsing allowed and the Index this directory checkboxes.
  
• Click on Apply.
  
• Click on OK.
  
• Navigate to the images directory (e.g. scripts/adventia/chat/images). Edit its properties and verify that Read permissions are enabled.
  
• Close the Internet Service Manager. Click on OK when prompted to save the console settings.
  
• For further information on ASP applications, please check the Microsoft Windows NT 4.0 Option Pack Documentation. If you do not have the Windows NT 4.0 Option Pack, you can download a copy from Microsoft's web site at http://www.microsoft.com/ntserver/.
  

CONFIGURATION OF SETTINGS

To customize the chat according to your needs, you must edit a set of parameters in settings.asp. The following parameters are customizable:

Application("LogFile"): Name of the chat users log file
e.g. Application("LogFile") = "chat_users.log"

Application("TimeLimit"): Time in minutes before idle users are removed from the chat
e.g. Application("TimeLimit")=15

Application("RefreshRate"): Rate, in seconds, at which the chat screen is automatically refreshed
e.g. Application("RefreshRate")=8

Application("administrator"): Username for the chat room administrator   
e.g. Application("administrator")="administrator"

Application("admin_password"): Password for the chat room administrator
e.g. Application("admin_password")="admin"

Application("MaxBufferLength"): Maximum length(in characters) of the conversation text displayed at any one time
e.g. Application("MaxBufferLength") = 2000

Application("rooms"): List of rooms. Separate each room name with a pipe character "|"
e.g. Application("rooms")="General|Travel|News"

Application("AllowHTMLX"): Where X is the room number. Set to True/False to allow/prevent the use of html, images, etc. in the corresponding chat room. Note that X should always start at zero.
e.g.
Application("AllowHTML0")=False
Application("AllowHTML1")=True
Application("AllowHTML2")=False

Application("AllowPrivateX"): Where X is the room number. Set to True/False to allow/prevent private conversations between users. Note that X should always start at zero.
e.g.
Application("AllowPrivate0")=True
Application("AllowPrivate1")=False
Application("AllowPrivate2")=True

Application("moderatedX"): Where X is the room number. Set to True/False to moderate/not moderate the corresponding chat room. Note that X should always start at zero.
e.g.
Application("moderated0")=False
Application("moderated1")=True
Application("moderated2")=False

Application("LogSessionX"): Where X is the room number. Set to True/False to keep/not keep a record of the session. Note that X should always start at zero.
e.g.
Application("LogSession0")=False
Application("LogSession1")=False
Application("LogSession2")=True

Application("TranscriptFileX"): Where X is the room number. Name of the chat conversation transcript file. Note that X should always start at zero.
e.g.
Application("TranscriptFile0")="chat_log0.htm"
Application("TranscriptFile1")="chat_log1.htm"
Application("TranscriptFile2")="chat_log2.htm"

 

ADMINISTERING THE CHAT

1. Open admin_frame.asp in your browser
2. Enter your administrative username and password (the defaults are admin/admin)
3. The following are the options that you have available:
   
   • Room : Displays a list of the available rooms. Use it to select the room on which you want to perform an administrative function.
     
   • Show Room Log : Displays the list of users (and other user details) who logged in during the current day. For other time periods, open chat_users.log.
     
   • Show User Activity : Displays the number of minutes elapsed since each user last talked. Also removes users that have been idle for more than the time specified in settings.asp
     
   • Show Conversation : Displays the current public conversation.
     
   • Clear Conversation : Erases all comments in the current public conversation.
     
   • Save Chat Transcript : Saves the chat room conversation to the transcript file specified in settings.asp . Note that this button overrides the value of Application("LogSessionX").
     
   • Remove [User Name] : removes the specified user from the chat room. If All is selected, all users are immediately removed. Note that they can log back in immediately.
     
   • Ban [User Name] : bans the specified user from the chat room. Note that selecting All has no effect.
     
   • Lift ban for [User Name] : lifts the ban for the specified user.
     
   • Broadcast [message] : broadcasts an administrative message to the chat room.
     

MODERATING THE CHAT

1. Open admin_frame.asp in your browser.
2. Enter your administrative username and password (the defaults are admin/admin).
3. Select the room you want to moderate. Click the "Begin Moderation" button (lower right of frame).
4. Click the "Update" button to see all conversations posted after you started moderating the chat.
5. Select a radio button to "Accept" or "Reject" each comment posted.
6. Then click the "Update" button to send accepted comments to the conversation frame (rejected messages will be discarded).
7. Use the "Update" button frequently to receive new posted messages.
8. Use the "End Moderation" button to finish the moderation session.

Note: Once you start moderating the chat, the following message will be displayed in the conversation frame:

"Moderator message: Chat is now being moderated. Your comments will be displayed only if accepted by the moderator"

 

FILE MANIFEST

GLOBAL CONFIGURATION FILES

• global.asa - File run at application startup and shutdown. It currently calls an initialization function inside of settings.asp
• settings.asp - File that contains global application parameters. Change before starting chat application.

INTERFACE-RELATED FILES

• banned.asp - File to which users are sent to after being banned from the chat room. May be customized at will.
• display_frame.asp - File that controls how public conversations are displayed. May be customized at will.
• display_frame_private.asp - File that controls how private conversations are displayed. May be customized at will.
• input_frame.asp - File that contains the form used to enter public comments. May be customized at will.
• input_frame_private.asp - File that contains the form used to enter private comments. May be customized at will.
• login.asp - Entry point for the chat room. May be customized at will.
• logoff.asp - Exit point for the chat room. May be customized at will.
• main_frame.asp - File that controls the overall layout of the public chat room. It calls input_frame.asp, display_frame.asp, and media_frame.asp . May be customized at will.
• main_frame_private.asp - File that controls the overall layout of private chat rooms. It calls input_frame_private.asp, display_frame_private.asp, and media_frame.asp . May be customized at will.
• media.asp - File that controls which images should be displayed inside of media_frame.asp . May be customized at will.
• media_frame.asp - Contains the images used to animate conversations. May be customized at will.

ADMINISTRATION-RELATED FILES

• admin.asp - Chat administrator's control panel. May be customized at will.
• admin_frame.asp - Container page that calls admin.asp . May be customized at will.

FILES WITH SYSTEM FUNCTIONS (DO NOT CHANGE)

• blnShowModerationPanel.asp
• blnRemoveSingleUser.asp
• blnWriteStringToLog.asp
• setFocus.js
• strAnimate.asp

SOFTWARE LICENSE

• license.txt

IMAGE DIRECTORY

• <DIR> images - Contains all the images displayed in media_frame.asp

COMMENTS

For questions or technical support contact us or use the Tech Support Form at www.adventia.com/support.htm.

Thanks for choosing Adventia Chat Server Pro 3.0!