Chatr is a chatroom on your site. It's a set of php scripts and some javascript to create an AJAX/php chatroom with php as the only server requirement. Installation aims to be simple, limited to dropping the scripts in a folder on your server, setting the location in config.php and testing it out.

Installation

1. Upload the contents of the zipfile to your server in its own folder.

2. Edit the config.php file's $path_to_chat variable to show the fully-qualified path to your chat folder(eg. http://www.yourdomain.com/chatr/). Be sure to include the trailing slash.

3. Go to your chatr url and test it out.

Notes

This chat is designed to be simple above all else and not to hammer your web server too hard. Therefore don't expect it to be irc or AIM or something more than what it is. Since the source is available it's pretty simple to impersonate someone or otherwise mess with the chat. I've tried to put a couple of things in the config that could help you secure it. For instance changing $admin to something secret and changing the pings, users, and bufffer files to some other name.

Changelog

Version 0.3 - 12/23/2005

• spaces no longer allowed in usernames
• fixed quick visit users staying in the room forever
• flatfiles are created and used without error after their deleted
• admin folder removed

Version 0.2 - 12/22/2005

• Introduction

One user had a bug in their installation after editing the chat.php file. Their edited version had multiple paragraph tags with the same id(i.e. stats, charcount). This is known to cause Internet Explorer users to time out 90 seconds after joining at least with IE versions 6.00.2800 and 6.00.2600.

Feel free to develop and expand upon it. I'd love to hear what you do with it.

david@sterryit.com