/ 
DJabberd-Plugin-StatusHistory-1.0
/ DJabberd::Plugin::StatusHistory

NAME

DJabberd::Plugin::StatusHistory - records changes in status for posterity and/or display to interested parties

SYNOPSIS

# in your djabberd configuration
<Plugin DJabberd::Plugin::StatusHistory>
   Dsn dbi:mysql:dbname=statushistory
   Dbuser djabberd
   Dbpass password
   Dbhost localhost
   Dbport 8601
</Plugin>

DESCRIPTION

StatusHistory allows your DJabberd server to save a history of its users' IM status, similar to a certain popular web site.

Note that unlike similar products that may record messages explicitly IMed into the system, this plugin records messagers' actual statuses and status messages. This may be more or less useful than recording explicit messages.

CONFIGURATION

Setting up your database

Use the included schema definitions to create the tables prior to enabling StatusHistory in your DJabberd server.

Configuring DJabberd

Use your DJabberd configuration to set the database settings for StatusHistory. The available config settings are:

  • Dsn dsn

    The DBI data source name for your database.

  • Dbuser username

    The username for logging into your database. Dbuser is not necessary when using SQLite.

  • Dbpass password

    The password for logging into your database. Dbpass is not necessary when using SQLite.

  • Dbhost hostname

    The host server that serves your database. Dbhost is not necessary when using SQLite.

  • Dbport port

    The port for connecting to your database. Dbport is not necessary when using SQLite.

Setting up display

You can read the status history records from your configured database by the method of your choice. See the included Perl CGI, for example.

BUGS AND LIMITATIONS

There are no known bugs in this module. Please report problems to Mark Paschal <markpasc@markpasc.org>. Patches are welcome.

SEE ALSO

DJabberd, Twitter http://www.twitter.com/

AUTHOR

Mark Paschal <markpasc@markpasc.org>

LICENSE AND COPYRIGHT

Copyright 2007 Six Apart, Ltd. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.