Vacation

From SME Server
Revision as of 06:55, 24 September 2015 by Mats (talk | contribs)
Jump to navigationJump to search

Vacation Message

yum --enablerepo=smecontribs install smeserver-vacation

Setup an automatic 'out of office' email reply.


Version

Contrib 10:
Contrib 9:
smeserver-vacation
The latest version of smeserver-vacation is available in the SME repository, click on the version number(s) for more information.



Overview

Admin (and possibly users themselves, see below) can enable a vacation message for individual users. In addition to manually enabling and disabling the vacation message for a user, also automatic start and end dates for sending out vacation messages can be set in the server manager panel.


Grant users access to vacation panel

If you install UserManager and delegate the user-vacation panel to users they can prepare and enable their vacation message themselves.


Automatic enabling and disabling of vacation messages

The server-manager panel provides two fields where you can enter start and end dates for the vacation message of a user. These date values will be checked by a simple cron script every night, in order to enable or disable the vacation message of this user at the given dates, respectively.

The two date fields in the server-manager panel are not programatically validated with respect to common-sense, so some rules apply:

  • Start date has to be before end date
  • Start date must not be the same as the end date (for single day holidays, set end date to the following day).
  • If the intended start date is in the future (from "now"), the checkbox for enabling the vacation message should be unchecked (otherwise vacation messages will be sent out from "now" on).

If you do not want to use this automatic functionality, simply leave both fields empty.


Configuration

  • Only one reply is sent to each sender until the Repeat interval is reached

Change the interval between repeat replies to the same
sender. The default is 1 week. A trailing s, m, h, d, or w
scales the number N to seconds, minutes, hours, days or
weeks respectively. For example, to set the interval value
to 3 days you would specify -t3d. There should be no spaces
between the -t and N.

configure, then apply to all users,

config setprop qmail VacationDelay -t3d
or
config delprop qmail VacationDelay

/etc/e-smith/events/actions/qmail-update-user
  • Addresses to be replied to:

All mail for the user including pseudonyms and groups will send the reply message.


User Shell Access

If a user has shell access they can use advanced vacation functions, man vacation

Vacation responses

The vacation handling routine stores whom has been send a vacation message, it's possible for the user to generate a list of those addresses if the user has shell access.

#  /usr/local/bin/vacation -s jane
Welcome back!
While you were away, vacation mail was sent to the following addresses: 

garry@site.com
   Wed Sep 17 18:40:45 2008
wally@abc.net.au
   Wed Sep 17 18:23:56 2008


No Replies

Apart from the default no replies Vacation will also not generate a reply if the sender matches any of the mail addresses listed in the optional files ~/.vacation.aliases or ~/.vacation.noreply.


Disable cron status mail

If you wish to disable the status mail from cron, follow the workaround given in http://bugs.contribs.org/show_bug.cgi?id=7555#c26

This may be suppressed in a future release.

Also refer to http://forums.contribs.org/index.php/topic,51952.0.html


Bugs

IDProductVersionStatusSummary (9 tasks)
12503SME Contribs10.0CONFIRMEDVacation messages do not get DKIM-signed
12474SME Contribs10.0RESOLVEDMenu entry for SM2 not properly positioned
11829SME Contribs10.0UNCONFIRMEDwrong spelding in vacation message
11388SME Contribs10alphaCONFIRMEDwarning in user-manager when clicking on panel link in menu
11052SME Contribs10alphaCONFIRMEDWarning on install when smanager not installed
10708SME Contribs9.3UNCONFIRMEDVacation additional columns
10317SME Contribs10betaCONFIRMEDReply not sent to original Sender
6020SME Contribs7.4CONFIRMEDLocal delivery of email stops
4824SME Contribs7.4CONFIRMEDvacation message format not supporting Hebrew well