To configure the plugin:

1. Firstly, you must have your address books stored in a database, one
which PEAR DB can connect to. You must configure the db DSN in the
config.php (in config folder).

$addrbook_dsn = 'connection string';

As to how to configure the DSN (from PEAR DB Manual):

* phptype: Database backend used in PHP (mysql, odbc etc.)
* dbsyntax: Database used with regards to SQL syntax etc.
* protocol: Communication protocol to use (tcp, unix etc.)
* hostspec: Host specification (hostname[:port])
* database: Database to use on the DBMS server
* username: User name for login
* password: Password for login
*
* The format of the supplied DSN is in its fullest form:
*
* phptype(dbsyntax)://username:password@protocol+hostspec/database
*

The Databases currently supported (the phptype DSN part) are:

mysql -> MySQL
pgsql -> PostgreSQL
ibase -> InterBase
msql -> Mini SQL
mssql -> Microsoft SQL Server
oci8 -> Oracle 7/8/8i
odbc -> ODBC (Open Database Connectivity)
sybase -> SyBase
ifx -> Informix
fbsql -> FrontBase

2. To set up an address book for your users, refer to the following
documetnation. You need to have a table like "address"
http://www.squirrelmail.org/wiki/AddressbookDatabase

3. To store the addressgroups, create the following table:

create table addressgroups(
owner varchar(50),
nickname varchar(50),
addressgroup varchar(50),
type varchar(50)
);

The lengths and datatype of the fields are suggested. Modify them to suit
your needs, especially if you use a different database. You could give the
table another name, just remember to change the table name wherever you see:

$myparams = array();
$myparams['dsn'] = $addrbook_dsn;
// change this table name if you named it differently
$myparams['table'] = 'addressgroups';

Thats all folks :)

This plugin version fixes some typos and session handling issues. It also adds three new string translations. Thanks to Phil Driscoll and Florian Daeumling.

Changes:

• Fixed invalid test in agroup_check_backends() function. Added option to disable use of sqsession_register() in compose (#1599880).
• Added 'To', 'Cc' and 'Bcc' string translations.
• Reduced gettext domain switching.
• Fixed error handling in empty groups.
• Escaped quotes and slashes in email addresses (#1642857).

Older versions