Sending Emails When Events Change
The Email Settings screen allows you to specify email settings for the program. Changes you make here apply to the entire installation (that is every calendar). Only SUPER users may access this function.
Logging Emails
The fields on this page need to be set carefully so the email notification function works properly. The link labeled View the email log file will aid in troubleshooting email problems. This link will only appear if you turn on logging by checking the Log all emails checkbox.
If the log exists the clear the email log link will remove all entries from the email log.
Details of Fields
Mail Method:
Never send email: The default.
Send email only after user confirmation: causes the Email Notification Confirmation screen to appear each time an event is modified.
Automatically send email: causes an email to be sent automatically each time an event with a Notification List is modified.
Mail Server: This is the name or IP address of an email server that will recognize and allow the From Address email to send email. This is a required field if Mail Method does not equal 'Never send mail'.
From Address: This is a valid email address on the Mail Server listed above. This is a required field if Mail Method does not equal 'Never send mail'.
Log all emails: This will cause a log entry to be added to the email log each time an email is sent by the program. This might be useful in debugging problems setting up these email settings.
Send HTML mail: If checked the email that is sent will be HTML email. Some mail readers can not handle HTML email so make sure to test this setting under your email configurations.
Customizing Email Notifications
It is possible to customize the subject, body and reply to address of the emails that are sent. This is accomplished through the use of three Event Display Strings (please read the referenced help file for a discussion of this feature).
There are three Event Display Strings associated with email notifications which are fully detailed here.
Email will only be sent if the following conditions are all TRUE:
Mail Method is not set to 'Never send email'
The machine specified by Mail Server is accessible from the web server machine
From Address is a valid email account on Mail Server
The event that is being modified has a Notification List and the Notification List contains at least one valid email address, user id with a valid email address, user group which has a valid email address or contains a member userid with a valid email address.
Under the Linux version of this program there is an additional option which allows you to point to the mail program that will be used to send the mail. By default this value is /bin/mail.