MESSAGE BOARD EXAMPLE

This is a working example of DBIQueryPlugin capabilities. Features,
implemented by this example are:

1. Threading.
2. Hiding old messages.
3. Minimalistic administration functionality.
4. Editing of already posted messages.
5. Multiple message boards.

Name of a particular message board is defined by full topic name. For
instance, Main.CommonDiscussion.

Prerequisites.
--------------

1. MySQL v4.1 or higher
2. DBIQueryPlugin v1.1
3. TWiki 20040904

Installation.
-------------

1. Put MessageBoard.txt into a web of your choise.
2. Create database message_board (one may choose another name) using script
in file message_board.sql.
3. Add new connection for the databse in %TWIKIROOTDIR%/lib/DBIQueryPlugin.cfg.
For instance, it may look like this one:

    %dbi_connections = (
	message_board => {
	    user => 'msgboard',
	    password => 'password',
	    driver => 'mysql',
	    database => 'message_board',
	    codepage => '<on your choice>',
	    allow_do => {
		default => [qw(TWikiAdminGroup)],
		'Main.CommonDiscussion' => [qw(TWikiAdminGroup DevelopersGroup MaintainerGroup SpecialUser)],
	    },
	    # host => 'localhost',
	},
    );

4. Assuming that MessageBoard topic is located under the Main web use

    %INCLUDE{"Main.MessageBoard"}%

in the topic you want to containt a board. I.e., using the example from
item 3 it would be Main.CommonDiscussion.

Enjoy.

Notes.
------

Users with edit permission are considered as administrators and can edit
other users' messages.
