This is an old revision of the document!
void mailSchedule(string personID, int mailing, int time, [array settings])
This function prepares the sending of a mailing directly in the questionnaire – for example, the invitation to the second questionnaire. In contrast to mailResume()
, the current interview will not be resumed. Instead, the mailing is sent in the same way as if it had been prepared manually.
Note: The email will only be sent if the participant is already registered in the mailing list.
false
to resolve the ID automatically.'status
''finished
' – …opened and the questionnaire was filled out to the end'incomplete
' – …was not opened or not filled in to the end'no-response
' – …was not opened'expire
''to.email
''to.mobile
'
Note: A mailing is sent (in contrast to mailResume()
) only once per recipient, even if the function is called up repeatedly. Sending different mailings is possible – e.g. an invitation to take part in the second wave of the survey in 14 days and a further invitation to the third wave in 1 month.
Tip: There are numerous websites on the internet that can covert a date into a Unix timestamp. For example: unixtime.de. The PHP Date/Time Functions (in particular mktime()
and strtotime()
) are ideally suited to this purpose.
A participant was invited to take part in the questionnaire via a mailing. 14 days after he clicked on the link, and thus accessed the questionnaire, he should receive an invitation to the second questionnaire (mailing no. 2)
mailSchedule(false, 2, strtotime('+14 days'));
Instead of using the function strtotime()
, the time period can also be specified in seconds: 14 days = 336 hours = 1209600 seconds.
mailSchedule(false, 2, 1209600);