Mail Alias plugin for SquirrelMail
==================================
Ver 2.0.0, 13/08/05

Original Author: Graeme C Neatham <graeme@promptpost.com>


Description
===========

This plugin will allow a user to set up email aliases for their account.

Currently it assumes that both main account and forwarding information 
are held in an SQL database, for example MySQL or PostgreSQL. 
It also assumes that a user's id is their full email address of the 
form [USERNAME]@[DOMAIN].

Version 2.0.0 has provided the possibility of keeping Aliases and 
Identities synchronized.  That is when adding an Alias a matching 
Identity may be added; or when deleting an Alias all matching 
Identities may be deleted.  When matching the Alias is compared 
to the "E Mail Address:" field used by the Identity.

This plugin has only been tested with SM 1.4.5 and 1.4.4, 
but it may well work with other versions.

Help Requests
=============

Help requests are welcome at my personal email address, but I
request that you first post to the SquirrelMail Plugins mailing
list, where you may get faster help from more people and other
people with the same problem will be able to see how your issue
was resolved.  If you don't get good answers that way, you may
try emailing me directly.

Info about the SquirrelMail Plugins mailing list can be found
on the SquirrelMail web site.  It is currently located at:

http://lists.sourceforge.net/mailman/listinfo/squirrelmail-plugins
squirrelmail-plugins@lists.sourceforge.net


To Do
=====

Suggestions for Improvement are welcome.

1.  Allow the option for aliases to share any file space
2.  Enhance creation of matching Identity to include capturing of
    additional details such as full name.
3.  Add more translations - help gratefully received!


Acknowledgements
===============

I would like to thank the author's of the following plugins - 

           Mail Forwarding Options
           Server Side Filters
           Login Notes

whose code was an inspiration and a guide for this plugin.

I would also like to thank: 
Jean-Marc DELATRE for the French translation,
Sander Bol (kander on EMD) for the Dutch translation,
and the persons who wish to stay anonymous for the 
Hebrew and Spanish translations.

Change Log
==========

  2.0.0 (17/08/05)
   * Major rewrite to use PEAR.DB database abstraction layer.
     Should now work with any database supported by PEAR.DB
     Tested with MySQL, PostgreSQL and SQLite.
   * Moved SQL statemnts from the code to the config file.
   * Added optional creation/deletion of Identities when
     adding/removing Aliases.
   * Added Spanish translation. 

  1.6 (16/03/05) - Graeme C Neatham <graeme@promptpost.com>
   * Improved code following guidance from Paul Lesneiwski <paul@squirrelmail.org>
   * Added ability to define "no maximum" for the number of aliases

  1.5 (15/03/05) - Graeme C Neatham <graeme@promptpost.com>
   * Added Dutch translation 
   * Added ability to define per user maximum aliases allowed

  1.4 (02/01/05) - Graeme C Neatham <graeme@promptpost.com>
   * Added French and Hebrew translations (no functionality changes)

  1.3 (22/12/04) - Graeme C Neatham <graeme@promptpost.com>
   * Modified interface to use a drop-down list for permitted domains

  1.2 (08/12/04) - Graeme C Neatham <graeme@promptpost.com>
   * Added Internationalization to code (no functionality changes)

  1.1 (16/11/04) -  Graeme C Neatham <graeme@promptpost.com>
   * Tidied code to better meet plugin standards
   * Add documentation files, (no functionality changes)

  1.0 (15/11/04) -  Graeme C Neatham <graeme@promptpost.com>
   * Initial release

