ORSEE3

In Options/Public content you can edit the lab-specific content on the Welcome (mainpage_welcome), the Rules (rules), the Privacy Policy (privacy_policy), the Imprint (impressum), the Contact page (contact) and the Temporarily Closed page (error_temporary_disabled) in the public area, as well as the Welcome page in the experimenter area (admin_mainpage). The overview page lists the content name and the content itself in the installed languages. Following the 'edit' links you may change the content. Note, that you are allowed to use HTML tags to format the content.

The Options/Email templates page allows you to edit the texts for all templates for emails sent by the system, including the default email text for experiment invitations. You are asked to provide the template texts for all languages installed.

When you access Options/Email templates, you will see a list of all email texts in all installed languages. To change a text, follow the respective Edit link on the right. In the texts you may use some variables explained below. All variables are enclosed by '#'.

In all emails to participants, you may use the value of their respective participant form fields (see section Participant profile form). To do so, enclose the mysql_column_name of that field with '#' (e.g. #fname#, #lname#, #field_of_studies#).

The currently used email templates are:

• admin_calendar_mailtext: The body text of the regular PDF calendar email sent to experimenters.

• admin_mail_footer: A footer which will be be attached to all e-mails sent to administrators/experimenters.

• admin_participant_statistics_mailtext: The text before the statistics listing in the regular subject pool statistics email sent to experimenters.

• admin_registration_notice: The text for the email sent to experimenters when the enrolment period for their experiment session has expired. Variables:
  • #experiment_name#: the internal name of the experiment,
  • #session_name#: the date and time of the session concerned,
  • #status#: the registration status (enough or not enough?),
  • #registered#: the number of registered participants for that session,
  • #needed#: the number of needed participants,
  • #reserve#: the number of reserve participants.

• admin_session_reminder_notice: The e-mail text for notices to experimenters that the session reminder e-mail was sent to enrolled subjects. Variables: subject variables as discussed above, and
  • #experiment_name#: the internal name of the experiment,
  • #session_name#: the date and time of the session,
  • #nr_participants#: the number of registered participants,
  • #disclaimer#: possibly empty, an explanation why the session reminder e-mail was not sent if it wasn't (e.g. too few registered participants).

• default_invitation_internet: Invitation email template for internet experiments. Currently not used in ORSEE, but might be used in later versions. You can create different versions of the default for different “external experiment types” - see below this list.

• default_invitation_laboratory: Invitation email template for laboratory experiments. You can create different versions of the default for different “external experiment types” - see below this list. Variables:
  • #sessionlist#: the list of experiment sessions to which the subject is invited,
  • #link#: a link to the subject's session enrollment page.

• default_invitation_online-survey: Invitation email template for online surveys. Currently not used in ORSEE, but might be used in later versions. You can create different versions of the default for different “external experiment types” - see below this list.

• public_experiment_enrolment_cancellation: If the feature to allow subjects to cancel their enrollments by themselves is enabled, this is the email that will be send to confirm a session enrollment cancellation. Variables: subject variables as discussed above, and
  • #experiment#: the public name of the experiment,
  • #session#: the date and time of the session,
  • #lab_name#: the name of the laboratory where the session will be conducted,
  • #lab_address#: the address of the laboratory.

• public_experiment_registration: A confirmation email sent when a participant has enrolled for an experiment session. Variables: subject variables as discussed above, and
  • #experiment#: the public name of the experiment,
  • #session#: the date and time of the session,
  • #lab_name#: the name of the laboratory where the session will be conducted,
  • #lab_address#: the address of the laboratory.

• public_mail_footer: A footer which will be attached to all e-mails which are sent to registered participants. Variables: subject variables as discussed above, and
  • #enrolment_link#: a link to the session enrolment page for the participant,
  • #edit_link#: a link to the personal data edit page for the participant.

• public_noshow_warning: The text of the warning message sent to participants who did not show up for a session they had registered for. Variables: subject variables as discussed above, and
  • #experiment_name#: the public name of the experiment,
  • #session_date#: the date and time of the session,
  • #lab_name#: the name of the laboratory where the session will be conducted,
  • #lab_address#: the address of the laboratory,
  • #number_noshowup#: the number of no-shows of this participant,
  • #max_noshows#: the number of no-shows after which a participant will be automatically excluded from further registrations.

• public_participant_exclusion: The e-mail informing participants that they are automatically excluded from further registrations for experiments. Variables: subject variables as discussed above, and
  • #number_noshowup#: the number of times the participant has not shown up.

• public_password_reset: The text of the e-mail that is send to the subject's email address when the subject requested a password reset. This is only used when the subject authentication method is username/password (see also section Subject authentication). Variables: subject variables as discussed above, and
• #email#: the email address of the subject,
• #password_reset_link#: the link to reset the password.

• public_session_reminder: The text of the session reminder e-mail. Variables: subject variables as discussed above, and
  • #experiment_name#: the public name of the experiment,
  • #session_date#: the date and time of the session,
  • #lab_name#: the name of the laboratory where the session will be conducted,
  • #lab_address#: the address of the laboratory.

• public_system_registration: The e-mail which will be sent when a subject has registered in the system. It includes a request to confirm the registration.The public_mail_footer will not be attached to this type of email. Variables: subject variables as discussed above, and
  • #invitations#: the type of experiments the subject has subscribed to,
  • #registration_link#: the link which the subject should follow to confirm her registration.

From ORSEE 3.1.1: Experiment invitation email templates (default_invitation_xx) are based on “internal” experiment types: laboratory, internet, online-survey. If needed, you can tailor the invitation email template to “external experiment types” (which are user-created and linked to an internal experiment type). To do so, just create a new email template (you may need to assign yourself the right to do so in Options/User rights) and name it default_invitation_IntExpType_ExtExpTypeID.

For example, say you created an external experiment type “Eye-tracking experiment” which is of internal experiment type “laboratory”, but you want to have a different email template for these kinds of experiments. Then:

• Look up the external experiment type id of this type of experiment (see first column in the overview table under Options/Experiment types). Let's say that id is “4”.
• Create a new email template named default_invitation_laboratory_4.

From now on, this template will be used as default email invitation text for invitation emails for this type of experiments.

Technically, when ORSEE loads the invitation email page and no email text exists, then it first looks if it can find the template default_invitation_IntExpType_ExtExpTypeID. If it cannot find such a template, it will load default_invitation_IntExpType.

Frequently Asked Questions sections (FAQs) are commonly used to reduce the email support traffic to users. The FAQs and their answers you create in section Options/FAQs are shown in the FAQ section at the public area of ORSEE.

The overview shows the questions in all languages, and the number of persons who voted that this FAQ answered their question. In the public area the questions are sorted by this criterium. On the creation/edit page for a FAQ you simply fill in the question and the answer to it, for all languages installed.