This LimeSurvey Plugin is an extended version of the onSubmit notification feature of LimeSurvey
This plugin works on LimeSurvey v2.06+ (from Build 151109)
##Main features This new Email notification plugin will send confirmation emails when a response is submitted.
Shared features with the standard notification system:
- several destination emails can be given for a single template
- the templates are localized (a template is proposed for each survey supported language)
- the
{ANSWERTABLE}
variable is recognized - destination email addresses are EM expressions and thus can depend on the participant's answers (this enables email routing based on the response)
- destination email addresses can be taken from the response (usable for open-surveys with no auto-registration or no allow-save enabled)
- if the destination email addresses list (semi-column separated list) contains no valid email address, no email is sent. This makes it possible to add relevance conditions to confirmation emails.
Main new features:
- multiple email templates for each survey (not limited to the participant's notification, the basic and detailed admin notification from the core feature)
- it is possible to attach some files from file-upload questions. As it is setup using an EM expression, conditions are supported to select which file to upload or not.
Not implemented in this plugin:
- there is no possibility to attach a static file which would not be uploaded in a file-upload question
##Installation
Simply copy the ConfirmByEmail
directory and its content to your plugins/
directory.
##Configuration On the plateform
- First enable the plugin from the LimeSurvey Plugin Manager. Then set the maximum number of email templates each survey administrator will be able to manage.
On each survey
- Enabling the plugin on the survey
- on the survey administration parameters, go to General Settings and open the Plugins tab
- set the number of emails template you need (the default value of
0
disables the plugin). - Important: Once updated the Survey Settings form is automatically saved, and you have to get back to the Plugins tab to see the new settings.
- Email destination: this field is an EM expression that results in a semi-column separated list of email addresses
- example 1: you just want to send the email to [email protected] and [email protected], then just type in
[email protected];[email protected]
- example 2: if you have 2 questions with codes persoEmail and proEmail, then you can type
{proEmail};{persoEmail}
- you can of course use complex EM expressions making the resulting list conditionned to answers
- In the resulting list you can have empty values (which will be ignored): for instance if the EM expression results in
;;;
then no email will be sent - Email language: this field lets you decide if the email will be sent translated with the response's language or with the survey's base language
- Attachments list: this field accepts an EM expression that results in a semi-column separated list of question codes. These questions must be of type File-upload and their content will be attached to the email
- you can of course use complex EM expressions making the resulting list conditionned to answers
- In the resulting list you can have empty values (which will be ignored): for instance if the EM expression results in
;;;
then no file is attached to the email - Email Subject (for each language): the subject of the email as an EM expression enabling custom text tailoring
- If the subject for a specific language is not set, and the email is intended to use this language, then the survey's base-language of both Subject and Content will be used.
- Email Content (for each language): the subject of the email as an EM expression enabling custom text tailoring
- In the Content you can use the
{ANSWERTABLE}
placeholder as a shortcut. Note that the response timestamp will be hidden if the survey is not set to DateStamp