Skip to content
shakty edited this page Sep 7, 2022 · 6 revisions
  • status : complete
  • version : 7.x

Illustration

Illustration of the Consent widget

Introduction

The Consent widget displays a configurable consent form.

It adds two buttons to accept and reject the form, and optionally a button to print it out.

Usage

If the user clicks the accept button the game advances to the next step.

If the user clicks the reject button, a confirmation popup is shown. If the user confirms the rejection, he or she is then disconnected and the element with id "notAgreed" is displayed (previously hidden).

Handling consent on the server

On logic.js:

// Creates a view.
memory.view("consent");

// Save consent separately
// (note: consent remains also in the main memory database)
memory.consent.stream({ headerAdd: "consent" });

// Acting on consent.
memory.consent.on('insert', item => {
    if (item.consent) {
        console.log('Consent accepted');
    }
    else {
        console.log('Consent rejected');
    }
});

Frame

The widget must be loaded together with a frame containing the elements with the following ids:

  • "consent": the element under the accept, reject, and print consent buttons are appended.
  • "notAgreed": an element initially hidden that contains a text to display in case the user rejects the consent form.
  • "show-consent": an optional button inside the element with id "notAgreed" to display the consent form after it was rejected.

See these frame examples.

Main Options

  • showPrint: If TRUE, the print button is shown. Default: TRUE.

  • consent: An object containing text to be replaced in the page. Default: node.game.settings.CONSENT. For example:

{
    EXP_TIME: 20
}

Will be inserted in the page inside element with id "exp-time":

The experiment will last approximately <span id="exp-time"></span>.

Events

  • CONSENT_REJECTING: Emitted after the user clicked on the reject button, but before the page is updated and the user is disconnected.

  • CONSENT_REJECTED: Emitted after the user page is updated and the user is disconnected.

Usecase

// The Consent widget should be used as Widget Step.

// game/game.settings.js
// ...
CONSENT: {

  EXP_TITLE: 'Preferences for inequality',

  EXP_PURPOSE: 'The purpose of the study people\'s preferences for inequality.',

  EXP_DESCR: 'You will complete an online survey in which you will be asked to express your preferences for inequality in the US.',

  EXP_TIME: '20',

  EXP_MONEY: '$2 USD'
},
// ...

// game/client_types/player.js
stager.extendStep('consent', {
    widget: 'Consent'
});

Texts

  • areYouSure: Text on the confirmation popup before leaving the study.

  • printText: Text above the print page button.

  • printBtn: Text on the print page button.

  • consentTerms: Text above the accept/reject buttons.

  • agree: Text on the accept button.

  • notAgree: Text on the reject button.

Links

Clone this wiki locally