Vacation plugin v1.4
-----------------------------------

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).

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.

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

Version
-------
1.4 (hey let's jump version numbers!) - Added support for SM 1.4, made minor code enhancements (thanks to David Minor <dave@dminor.com> for adding support for skipping local delivery and other fixes). 
0.12 - Modified by Matt King <sqmvac@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)
------
Matt King
sqmvac@magnetinternet.com
