Login Alias plugin for SquirrelMail
===================================
Ver 2.4, 08/02/2005

Copyright (c) 2001 Jay Guerette <JayGuerette_at_pobox.com>
Copyright (c) 2002 David Minor <dave_at_dminor.com>
Copyright (c) 2002-2005 by Paul Lesneiwski <pdontthink@angrynerds.com>



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

This plugin allows users to specify an optional friendly login alias in
Options/Personal Information. The alias can have spaces in it. Thereafter
they can log in using this alias.



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'll 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



License
=======

This plugin is released under the GNU General Public
License (see COPYING for details).



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

  v2.4 08/02/2005
    * Fixed incompatibility with SquirrelMail 1.4.4 where prefs
      were being wiped out.  There is a small chance that this
      fix is not backward compatible, possibly with SM 1.2.x;
      if this is the case, either use v2.3 of this plugin (which
      is functionally almost identical) or let me know and I can 
      get it fixed for you.
    * Now works correctly with hashed prefs directories
    * login_alias.pref file is auto-created, no longer requires
      manual creation at install time
    * Updates to work with newest Vlogin plugin; if using Vlogin 
      with this plugin, make sure you get at least version 3.6
      of Vlogin, which was released at the same time as version 
      2.4 of this plugin
    * Correct internationalization
    * Code cleanup

v2.3
Checks new aliases against all current SquirrelMail users to ensure
none of them get locked out (but still could clash with new/future
users' usernames) (Many thanks to Markus Neubauer 
<markus.neubauer@std-software.de> for ideas and help)
Removes login alias from all prefs when user deletes it (previously
it could not be removed)
Small fix to retain vlogin compatibility.

v2.2
Fix for when the domain name is part of your usernames and you are 
using the vlogin plugin, such that someone in "domain_1.com" can 
use an alias such as "jose" and not lock out "jose@domain_2.com"

v2.1
Updated to work when SquirrelMail prefs are stored in a database.
(Thanks to Marietta <marietta@burnside.powells.com>)
Updated for new plugin version reporting API.

v2.0 
Updated for compatibility with SquirrelMail 1.4
New setup.php format for better overall SquirrelMail performance.

v1.3
register_globals=Off support added
updated to work with vlogin (virtual hosts) and password_forget plugins
  (the only worry now would be that a login alias, if the same as another
   user's real account name, would block that user from logging in.)
updated for compatibility with "plugin updates" plugin
internationalized plugin output

v1.2
change of alias removes old alias 
checks for matching alias and prompts users to try again if alias already exists 

v1.1
modified to work correctly with squirrelmail preference caching
and not mangle the user's preferences.

v0.3 (alpha)
modified to play nicely with password_forget plugin load order

v0.2 (alpha)
modified to play nicely with password_forget plugin

v0.1 (alpha)
initial public release

