Installing Expire plugin in SquirrelMail
========================================

1) Start with untaring the file into the plugins directory.
   Here is a example for the 1.2 version of the expire plugin.

  $ cd plugins
  $ tar -zxvf expire-1.2-1.4.tar.gz

2) If you do not need to change the default plugin settings,
   skip to the next step.  Otherwise, change into the expire 
   directory, copy config.php.sample to config.php and edit 
   config.php, making adjustments as you deem necessary.

  $ cd expire
  $ cp config.php.sample config.php
  $ vi config.php

3) Then go to your config directory and run conf.pl. Choose
   option 8 and move the plugin from the "Available Plugins"
   category to the "Installed Plugins" category. Save and exit.

  $ cd ../../config/
  $ ./conf.pl

4) Review the "mail-expire" script. This script (called by cron) 
   will later do the mail delete. 
   
   user_base="/home/$USER/Maildir"

   This parameter points to the root location of user's mail 
   directory. Depending on the IMAP server you're using, you may
   have to add some additional code to help the script figure out, 
   where users mail directory is located. The provided version 
   is tested (and work's well ;-)) with the DoveCot IMAP server.

5) Run the installation script for the daily cron job (the 
   installed script is later resposible for deletion of expired 
   mails).
   
   If you're not allowed to access the system daily cronjob 
   directory, then try asking your system administrator :-)
   
  $ cd expire
  $ ./instsh

6) Log on to SquirrelMail. A new folder (named "expire") is 
   automatically created in the SM data directory and the 
   default expiration settings from "config.php.sample"
   (or, if you've created a "config.php" file, from that file) 
   were stored in a per-user file in the "expire" directory.

7) Select "folder" menue. You should see a new option there. Now
   you can modify from which folder the mails should be deleted 
   (after reaching the expiration date).

International language support
==============================

Yes, there is international laguage support available. As you 
should know you need some "gettext" support to translate the 
messages. For further information please have a look at the 
pages at http://www.squirrelmail.org.

  $ ./getpot

This script extract all string used in the plugin to the file 
"expire.po". Please modify the string in that file to your 
language (a translation file for germany is provided).

  $ ./compilepot
  
This script compiles the translated messages and stores them 
into the SM "locales" directory.

Live long and prosper!
jam@qv90.de
