[[mailResume()]]
You are here: start » Overview » Creating and Designing the Questionnaire » PHP-Functions » mailResume()
 
Trace:

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
en:create:functions:mailresume [19.12.2014 23:28] – [Pause Questionnaire] alexander.ritteren:create:functions:mailresume [01.03.2015 14:00] – [mailResume()] admin
Line 1: Line 1:
 ====== mailResume() ====== ====== mailResume() ======
  
-''void **mailResume**(string //personID//, int //mailing//, int //time//, [string //C1//, string //C2//, string //C3//])''+''void **mailResume**(string //personID//, int //mailing//, int //time//, [string //C1//, string //C2//, string //C3//, string //C4//, string //C5//])''
  
 This function sends an email during the current questionnaire with a link in order to resume the questionnaire at a later point in time. This is particularly useful when combined with a specific break in multi-wave surveys (''[[:en:create:functions:buttonhide|buttonHide()]]''). This function sends an email during the current questionnaire with a link in order to resume the questionnaire at a later point in time. This is particularly useful when combined with a specific break in multi-wave surveys (''[[:en:create:functions:buttonhide|buttonHide()]]'').
Line 10: Line 10:
   * //mailing//\\ (Numerical) mailing ID which should be sent to the participant. In the tab //Reminder/Follow-up Email// for the mailing, the value must be configured to "Reminder or Continuation" as the //Type of Follow-up Email//. Please take the notes below into consideration.   * //mailing//\\ (Numerical) mailing ID which should be sent to the participant. In the tab //Reminder/Follow-up Email// for the mailing, the value must be configured to "Reminder or Continuation" as the //Type of Follow-up Email//. Please take the notes below into consideration.
   * //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.   * //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.
-  * //C1// to //C3// (optional)\\ If you enter text here (optional), you can use this in the mailing with the help of placeholders ''%custom1%'' to ''%custom3%''. When combined with ''value()'', you can even display responses from the current questionnaire in the email. +  * //C1// to //C5// (optional)\\ If you enter text here (optional), you can use this in the mailing with the help of placeholders ''%custom1%'' to ''%custom5%''. When combined with ''value()'', you can display responses from the current questionnaire in the email, for example. 
  
 ===== Tips ===== ===== Tips =====
Line 27: Line 27:
 ===== Pause Questionnaire ===== ===== Pause Questionnaire =====
  
-In the following example, the participant was invited to the questionnaire via a mailing. A page interruption is placed in the middle of the questionnaire (''[[:en:create:functions:buttonhide|buttonHide()]]'') and the text "end1" is displayed. The participant receives an email after 24 hours stating he may now fill out the second part of the questionnaire. The link in the email leads him to the next page in the previously interrupted questionnaire. +In the following example, the participant was invited to the questionnaire via a mailing. A page where the questionnaire is paused is placed in the middle of the questionnaire (''[[:en:create:functions:buttonhide|buttonHide()]]'') and the text "end1" is displayed. The participant receives an email after 24 hours stating he may now fill out the second part of the questionnaire. The link in the email leads him to the next page in the previously interrupted questionnaire. 
  
 <code php> <code php>
Line 35: Line 35:
  
 // Check how much time has elapsed since the start of the survey // Check how much time has elapsed since the start of the survey
-// If this is less than 24 hours (24 * 3600 seconds), the questionnaire is suspended+// If this is less than 24 hours (24 * 3600 seconds), the questionnaire will be paused
 if (caseTime('begin') < 24 * 3600) { if (caseTime('begin') < 24 * 3600) {
   text('end1'); // displayed at the end of the first part   text('end1'); // displayed at the end of the first part
Line 66: Line 66:
  
 // Check how much time has elapsed since the page was first accessed  // Check how much time has elapsed since the page was first accessed 
-// Suspend if this is less than than 14 days (14 * 24 * 3600 seconds)+// Pause, if this is less than than 14 days (14 * 24 * 3600 seconds)
 if (time() - $timeBreak1 < 14 * 24 * 3600) { if (time() - $timeBreak1 < 14 * 24 * 3600) {
   text('end1'); // displayed at the end of the first part   text('end1'); // displayed at the end of the first part
-  option('nextbutton', false); // hide Next button (suspend questionnaire)+  option('nextbutton', false); // hide Next button (pause questionnaire)
 } else { } else {
   // Perhaps the progress bar should be adjusted?   // Perhaps the progress bar should be adjusted?
en/create/functions/mailresume.txt · Last modified: 21.04.2024 20:27 by admin
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki