Change Passwd plugin for SquirrelMail
-------------------------------------
Thiago Melo de Paula <thiago@fafibe.br>
Paul Lesneiwski <pdontthink@angrynerds.com>
Ver 3.1, Jul 12, 2003

This is a Squirrelmail plugin to allow your users to change 
his/her system password in /etc/passwd or /etc/shadow

Change Passwd plugin, uses a C program to make possible the 
alteration of the password.

Note that this uses PAM library calls and the source is in 
chpasswd directory.


---TROUBLESHOOTING-----------------------

1) Please verify that the ownership and permissions of the chpasswd
are correct.  The file should be executable (and readable) by your
web server user, and owned by root (with suid bit set) (see step 
number 2 in the INSTALL file).  Its listing should appear similar 
to this:

-rwsr-x---    1 root     apache       9873 Oct 21  2002 chpasswd*

2) Turn on $seeOutput in config.php to see if the chpasswd program is
returning any errors of note.

3) Please turn on the $debug flag in config.php and attempt to change
your password.  It will show you a command and a directory from which
to run the command - please change to that directory on your server
and run that command exactly as is.  

The command should be in the form:

/path/to/chpasswd <username> <old password> <new password>

Make sure the user name and password information matches and that 
the command can be run from the command line.  If you are having 
problems on the command line, you might want to look for a different 
version of the chpasswd program (either on the Internet or on your own 
machine by typing "locate chpasswd").


---CHANGE LOG----------------------------

Ver 3.1, Jul 12, 2003 (Paul Lesneiwski <pdontthink@angrynerds.com>)
  - Added debugging functionality
  - Fixed logout link when forcing users to log out after password change
    (Thanks to Robert Tom <robert@estrell.com>)
  - Added support for FreeBSD's 'pw' password change utility (Thanks to 
    Rickard Lind <rickard.lind@ntier.se>)
  - Fixed file include functionality to be more in line
    with the SquirrelMail paradigm; should fix anomalous
    behaviors some people were seeing
  - Fixed problems when trying to keep users logged in after password change
  - Force logout to both frames
  - Fixed color problems with some themes
  - Now escapes shell metacharacters in passwords
  - Moved config.php to config.php.sample for hassle-free upgrades
  - Fixed erroneous error reporting
  - Added Italian language file (Thanks to Massimiliano Spini 
    <massimiliano.spini@outsourcing.albacom.net>)
  - Added Swedish language file (Thanks to Rickard Lind 
    <rickard.lind@ntier.se>)
  - Added Estonian language file (Thanks to Erkki Liba
    <lips@annenk.tartu.ee>)
  - Added Romanian language file (Thanks to Iosif Fettich
    <ifettich@netsoft.ro>)
  - Added German language file (Thanks to Cavegn Christian
    <ichris@rubbish.ch>)
  - Added Dutch language file (Thanks to Anton Osinga
    <rzch0s@toonsmachine.homelinux.com>)
  - Added French language file (Thanks to LoE de VAULX
    <loic.de-vaulx@webinov.com>)

Ver 3.0.1, Apr 18, 2003 (Jukka Vuola <juki@linja.org>)
  - Added Finnish language file

Ver 3.0, Apr 09, 2003 - (Paul Lesneiwski <pdontthink@angrynerds.com>)
  - Corrections to English language file
  - Lots of E_ALL fixes
  - Added compatibility with SquirrelMail 1.4 (while also retaining 
    backward compatibility with version 1.2.x)
  - Added compatibility with Plugin Updates plugin
  - Added register_globals=Off compatibility
  - Minor HTML formatting fixes

Ver 2.0, Out 21, 2002 - (Thiago Melo de Paula)
  - I made a C program to diminish the complexity of the plugin, now you don't need worry about cgi.
  - After password change, the user aren't disconnected of SM. You can choose this in the config.php.
    The default is that the user don't will be disconnected.
  - The config.php file have more options to configure the plugin.
  - This plugin was tested with SM 1.2.7 and 1.2.8

Ver 1.1, Sep 05, 2002 - (Thiago Melo de Paula)
  - The config.php file have more options to configure the plugin.
  - If the password change is successful, the user will be disconnected of SM to connect with new password.
  - I tried to detail the README file better.
  - Removed some useless buttons. Now just have the submit button.
  - Correct the number of initial version of the README file!!!!

Ver 1.0, Sep 01, 2002 - (Thiago Melo de Paula)
  - Initial Version!
