Line 2: |
Line 2: |
| yum --enablerepo=smecontribs install smeserver-vacation | | yum --enablerepo=smecontribs install smeserver-vacation |
| Setup an automatic 'out of office' email reply. | | Setup an automatic 'out of office' email reply. |
| + | |
| + | |
| === Version === | | === Version === |
| {{ #smeversion: smeserver-vacation }} | | {{ #smeversion: smeserver-vacation }} |
| + | |
| + | |
| ===Overview=== | | ===Overview=== |
− | Admin can enable the vacation message for users. | + | 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. |
| | | |
| | | |
− | ===Enable=== | + | ===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. | | If you install [[:UserManager]] and delegate the user-vacation panel to users they can prepare and enable their vacation message themselves. |
| + | |
| + | ====Only for SME9==== |
| + | |
| + | If you install [[:UserManager]] and delegate to users the 'uservacations', they can manage by default the vacation message of all users. However it is needed sometime to restrict a user to certain groups, or just one group. |
| + | |
| + | * The user 'helene' will be able to manage only users belong to the group 'parents' |
| + | db accounts setprop helene delegatedVacations 'parents' |
| + | |
| + | * The user 'helene' will be able to manage only users belong to the groups 'famille' and 'enfants' |
| + | db accounts setprop helene delegatedVacations 'enfants,famille' |
| + | |
| + | * Remove all group based restriction |
| + | db accounts setprop helene delegatedVacations '' |
| + | or |
| + | db accounts delprop helene delegatedVacations |
| + | |
| + | ===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=== | | ===Configuration=== |
| + | |
| *Only one reply is sent to each sender until the Repeat interval is reached | | *Only one reply is sent to each sender until the Repeat interval is reached |
| | | |
Line 35: |
Line 68: |
| | | |
| ===User Shell Access=== | | ===User Shell Access=== |
− | If a user has shell access they can use advanced vacation functions, man vacation | + | |
| + | If a user has shell access they can use advanced vacation functions : |
| + | man vacation |
| | | |
| ====Vacation responses==== | | ====Vacation responses==== |
| + | |
| The vacation handling routine stores whom has been send a vacation | | 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 | | message, it's possible for the user to generate a list of those addresses |
Line 51: |
Line 87: |
| wally@abc.net.au | | wally@abc.net.au |
| Wed Sep 17 18:23:56 2008 | | Wed Sep 17 18:23:56 2008 |
| + | |
| | | |
| ====No Replies==== | | ====No Replies==== |
| + | |
| Apart from the default no replies Vacation will also not generate a reply | | 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 | | if the sender matches any of the mail addresses listed in the |
| optional files ~/.vacation.aliases or ~/.vacation.noreply. | | optional files ~/.vacation.aliases or ~/.vacation.noreply. |
| + | |
| + | ===Troubleshooting=== |
| + | |
| + | ====Envelope sender not allowed when using remote SMTP==== |
| + | |
| + | It is possible to specify a custom sender domain in the "From:"-header of a user's vacation message. If this custom sender Domain is not registered as a valid primary or secondary domain in SME server-manager, chances are that remote SMTP servers will reject the vacation message (550 envelope sender not allowed). |
| + | |
| + | Some remote SMTP servers will forward the vacation message nonetheless in that case, if an additional "Return-Path:"-header (using the same sender address) is set in the vacation message, eg. before the first blank line separating the body of the mail, one can write: |
| + | |
| + | From: user@customdoma.in |
| + | Return-Path: user@customdoma.in |
| + | Subject: Away from my mail - $SUBJECT |
| + | |
| + | ====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 === | | === Bugs === |
| + | |
| {{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-vacation|noresultsmessage="No open bugs found."}} | | {{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-vacation|noresultsmessage="No open bugs found."}} |
| [[Category: Contrib]] | | [[Category: Contrib]] |