====== mailSchedule() ======

''void **mailSchedule**(string //personID//, int //mailing//, int //time//)''

This function prepares the sending of a mailing directly in the questionnaire -- for example, the invitation to the second questionnaire. In contrast to ''[[:en:create:functions:mailresume|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.

  * //personID//\\ The personal ID of the addressee who should receive the email. If the participant began the questionnaire after receiving an invitation via mailing, enter ''false'' to resolve the ID automatically.
  * //mailing//\\ (Numerical) ID of the mailing which should be sent to the participant.
  * //time//\\ Either the delay in email delivery (in seconds: maximum 153900000) __or__ a Unix timestamp, which defines the time until the next email is sent.
 
**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: [[http://www.unixtime.de/|unixtime.de]]. The PHP [[http://www.php.net/manual/en/ref.datetime.php|Date/Time Functions]] (in particular ''[[http://php.net/manual/en/function.mktime.php|mktime()]]'' and ''[[http://www.php.net/manual/en/function.strtotime.php|strtotime()]]'') are ideally suited to this purpose. 

===== Example =====

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)

<code php>
mailSchedule(false, 2, strtotime('+14 days'));
</code>

Instead of using the function ''strtotime()'', the time period can also be specified in seconds: 14 days = 336 hours = 1209600 seconds.

<code php>
mailSchedule(false, 2, 1209600);
</code>