Inhaltsverzeichnis

mailSend()

void mailSend(string email, int mailingID, [int time], [string link], [string C1, string C2, string C3, string C4, string C5])

void mailSend(string email, int serialmailID, array settings)

The mailSend() function sends the mailing with the mailingID ID to a specified email address straightaway or at a defined point in time. The email address does not have to – in contrast to the mailResume() and mailSchedule() functions – be known in the project's address list beforehand.

Tips

Example 1

A colleague's email address should be requested in the interview, but not saved. An invitation should be sent to this email address with a reference to the current interview (case number CASE).

Note: This use case is usually easier to implement with a question of type Send Email to a Personal Contact and without any PHP code. Here only an alternative solution using mailSend() is shown.

In order to get the email address, an HTML input field is put on page 5 in the questionnaire.

<div>
  Colleague's email address:
  <input type="text" name="email_colleague" style="width: 160px" />
</div>

On the next page in the questionnaire (no later!), the specified email address is read using readGET() and the mailing with the ID 2 will be sent to this email address. The current case number is attached in the URL to the questionnaire as a reference.

$email = readGET('email_colleague', false);
if (trim($email) !== '') {
  $link = 'https://www.soscisurvey.de/PROJEKT/?r='.caseNumber();
  mailSend($email, 2, 0, $link);
}

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.

For this purpose a serial mail (ID 1) was created under Send invitationsSerial mails, which has among others the following contents.

respondents: %custom1%
Test result: %custom2%

On the last page of the questionnaire the following PHP code would now be placed under the calculation of the points value ($points) to send the result to store@example.com.

mailSend('store@example.com', 1, 0, ZERO, caseSerial(), $points);