CURRENT VERSION:

v0.39

CREATED:

Kelvin Ho. v0.1 2002-07-01.
Licensed under the GNU GPL. For full terms see the file COPYING.

UPDATES:

2003-05-30 Modified by Jon Nelson (quincy@linuxnotes.net) to be 
           compatiable with SquirrelMail 1.4.
         
           Created this README.

2003-06-25 Jon Nelson takes over as maintainer.

2003-07-02 Added sqgetGlobalVar lines to make plugin work with
           register_globals = Off.

2003-10-27 Added il8n support and the Spanish translation with 
           tremendous help from Rodolfo.

           French translation added with alot of help from Cdric.
      
           This should also take of the problem of not being able
           to see the members of a newly created group.

           It should also take care of the error:
           Fatal error: Call to undefined function: fetchrow() in...

2003-11-17 Fixed problems listing existing groups.  Please see 
           UPGRADING to incorporate this fix.  This was done with
           tremedous help and understanding from Tomas Kuliavas.

           Lithuanian was also added with help from Tomas.

           German was added with a lot of help from 
           Thommie <t.rother@netzwissen.de>.

           Got rid of window$ carriage returns in some files.

           Fixed the way "Modify" reponds if you don't change the
           group name.

2003-11-22 Added confirmation when deleting a group.

           Added Dutch translation with help from Ronald.


UPGRADING:

This applies to upgrading to version >= 0.35.

Some languages were not displaying the members of existing groups.
To fix this problem I changed the way the "type" field stored it's 
information (i.e., "Personal address book").  The "type" field now 
stores this information in English, but is still translated for the
end user.  This also gives you the ability to list groups created
in other languages.

To upgrade install the newest version of the plugin and then modify
your database with something similar to:

UPDATE addressgroups
SET type='Personal address book'
WHERE owner='mike';
 
'mike' should be replaced with the user whos groups need to be changed.          

INSTALL:

Backend for personal addressbook stored in a database,
accessed using the DB-classes in PEAR. Follow the instructions
in doc/db-backend.txt to get that setup. 

When you've got that done copy the tar.gz to plugins/ directory 
and:

  tar zxvf abook_group.tar.gz 

You'll need to create an addressgroups table in your database. 
The table used should have the following columns:

    Columns   | Type | Modifier
--------------+------+----------
 owner        | text |
 nickname     | text |
 addressgroup | text |
 type         | text |

The pair (owner,nickname, addressgroup, type) should be unique.

The (owner,nickname) pair is the unique reference to the addressbook
of the owner.

Type comes in when you have two different types of address books:
abook_database.php
abook_global_database.php

To create the table you could use something like this:

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

The lengths and datatype of the fields are suggested. Modify them to suit
your needs, especially if you use a different database. 

TRASLATIONS:

Anyone able to provide me with translations you'll find the most current 
.po in plugins/abook_group/po/.

Please send them to me @ quincy@linuxnotes.net.
