RoundCube Webmail Change Local User Password Utility
----------------------------------------------------
Version 0.7

Updated to chetcpasswd 2.4.2 base which includes security fixes and ability
to limit recycled passwords. The "RC" version continues to modify the base 
only for the closing of the window using the "cancel" button.

Version 0.6

Updated to chetcpasswd 2.4 base (includes security fixes) and updated to "a" for
bug fixes not addressed in the distribution. The "RC" version only has one 
update to close the window upon choosing "cancel".

Version 0.5

This is a simple and quick way to allow local users to change their passwords
vi a web based CGI script. You will need to do 2 things to make this work:

1. Build and install the chetcpasswd.cgi

2. Patch RC file to add the option tab in Preferences

BUILD AND INSTALL "chetcpasswd.cgi"
-----------------------------------

Download the rc-changepw file and unzip the tarball:

#> tar -zxvf rc-changepw-0.7.tar.gz

Change to the directory containing the source files for chetcpasswd:

#> cd rc-changepw-0.5/chetcpasswd-2.4.2-rc

Run the configure command to prepare for build. NOTE: You must be sure you know the
location of your cgi-bin directory. On RedHat and CentOS that will likely be in
/var/www/cgi-bin. On others it may be in /usr/local/apache/cgi-bin. Be sure you have
the correct location for the configure command:

#> ./configure --enable-cgidir=/var/www/cgi-bin

Run make (to build) and make install (as root!) to install the files. The "install"
will do several things including:

	1. Install the cgi script in the defined cgi-bin directory
	2. Correctly chmod the file for setuid permissions
	3. Create the /usr/local/chetcpasswd directory
	4. Install the conf and language files in above directory

#> make
#> make install

Create a file called chetcpasswd.allow in the /etc/chetcpasswd directory and put 
in 0.0.0.0 to allow all ip addresses to access the script - or limit as your needs may 
dictate.

Edit the chetcpasswd.conf file located in that directory for any specifics you may
like. Defaults will work - but you may prefer different minimum and maximum password
lengths for example or may want to use different language for your site.

To remove - change back to the source directory and run:

#> make uninstall

Installation of the cgi utility is complete.


PATCH THE RC PREFERENCES FILE
-----------------------------

Locate and edit the following file in your www install directory for RC:

<...RC root directory...>/skins/default/includes/settingstabs.html

replace this line:

<span id="settingstabdefault" class="tablink"><roundcube:button command="preferences" type="link" label="preferences" title="editpreferences" /></span><span id="settingstabfolders" class="tablink"><roundcube:button command="folders" type="link" label="folders" title="managefolders" class="tablink" /></span><span id="settingstabidentities" class="tablink"><roundcube:button command="identities" type="link" label="identities" title="manageidentities" class="tablink" /></span>

with this line:

<span id="settingstabdefault" class="tablink"><roundcube:button command="preferences" type="link" label="preferences" title="editpreferences" /></span><span id="settingstabfolders" class="tablink"><roundcube:button command="folders" type="link" label="folders" title="managefolders" class="tablink" /></span><span id="settingstabidentities" class="tablink"><roundcube:button command="identities" type="link" label="identities" title="manageidentities" class="tablink" /></span><span id="settingstabpassword" class="tablink"><A href="https://secure.yourdomain.com/cgi-bin/chetcpasswd.cgi" target="_blank">Password</A></span>

Note that this only appends the last "tablink" to the line. Make sure to change the
reference to YOUR domain url and YOUR specified cgi-bin directory if you customized
in any way.

The tab will pop open a new window when clicked (leaving RC running in the original
window). Hitting the "close" button after password changing activity will simply
close the popup window and return to the RC window.

Unless RC releases change this line reference line for tabs - this patch will work.
Any new release of RC will only require the patch of this one file to enable the popup
but the backend should not change (unless there are updates to chetcpasswd).

NOTE -- This is a newer and updated version of the chetcpasswd.cgi than is available
on the sarg site (home of chetcpasswd), and incorporates a few bug fixes and mods for 
use with RC. IF you choose to download version 2.4 from that site - please do not
inquire with me regarding bugs which are fixed in this version for RC (versioned
as chetcpasswd-2.4.2-RC)