Nächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
de:create:functions:mailschedule [10.12.2014 14:26] – ausgelagert aus functions-respondent admin | de:create:functions:mailschedule [15.05.2019 23:10] – [mailSchedule()] admin |
---|
* //Serienmail//\\ (Numerische) Kennung der Serienmail, die an den Teilnehmer verschickt werden soll. | * //Serienmail//\\ (Numerische) Kennung der Serienmail, die an den Teilnehmer verschickt werden soll. |
* //Zeitpunkt//\\ Die Verzögerung bis zum Versand (in Sekunden, maximal 153900000) __oder__ ein Unix-Zeitstempel, der den Zeitpunkt für den nächsten Versand definiert. | * //Zeitpunkt//\\ Die Verzögerung bis zum Versand (in Sekunden, maximal 153900000) __oder__ ein Unix-Zeitstempel, der den Zeitpunkt für den nächsten Versand definiert. |
| * //Einstellungen//\\ Optionale Einstellungen, als assoziatives Array angegeben mit folgenden Schlüsseln: |
| * '''status''' Erinnerungs-/Folgemails nur verschicken, wenn der Link in der usprünglichen Serienmail ... |
| * '''finished''' -- ...geöffnet und der Fragebogen bis zum Ende ausgefüllt wurde |
| * '''incomplete''' -- ...nicht geöffnet oder nicht bis zum Ende ausgefüllt wurde |
| * '''no-response''' -- ...nicht geöffnet wurde |
| * '''expire''' Gültigkeit des persönlichen Teilnahme-Links beschränken, es gilt dasselbe Format wie für den //Zeitpunkt// |
| |
**Hinweis:** Eine Serienmail wird (im Gegensatz zu ''mailResume()'') nur einmal pro Empfänger zugestellt, auch wenn die Funktion mit derselben Serienmail mehrfach aufgerufen wird. Der Versand unterschiedlicher Serienmails ist möglich -- z.B. eine Einladung zur zweiten Befragungswelle in 14 Tagen und eine weitere Einladung zur dritten Welle in 1 Monat. | **Hinweis:** Eine Serienmail wird (im Gegensatz zu ''mailResume()'') nur einmal pro Empfänger zugestellt, auch wenn die Funktion mit derselben Serienmail mehrfach aufgerufen wird. Der Versand unterschiedlicher Serienmails ist möglich -- z.B. eine Einladung zur zweiten Befragungswelle in 14 Tagen und eine weitere Einladung zur dritten Welle in 1 Monat. |
<code php> | <code php> |
mailSchedule(false, 2, 1209600); | mailSchedule(false, 2, 1209600); |
| </code> |
| |
| |
| ===== Erinnerungsmails ===== |
| |
| Der Teilnehmer wird mit Serienmail 1 zum ersten Fragebogen (Welle 1) eingeladen -- die Einladungen erfolgen gestaffelt, sodass a-priori nicht bekannt ist, wann der Teilnehmer den Fragebogen ausfüllt. Einen Monat nach dem Ausfüllen des ersten Fragebogen solle der Teilnehmer eine Einladung zur zweiten Erhebungswelle nach einem Monat bekommen (Serienmail 2). Falls er nicht teilnimmt, soll nach einer Woche noch ein Reminder (Serienmail 3) verschickt werden. |
| |
| In Serienmail 3 ist eingestellt, dass es sich um eine Erinnerungs-/Folgemail für Serienmail 2 handelt. |
| |
| Im Fragebogen zur ersten Erhebungswelle wir folgender PHP-Code verwendet: |
| |
| <code php> |
| mailSchedule(false, 2, strtotime('+1 month')); |
| mailSchedule(false, 3, strtotime('+1 month +1 week'), array( |
| 'status' => 'no-response' |
| )); |
</code> | </code> |