#############################
# Chatterbox 2.0
#
# Created by Aaron Anderson
# http://sulfericacid.perlmonk.org
# Contact me at: sulfericacid@qwest.net
#############################

Overview:
-----------------
Updated version of the classic ChatterBox.  Allow users on your site to chat with one another with this very powerful tool.


New features:
-----------------
Admin GUI 
  Password protected 
  View all current messages and IP addresses of those who leave messages 
  Delete any offensive message on the fly with a single mouse click 
  Bann the IP address of people who choose to misbehave with the click of a mouse 

More percise text wrapping installed, prevents users from scrolling the page. 

Secure screen names from being used by the general public. 
  Checked by IP address giving rights to use special screen names  
  Secure names are now colored in red so they stand out. 

Re-designed keying system producing smaller log files 

Removed username bug disallowing the use of the name or message 0. 

Actions are now installed! Just type /me and whatever you want! 

If used as SSI, this will return them to ANY URL they came from.  They won't lose the page they were on.


Installation:
-----------------
1) Transfer chat.pl, delete.pl, banned.txt, chathelp.html and the /images/ folder into your CGI-BIN or the directory where all your files are
2) Chmod this folder to 777 and all files to 755 (except banned.txt which needs to be 777)
3) Configure the file (read Configuration section)


Configurations:
-----------------
chat.pl
1) Change the location of perl (first line) to the location of perl on your server
2)
my @words = ("shit", "ass", "asshole", "bitch", "bastard", "fag", "faggot", "fuck",
			"fucker", "phuck", "dick");
## Add or remove words to the swear filter.  Each word is "" and , separated.

my @list  = ("admin", "Admin", "Webmaster", "Webmaster", "administrator", "Administrator");
## Add or remove locked screen names (no one but the admin can use these).  

my $url = "http://www.mypage.com/cgi-bin/chat/chat.pl";
## Change the above line to the full URL of the chat script

my $imagedir = "http://www.mypage.com/cgi-bin/chat/images";
## Change the above line to the full URL of the /images/ folder for the chat script

my $ip = "";
## Change to the administrator IP address

my $chathelp = "chat/chathelp.html";
my $log      = "chat/log.pl";
## Change the two above lines to point to the chathelp.html and log.pl files

my $pagead   = "http://www.mypage.com";
## The above line appears as text in the bottom cell of the table.  Use this for a small text ad, I use my URL here



delete.pl
1) Change the location of perl (first line) to the location of perl on your server
2)
my @words = ("shit", "ass", "asshole", "bitch", "bastard", "fag", "faggot", "fuck",
			"fucker", "phuck", "dick");
## Add or remove swear words to the list.  These are separated by "" and ,

my $scriptname = "delete.pl";
## The name of this delete file.  This only needs changing if you rename this file

my $fullurl    = "http://sulfericacid.perlmonk.org/chat/delete.pl";
## The full URL of this delete file

my $imagedir = "http://sulfericacid.perlmonk.org/scripts/chat/images";          
## Change the above to point to the /images/ directory for the script

my $pw = "test";
## Change this to your password


How to use:
-----------------
1) Can be setup as a full page chatterbox (will require some source editing for the table sizes.  Anyone proefficient with HTML and search the source codes and edit the HTML without a problem) or be called as a mini chatterbox (like the one I use) as calling SSI.



Other information:
------------------
Only one administrator can be used at one time to chat with a red name.  In later versions, this will be made so a list of admins can be on at the same time.