| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| en:create:functions:mailsend [05.09.2020 13:25] – sophia.schauer | en:create:functions:mailsend [14.03.2022 13:27] – [mailSend()] walliser |
|---|
| * //C1// to //C5// (optional)\\ If you have specified text here (optional), you can use this text in the mailing with the help of placeholders ''%custom1%'' to ''%custom5%''. When used with ''value()'', you can, for example, display responses from the ongoing interview in the email. | * //C1// to //C5// (optional)\\ If you have specified text here (optional), you can use this text in the mailing with the help of placeholders ''%custom1%'' to ''%custom5%''. When used with ''value()'', you can, for example, display responses from the ongoing interview in the email. |
| * //settings// (optional)\\ If an array is passed as third parameter, the further settings are taken from this array. The following keys are possible: | * //settings// (optional)\\ If an array is passed as third parameter, the further settings are taken from this array. The following keys are possible: |
| * '''sendtime''' -- corresponds to the parameter //time// | * ''%%'sendtime'%%'' -- corresponds to the parameter //time// |
| * '''update''' -- SBy default an email is sent with every call of ''mailSend()''. If there is a value for '''update''' and an e-mail has already been scheduled for sending (not yet sent) in the survey project with ''mailSend()'', which contains the same value for '''update''', then the sending date and all data will be updated instead of preparing another e-mail. For example, if you only want to send one e-mail per interview, then use e.g. ''%%'update' => caseToken()%%''. | * ''%%'update'%%'' -- SBy default an email is sent with every call of ''mailSend()''. If there is a value for '''update''' and an e-mail has already been scheduled for sending (not yet sent) in the survey project with ''mailSend()'', which contains the same value for '''update''', then the sending date and all data will be updated instead of preparing another e-mail. For example, if you only want to send one e-mail per interview, then use e.g. ''%%'update' => caseToken()%%''. |
| * '''%link%''' -- corrsponds to the parameter //Link// | * ''%%'%link%'%%'' -- corrsponds to the parameter //Link// |
| * '''%custom1%''' to '''%custom5%''' -- Content for the placeholders of the same name in the serial mail | * ''%%'%custom1%'%%'' to '''%custom5%''' -- Content for the placeholders of the same name in the serial mail |
| * '''attach''' -- variable ID (string) or several identifiers (array) of uploaded files (question of type "upload file"), which should be attached to the e-mail. Specify a key in the array to specify the file name for the attachment. | * ''%%'attach'%%'' -- variable ID (string) or several identifiers (array) of uploaded files (question of type "upload file"), which should be attached to the e-mail. Specify a key in the array to specify the file name for the attachment. |
| | * ''%%'unique'%%'' -- Any value identifying the content and/or recipient of the message. By default, the e-mail address is used as a characteristic for sending. If a user-defined unique value is specified, the same mass mail can be sent multiple times to that email address. The precondition is that a different unique value is specified for each dispatch. |
| | |
| | |
| | |
| | |
| |
| </code> | </code> |
| |
| ===== Example2 ===== | ===== Example 2 ===== |
| |
| A respondent fills out a test, the point value was calculated in variable ''$points'' and is to be sent now together with the participant identification (SERIAL) to a Mailadresse, so that the researcher is informed automatically about terminated tests. | A respondent fills out a test, the point value was calculated in variable ''$points'' and is to be sent now together with the participant identification (SERIAL) to a Mailadresse, so that the researcher is informed automatically about terminated tests. |
