modules/chat_gabbly/README.txt

Module: Chat Gabbly
Author: Mike Carter <www.ixis.co.uk/contact>


Description
===========
Adds an AJAX powered chat room to your site using the gabbly.com service and
provides unlimited chat rooms.

This module also supresses the advertising placed in the chat room a user
enters.


Requirements
============
Users of the chat room will require a JavaScript capable web browser. There is
no fall back if JavaScript is not available.


Installation
============
Copy the 'chat_gabbly' module directory in to your Drupal
modules directory as usual.

Chat permissions need to be allocated to user roles as required.


Configuration
=============

Admin settings are minimal for Chat Gabbly. By default your chat rooms will be published on
Gabbly.com when users enter them. To prevent this ensure you set the privacy
option is checked.

A menu item is made available in the menu navigation block, you can disable it or
move it in to another menu block such as the Primary Links if desired, or just
disable it. Use the standard menu admin interface to do this.

A block is also made available (you just need to add it to a region in your theme)
that allows you to specify a list of chat rooms to host.


Usage
=====
A default chat room is available to go right out of the box. Navigate
to ?q=chat to experience Gabbly.

You don't need to use the block to add additional rooms, just create a new room
topic by adding it to the end of the path. For example:-

?q=chat/Drupal+Rocks
?q=chat/Chatterbox

The toolbar buttons in the chat window are as follows:
footprints - stop messages when people enter and leave the chat room
bell - turn sounds on and off.

If you allow anonymous users to participate in your chat room, then an optional
box will be available on the chat toolbar so that they can give them selves a
more descriptive username.  If the user is logged in they will be only allowed
to use their Drupal account name.
1	Module: Chat Gabbly
2	Author: Mike Carter <www.ixis.co.uk/contact>
3
4
5	Description
6	===========
7	Adds an AJAX powered chat room to your site using the gabbly.com service and
8	provides unlimited chat rooms.
9
10	This module also supresses the advertising placed in the chat room a user
11	enters.
12
13
14	Requirements
15	============
16	Users of the chat room will require a JavaScript capable web browser. There is
17	no fall back if JavaScript is not available.
18
19
20	Installation
21	============
22	Copy the 'chat_gabbly' module directory in to your Drupal
23	modules directory as usual.
24
25	Chat permissions need to be allocated to user roles as required.
26
27
28	Configuration
29	=============
30
31	Admin settings are minimal for Chat Gabbly. By default your chat rooms will be published on
32	Gabbly.com when users enter them. To prevent this ensure you set the privacy
33	option is checked.
34
35	A menu item is made available in the menu navigation block, you can disable it or
36	move it in to another menu block such as the Primary Links if desired, or just
37	disable it. Use the standard menu admin interface to do this.
38
39	A block is also made available (you just need to add it to a region in your theme)
40	that allows you to specify a list of chat rooms to host.
41
42
43	Usage
44	=====
45	A default chat room is available to go right out of the box. Navigate
46	to ?q=chat to experience Gabbly.
47
48	You don't need to use the block to add additional rooms, just create a new room
49	topic by adding it to the end of the path. For example:-
50
51	?q=chat/Drupal+Rocks
52	?q=chat/Chatterbox
53
54	The toolbar buttons in the chat window are as follows:
55	footprints - stop messages when people enter and leave the chat room
56	bell - turn sounds on and off.
57
58	If you allow anonymous users to participate in your chat room, then an optional
59	box will be available on the chat toolbar so that they can give them selves a
60	more descriptive username. If the user is logged in they will be only allowed
61	to use their Drupal account name.