E-mail Sjablonen
From LimeSurvey Manual
Introductie
Met e-mail sjablonen kun je snel persoonlijk gemaakte uitnodigingen, herinneringen, bevestigingen en registraties e-mailen naar de mensen die meedoen aan je enquête, Je kunt ook allerlei notificaties naar de beheerders opmaken.
Klik in Enquête instellingen op de tab E-mail sjablonen:
Als je een hoofdbeheerder bent (je hebt toegang tot de globale instellingen van de LimeSurvey installatie), kun je de standaard HTML editor-mode wijzigen voor alle LimeSurvey gebruikers. Meer informatie.
Attentie : Als je de popup/inline HTML-editor wilt gebruiken moet je de HTML-formaat voor toegangscode e-mails gebruiken: inschakelen! Kijk op het menu Instellingen van je enquête op de tab Deelnemers.
Paneel E-mail sjabloon
Het paneel:
In het voorbeeld wordt de "HTML-source" editor-mode gebruikt. Deze instelling kun je hier wijzigen.
Je kunt eenvoudiger tekstvelden wijzigen als je de instelling Inline HTML-editor mode in je account-instellingen kiest.
De type e-mails die er naar gebruikers en/of beheerders kunnen worden verzonden:
Uitnodiging
De functie Uitnodiging gebruik je als je veel e-mails wilt versturen naar alle deelnemers in je deelnemerstabel die nog geen uitnodiging gekregen hebben om je enquête in te vullen.
In het paneel e-mail sjablonen kun je het bericht dat je wilt versturen wijzigen. Je kunt in het bericht een aantal placeholders gebruiken. Je kunt met Expressie beheer je het sjabloon mooier maken.
Herinnering
De functie Herinnering gebruik je als beheerder als je deelnemers wilt herinneren aan het feit dat de enquête nog niet is (volledig) ingevuld.
In het paneel e-mail sjablonen kun je het formaat van de herinnering wijzigen. Je kunt in het bericht een aantal placeholders gebruiken. Je kunt met Expressie beheer je het sjabloon mooier maken.
NB: Een herinnering wordt natuurlijk niet verzonden aan een deelnemer als die de enquête al afgerond heeft of geen deelnemer aan de enquête is.
Bevestiging
Als er toegangscode worden gebruikt en een deelnemer voltooid de enquête dan wordt er een bevestiging verstuurd naar het e-mailadres van die deelnemer. Deze bevestiging kun je uitzetten.
Click on the Confirmation tab if you wish to edit the email template. Check the email placeholders to see which ones can be used in this type of email. You may also use the Expression Manager to enhance your email customization.
Registratie
If the closed-access mode is enabled (there is a survey participants table, which means that only those participants who have an allocated entry and a unique token code associated to it can complete the respective survey. If you allow participants to publicly register to your survey, a new entry in your survey participants table will be created once the respondent has submitted his or her name and email address. A script that runs in the background will automatically send the respective respondent a registration email. It contains the URL with the token that needs to be accessed by the newly registered user.
Click on the registration tab to edit the format of this email. Don't forget to take a look first at which email placeholders can be used within the text body. The Expression Manager can provide further customization to the body text you wish to use.
Basis en gedetailleerde administratie notificaties
To get admin notifications, click on the Data management tab and type in an email address in the "Send basic admin notification email to" and another one (or the same) in the "Send detailed admin notification email to" field.
By default, the only difference between the two is related to the extra placeholder {ANSWERTABLE} that is included in the detailed admin notification email template. This allows the user who receives these kind of emails to also check the submitted answers without being needed to access the LimeSurvey installation.
However, by using the Expression Manager and the email placeholders you can customize these two email templates however you want.
Email sjabloonvelden
Elk sjabloon bevat:
- The subject of the email: The title of the email/batch of emails you want to send;
- The email body: It is a text box that contains the text message you wish to send to the users. It may contain text, images, and email placeholders. Moreover, the Expression Manager can be used to further enhance the message you wish to deliver;
Note: You may have observed that another tab is displayed above the tab with the email templates tab if your survey uses additional languages. If you click on another language tab other than the default language one, the email templates will load the corresponding texts in the respective language. Now, access each email template in order to start editing them. Do not forget to click on the Save button located in the upper-right part of the screen to get all your changes saved.
- Email actions: Two actions are available:
- Reset this template: Once clicked, the HTML code gets reset. No text is deleted;
- Validate expressions: It checks the logic of the email - whether the placeholders are correctly used or not. It is highly recommended to use it before sending a batch of emails. You can see in this way whether the placeholders are correctly defined or not. In the below example, a small typo exists - it is emphasized in the red colour:
- File actions: Different file-related actions can be performed here:
- Add file: Once clicked, the following window will pop up asking you to choose which document from the files folder you wish to send via email:
Bijlagen kunnen onderin het scherm van het bewerken van het sjabloon worden toegevoegd. E-mail bijlagen worden geüpload per enquête.
You can also upload on the spot a file from the desktop to your LimeSurvey installation by clicking on the upload button and then selecting the file you wish to attach to the respective email template.
Once selected, double click on it and the file will be immediately displayed in the Files table, below the Add File button:
To have it permanently attached to the respective email template, do not forget to click on Save button located in the upper-right part of the window.
De keuze of er wel/niet een bijlage toevoegt wordt, bij het versturen van een e-mail naar een specifieke deelnemer, kan worden genomen op basis van een relevantie-vergelijking per bijlage.
Alle functies van Expressie beheer kunnen worden gebruikt, net als de tokens attributen (als de enquête tokens gebruikt).
Bij de sjablonen voor de uitnodiging / bevestiging kan ook gebruik gemaakt worden van de vraagcodes in de enquête.
If you wish to delete a file, click on the red trash button located under the Action column and save the changes.
Attentie :
- Als een bestand niet gevonden wordt, dan wordt de e-mail zonder bijlage verzonden.
- Exporteren / importeren van een enquête betekent niet dat geüploade bestanden worden meegenomen. De instellingen voor bijlagen worden wel overgenomen, evenals de relevantie-vergelijkingen.
E-mail placeholders
Attention : Please note that some email placeholders can be used only within certain email templates! Read below for further details.
As you can see in the default email templates, different email placeholders are used either in the body and/or the subject of the email. Their role is to connect the email you wish to send to each respondent entry from your survey participants list. The data from the survey participants table (e.g., email, first name, last name, token, etc.) is automatically taken and put into different unique emails before being sent to each respondent from your survey participants list.
You can find below the email placeholders that are allowed to be used within the body message of your invitation and reminder email templates. When sending out the emails, these email placeholders will be already replaced in the preview of your invitation/reminder email with data from your survey and survey participants table.
| {ADMINEMAIL} | Email of the Survey admin |
| {ADMINNAME} | Name of Survey Admin |
| {SURVEYNAME} | Title of your survey |
| {SURVEYDESCRIPTION} | Description of your survey |
The following placeholders are allowed in invitation/reminder email templates (subject and/or body fields) and they will be replaced while sending out the emails:
| {EMAIL} | Email of the recipient |
| {FIRSTNAME} | First Name |
| {LASTNAME} | Last Name |
| {SURVEYURL} | The URL pointing to the survey start - if you are sending HTML emails, a full URL will be displayed to the survey participant |
| @@SURVEYURL@@ | The URL pointing to the survey start - this is the barebone link. Use this if you want to integrate the link in your custom HTML elements somewhere (available in v1.90 and later) |
| {OPTOUTURL} | The URL to deactivate sending of email for the respective survey - a full link will be displayed in the HTML version of the email template |
| {OPTINURL} | If a user is blacklisted and he wants to participate in the respective survey, he has to click on the opt-in URL to receive again survey invitations/reminders. |
| {TOKEN} | The token to access the survey |
| {ATTRIBUTE_1} | Attribute 1 |
| {ATTRIBUTE_2} | Attribute 2 (...and so on for more attribute fields) |
If your survey is not anonymous, the email placeholders can be used in order to add specific entry/participant data into the Survey texts panel (e.g., survey description, welcome message, end message).
| {TOKEN:EMAIL} | It displays the email of the respondent from the survey participants table |
| {TOKEN:FIRSTNAME} | It displays the first name of the respondent from the survey participants table |
| {TOKEN:LASTNAME} | It displays the last name of the respondent from the survey participants table |
| {TOKEN} | It displays the token code of the respondent from the survey participants table |
| {TOKEN:ATTRIBUTE_1} | It displays "Attribute 1" of the respondent from the survey participants table |
| {TOKEN:ATTRIBUTE_2} | It displays "Attribute 2" of the respondent from the survey participants table (and so on for more attribute fields) |
To find out more about attributes, read the following wiki section.These email placeholders can also be used in the confirmation and admin notification email templates.
Certain placeholders can be used only within the the admin notification templates. Please note that one email per response will be sent to the email address of the administrator!
Some of the placeholders that can be used only in the admin notification panels are mentioned below:
| {VIEWRESPONSEURL} | Displays an URL that, once click, redirects you to the respondent's submitted answer. |
| {EDITRESPONSEURL} | Displays an URL that, once click, redirects you to a LimeSurvey page from where you can edit the responses submitted by the respective survey participant |
| {STATISTICSURL} | Click on this URL in order to access the statistics of the survey |
| {ANSWERTABLE} | If you wish to display the submitted answers of the respondent in the admin notification email, use this email placeholder. In this way, you do not need anymore to access your LimeSurvey installation in order to check the submitted answers of the respective respondent (as the {VIEWRESPONSEURL} placeholder does). |
Hints:
- If your survey is using anonymized responses, then token-related placeholders will not work in the notification email template.
- You can use Expression Manager to use expressions for tailoring an email (New in 1.92 ). Please have a look at the Expression Manager HowTos for an example.
- Also have a look at the examples on using information from tokens table.
Afmelden door deelnemer
When you use the {OPTOUTURL} tag in your invitation/reminder email, your participants have the possibility to opt out of this particular survey by just clicking on the related URL in the email - so you don't harass them with reminder emails. A participant that opted out of your survey will have the email status 'OptOut' set in the survey participants list.
Gebruik vervangingsfunctie
In het sjabloon van de e-mail kun je enkele specifieke keywords gebruiken om informatie van de toegangscode te gebruiken bijvoorbeeld voor het URL-adres van het token.
Een voorbeeld is het gebruik van een duidelijke link naar de enquête in plaats van een lange URL:
1) Ga naar het paneel e-mail sjablonen en kies Uitnodiging.
2) Write the text you want to appear as link to start the survey.
3) Then select that text.
4) Add the placeholder for the plain link @@SURVEYURL@@ and choose other from the protocol-select-box.
Als je nu een uitnodiging verstuurt zal er een kortere url gebruikt worden om de enquête te starten.