Vacation plugin v1.0
-----------------------------------

This plugin allows UNIX users to set an auto-reply message to incoming email. Most commenly used to notify the sender of one's absence. This plugin specifically uses the Vacation program.

It uses FTP to transfer the files and so doesn't require the IMAP server to
provide access to them (some IMAP servers will only allow access to files
within the ~/mail directory for example).

This plugin is completely based on the Mail Configuration Plugin written by Chris Wakelin <c.d.wakelin@rdg.ac.uk>. I modified his plugin for my own use. And since I thought more people might find this plugin handy, I'm contributing back.

In turn, the Mail Configuration Plugin is based losely on the "Forward File Editor" add-on for TWIG (see
http://twig.screwdriver.net/addons.php3) by "monica-k@usa.net".

It is released under the GPL (see ../../COPYING).

How to use with procmail
------------------------

The following code (adapted from procmailex man page) may be used to
work together with this plugin:

:0 Whc: vacation.lock
* ? test -e $HOME/.vacation.sq
# Perform a quick check to see if the mail was addressed to us
* $^To:.*your@email.here
 # Don't reply to daemons and mailinglists
* !^FROM_DAEMON
 # Mail loops are evil
* !^X-Loop: your@email.here
| formail -rD 8192 $HOME/procmail/vacation.cache

  :0 ehc         # if the name was not in the cache
  | (formail -rI"Precedence: junk" \
       -A"X-Loop: your@email.here" ; \
     cat $HOME/.vacation.sq; \
     echo ""; \
     echo "-- "; cat $HOME/.signature \
    ) | $SENDMAIL -oi -t

				

Requirements
------------
* PHP needs to be compiled with FTP support (use the "--enable-ftp") option.
* The FTP server needs to use the same usernames and passwords as the IMAP
  server (they need not be the same machine).
* The configuration files need to reside in the top level of the
  users' home directories.
* The Vacation program needs to be installed. For most sendmail configurations
  it also means you need to put a symbolic link in /etc/smrsh to the vacation
  program. The RPM for RedHat can be found here:
  ftp://ftp.redhat.com/pub/contrib/libc6/i386/vacation-1.2.2-2.i386.rpm

You should edit (at least) the config.php file to reflect the settings at your
site. All the text can be edited there.

Bugs
----
* Language support doesn't seem to kick in the first time you enter the 
  vac_init.php page. I have no idea why.

Version
-------
0.12 - Modified by Matt King <mking@magnetinternet.com>
- Added ability to specify subject of auto-reply message
- Added ability to specify forwarding address in addition to auto-reply
- Code Cleanup

0.11
Function sqStripSlashes was removed from Squirrelmail. So I inserted it into the plugin itself.


Author (well... hardly)
------
Ronald Luten <r.luten@oad.nl>
Comments welcome!
