Installing for the first time

1. Untar the plugin under the squirrelmail/plugins directory. You probably have already done this. :)
2. Copy config_sample.php to config.php. Edit config.php to your preferences. The file is self-documented with comments.

Upgrading versions

1. Move the old useracl directory aside:
   mv useracl useracl-prev
2. Untar the new version.
3. Check the documentation (doc/CHANGELOG.html) if there are any new configuration options.
4. Copy your previous configuration file:
   cp ../useracl-prev/config.php ./config/
5. You can also try a diff with the sample configuration file, if there are any changes:
   vim -d config_sample.php config.php

If and only if you are positive that things work as before (or, even, better), then delete the old directory!

Enabling the page header link in message listings

To enable the display of a link to useracl in each folder listing, you have to add an extra plugin hook in functions/page_header.php:

Search for "pagetop" (around line 271) and add the following lines, just before the line echo " </td>\n :

     $pagetop_string = ' ';

     $ret = concat_hook_function('pagetop', $pagetop_string);

       if($ret != '') {

           $pagetop_string = $ret;

     }

     echo $pagetop_string;