From d0af54587ce9624ebcf3cac50390a7b54d210765 Mon Sep 17 00:00:00 2001 From: Becky Gilbert Date: Fri, 29 Sep 2023 09:46:17 -0700 Subject: [PATCH] Move develop into master (#337) * Fix documenation link in readme (#310) * fix typo in exp-lookit-stimuli-preview doc string - fixes #329 * add consent_005 and consent_garden to valid template names in video-consent frame * add consent_garden default text * add consent_garden template option and pass in variables/parameters * add consent_005 and consent_garden to template list in comments * add consent_garden to template parameter options * add missing consent_statement_text parameter to frameSchemaProperties object * add new GARDEN-specific parameters to frameSchemaProperties object * add doc file for consent_garden template * add template file for consent_garden template * fix indentation and syntax errors * fix indentation errors * fix string quotation errors * fix component name * fix issue with webcam display covering text in video-consent: remove min-height from video element * rename consent-garden component directory with correct case * fix multiple content/formatting errors and html rendering * minor changes related to default text and inserting params in template * add customization of contact section to template * add bold to video sharing level labels * allow HTML formatting in custom page header * add lab as required param, fix formatting for text variables * add lab frame parameter for consent-garden * make duration statement optional, add bool include duration parameter * add bold headings in garden-consent template for video-consent frame * fix syntax error in order to show default contact header * remove double quotes around all experiment names in consent-garden default text --------- Co-authored-by: CJ Green <44074998+okaycj@users.noreply.github.com> --- README.md | 2 +- app/components/consent-garden/doc.md | 124 ++++++++ app/components/consent-garden/template.hbs | 147 ++++++++++ .../exp-lookit-stimuli-preview/component.js | 2 +- .../exp-lookit-video-consent/component.js | 269 +++++++++++++++++- .../exp-lookit-video-consent/template.hbs | 70 +++++ app/styles/app.scss | 1 + app/styles/components/consent-garden.scss | 8 + .../components/exp-lookit-video-consent.scss | 4 + translations/en-us.yaml | 46 ++- 10 files changed, 668 insertions(+), 5 deletions(-) create mode 100644 app/components/consent-garden/doc.md create mode 100644 app/components/consent-garden/template.hbs create mode 100644 app/styles/components/consent-garden.scss diff --git a/README.md b/README.md index b46dbade..72b4719d 100644 --- a/README.md +++ b/README.md @@ -4,4 +4,4 @@ This is a small Ember application that allows both researchers to preview an exp participate in an experiment. This is meant to be used in conjunction with the [Lookit API Django project](https://github.com/lookit/lookit-api), which contains the Experimenter and Lookit applications. The Django applications will proxy to these Ember routes for previewing/participating in an experiment. -For installation instructions, please see the [Lookit documentation](https://lookit.readthedocs.io/en/develop/ember-app-installation.html). +For installation instructions, please see the [Lookit documentation](https://lookit.readthedocs.io/projects/frameplayer/en/latest/). diff --git a/app/components/consent-garden/doc.md b/app/components/consent-garden/doc.md new file mode 100644 index 00000000..54540a6e --- /dev/null +++ b/app/components/consent-garden/doc.md @@ -0,0 +1,124 @@ +# exp-lookit-video-consent: consent-GARDEN template + + +## Overview + +Video consent frame for Lookit studies, with consent document displayed at left and instructions to start recording, read a statement out loud, and send. A standard consent +document is displayed, with additional study-specific information provided by the researcher, in accordance with the Lookit terms of use. + +The consent document can be downloaded as a PDF document by the participant. + +## Formatting custom text + +You can use HTML tags in the custom text segments for additional style and formatting, e.g.`

` for section headers, `
` for line breaks, `` for bold text, `
    ` for ordered lists (numbered items), `
      ` for unordered lists (bullet-pointed items), `
    • ` for each list item. + +``` +"procedures_content": "Here is some bold text.

      Here is more text after line breaks.", +``` + +## Parameters + +The following notation is used within the default text segments: +- Curly brackets indicate a text variable inserted automatically by Lookit, e.g. {`experiment`} (the name of the study), {`duration`}. +- Square brackets indicate a text variable that comes from the frame parameters, e.g. [`institution`], [`lab`]. + +### Required + +| Parameter | Type | Description | +| -------- | -------- | -------- | +| template | String | Which consent document template to use. All GARDEN studies should use: `'consent_garden'`. | +| PIName | String | Name of PI running this study. | +| institution | String | Name of institution running this study (if ambiguous, list institution whose IRB approved the study). | +| PIContact | String | Contact information for PI or lab in case of participant questions or concerns. This will directly follow the phrase "please contact", so format accordingly: e.g., "lab@science.edu", "the XYZ lab at xyz@science.edu" or "Mary Smith at 123 456 7890". | +| lab | String | The lab name to be used in the study info section: "This is the {`experiment`} run by [`lab`] at [`institution`] as part of Project GARDEN (see: What is Project GARDEN? for more details)." | +| study_info_description | String | Brief (one-sentence) description of study to insert into the `study_info_content` default text. This description will be inserted after 'In this study, '.
      Note: if the default study info content is fully replaced via the `study_info_content` parameter, then this parameter will be ignored. | +| purpose_content | String | Brief description of the purpose of the study. | +| eligibility_content | String | Eligibility criteria. Aim for stating inclusion criteria over/more prominently than exclusion criteria when possible. Example: "Any child who is currently 3-, 4-, 5-, or 6-years-old and is able to understand English is able to participate as long as a main caregiver or parent (that is, someone who is legally able to make decisions for the child) gives permission." | +| procedures_content | String | Statement summarizing study procedures. This section always starts with a Lookit-generated duration statement: "This study takes about {`duration`} to complete.", where {`duration`} comes from the study details. (Note: if you want to omit the duration statement, set the optional `include_duration_in_procedures` parameter `false`.) | +| benefits_content | String | Statement summarizing the benefits of the research to the family (direct) or to society (e.g, parents, teachers, policy makers (indirect)). Example: "Your participation in this study can help us learn more about families and their children and how families are important to child development. Although it may take a few years for us to share our findings, you will also have the opportunity to read about the study findings yourself. Although there are no other direct benefits to participation, many children/caregivers find participating in our research enjoyable." | +| data_sharing_learn | String | Statement about what additional things might be learned from the data from this specific study, e.g., “better understand how families with 3- to 6-year-old children come from many different backgrounds, cultures, and perspectives”. This will be used to complete a sentence in the data sharing section, to explain why the data is being shared publically: "The de-identified study information will also eventually be shared with the public so other researchers can verify these findings and also see if there are other important things we can learn from the information. This will allow educators, families and other researchers to use the findings to [`data_sharing_learn`]." | +| irb_contact | String | Contact info for the research rights/IRB section. This is a string that will be appended to the end of the sentence: "If you or your child has questions or concerns about your child's rights as a research subject, or if you would like to obtain information, offer input, or report a research_related issue, you may contact: [`irb_contact`]." | + + +### Optional + +| Parameter | Type | Default | Description | +| -------- | -------- | -------- | -------- | +| include_databrary | Boolean | `false` | Whether to include a paragraph about Databrary under the video sharing and publication sections. Note that this parameter is only used if `data_collection_omit_video` is `false` (default) and `private_level_only` is `false` (default), since those parameters indicate that either no study-related video data is collected, or that the participant shouldn't have the option of sharing it. Also, if the entire video sharing section text is replaced via the `video_sharing_study` parameter, then the databrary text will NOT be automatically included in that section (but the researcher can copy the default text into the rest of their custom text). | +| summary_statement | String | `""` | Statement inserted at the beginning of the consent form, right after the intro sentence: "Researchers led by [`PIname`] at [`institution`] are running this study, "{`experiment`}," on Lookit." | +| include_duration_in_procedures | Boolean | `true` | Whether or not to include the `duration_statement` at the start of the procedures section. Set to `false` to omit the duration statement. | +| risk_content_additional | String | `""` | Additional risk statement to be added after the default text: "{experiment} only takes about {duration}, but your child may find some questions uninteresting or boring.". This parameter should be used to mention anything specific to the procedures for this study, e.g. "Your child may also not feel comfortable answering some of the questions. " (Note: if the entire risk content section text is replaced via the `risk_content` parameter, then this parameter is ignored.) | +| risk_content_discontinue_options | String | `""` | Additional study-specific discontinue options to be inserted into the default statement: "Your child may [risk_content_discontinue_options]choose to stop participating at any time." E.g. "choose to select 'prefer not to answer’ on a question or ”. If no value is given then the statment will be: "Your child may choose to stop participating at any time." (Note: if the entire risk content section text is replaced via the `risk_content` parameter, then this parameter is ignored.) | +| risk_content_breach_of_confidentiality | String | `""` | Breach of confidentiality statement, if required by your IRB. E.g. “It is possible that a breach of confidentiality may occur if Lookit is hacked, but Lookit regularly receives external security audits to prevent this and we have multiple safeguards in place to protect data security”. (Note: if the entire risk content section text is replaced via the `risk_content` parameter, then this parameter is ignored.) | +| data_collection_omit_video | Boolean | `false` | Whether or not to omit the 'Video recordings' data type form the data collection section. Default is `false`. If `true`, the section will say "There are two types of information..." (rather than "three") and only list items 1 and 2 from the default data_collection_content text. | +| include_irb_contact_statement | Boolean | `false` | Whether or not to include the following sentence in the research rights/IRB section: "A representative of the ['institution`] IRB may contact you to gather information about your experience participating in this research. Just as with the research itself, you can choose to answer or not answer any questions an IRB representative may ask you.” Default is `false`. Set this to `true` if this statement is required by your IRB. | +| irb_extra | String | `""` | Use this parameter to provide any additional institution IRB specific information here, but try to avoid redundancy with any of the default text if possible. If you include this parameter, the string will be added to the end of the research rights/IRB section. (Note: If you want this content to appear as a separate paragraph, include two line break HTML tags at the start of the string: `

      `). | +| private_level_only | Boolean | `false` | Whether to describe only the "private" video privacy level in the video sharing section. Only use this option if your IRB has a hard restriction against even offering participants the option to share their videos more broadly, and in conjunction with the corresponding restriction of options in the exit survey! If `true`, the text in the video sharing section will not contain the 'scientific and educational' or 'publicity' options (see Default text section below). | +| additional_video_privacy_statement | String | `""` | Additional text for the video sharing section. For cases where researchers ask for other specific permission to share videos, separate from the exit survey, or want to provide more detail or different language about Databrary sharing. If text is given, it will appear after all of the video sharing and databrary content. | +| additional_segments | Array | `[]` | List of JSON objects defining additional custom sections of the consent form, e.g. US Patriot Act Disclosure or child abuse reporting obligation disclosure. These are subject to Lookit approval and in general can only add information that was true anyway but that your IRB needs explicitly listed. Each JSON object in the array defines a section using the properties: `title`, the title of the section (string), and `text`, the text of the section (string). | + +### Default text and associated parameters + +This section includes the default text for each section, along with the corresponding parameter names. Each segment of default text below can be replaced with custom text by including the parameter name in your frame, along with the text string that should replace the default. The text strings can contain HTML. If you replace the default text for any of these sections, _you must write the text exactly as you want it to appear_; you can not use variables to insert information from other frame parameters or from your study details (experiment name, institution, lab, PI name, etc.). Similarly, any of the required/optional parameters listed above that are intended to modify the default text are ignored if the entire text segment is replaced using the parameters below. + +| Parameter | Default text | +| --- | ----------- | +| header | `Consent to participate in research: {experiment} for Project GARDEN` | +| intro_sentence | `Researchers led by [PI name] at [institution] are running this study, "{experiment}," on Lookit.` | +| overview_header | `We would like to invite you to participate in our study!` | +| overview_content | `As one of your child's main caregivers (legal guardians such as a parent), you are invited to participate in '{experiment}', which is part of Children Helping Science's Project GARDEN (Growing and Advancing Research in Development and EducatioN; see: What is Project GARDEN? for more details), which aims to better understand how children grow and develop in the ways that they think, learn, and understand the world around them!

      Right now you are reading the consent form, which will give you some information about this study and help you choose whether you would like to participate. After you read this information, you can decide to complete the form by following the instructions on the page. You may be invited to participate in other Project GARDEN studies later, but this consent form is only for '{experiment}'.

      We encourage people to ask questions, so please feel free to contact us by emailing us at [PIContact] if you are unsure about any part of this consent form or the study before you decide whether you would like to participate in '{experiment}'.` | +| study_info_header | `What is this study and who is running this study?` | +| study_info_content | `This is the {experiment} run by [lab] at [institution] as part of Project GARDEN (see: What is Project GARDEN? for more details). In this study, [study_info_description].` | +| purpose_header | `Why are you running this study?` | +| purpose_content | _Required - no default_ | +| eligibility_header | `Who gets to participate?` | +| eligibility_content | _Required - no default_ | +| procedures_header | `What happens during this study and how long will it take?` | +| duration_statement | `This study takes about {duration} to complete.` | +| procedures_content | _Required - no default_ | +| payment_header | `What do I receive for participating in this study?` | +| payment_content | `You will receive an $5 Amazon.com gift card (usable on the U.S. website only) as soon as possible after participating in the study (within 7 business days).` | +| benefits_header | `What are some reasons I might want to participate?` | +| benefits_content | _Required - no default_ | +| risk_header | `What are some reasons I might not want to participate?` | +| risk_content | `{experiment} only takes about {duration}, but your child may find some questions uninteresting or boring. [optional: risk_content_additional]Your child may [optional: risk_content_discontinue_options]choose to stop participating at any time. [optional: risk_content_breach_of_confidentiality] We will let you know if we become aware of any other reasons you may not want to participate in the future.` | +| data_collection_header | `What kinds of information will this study collect?` | +| data_collection_content | `"There are three types of information that are collected in this study:
      1. Personal Information, such as your name, email, and children's names & birthdays, that can be used to identify you. This also includes your Lookit account information and your consent video (where you record yourself stating you agree to participate in the study) and will never be shared outside of [institution/research lab] or Lookit.
      2. Study Information, such as choices or answers you or your child give to study questions, written descriptions of things you do during the study, or other information you give as part of participation in the study. This information will be “de-identified” and shared with other Project GARDEN researchers and eventually other child development researchers outside Project GARDEN. You can learn more about de-identifying and sharing of study information below.
      3. Video recordings, of you and/or your child interacting with any part of the study. Video recordings are a special kind of information (you can definitely identify someone from their face!), so we will give you multiple choices for how you would like us to share or not share this information. See "Who will be able to see our video recordings" for more information and your choices.
      `
      or, if `data_collection_omit_video` is `true`:
      `"There are two types of information that are collected in this study:
      1. Personal Information, such as your name, email, and children's names & birthdays, that can be used to identify you. This also includes your Lookit account information and your consent video (where you record yourself stating you agree to participate in the study) and will never be shared outside of [institution/research lab] or Lookit.
      2. Study Information, such as choices or answers you or your child give to study questions, written descriptions of things you do during the study, or other information you give as part of participation in the study. This information will be “de-identified” and shared with other Project GARDEN researchers and eventually other child development researchers outside Project GARDEN. You can learn more about de-identifying and sharing of study information below.
      "` | +| data_use_header | `What will you use this information for?` | +| data_use_content | `We will never use any of your information for any purpose other than non-profit research.

      The results of this study may be presented at scientific meetings or published in scientific journals. We may publish individual responses from your de-identified (2) study information (see “How do you make sure my privacy is protected?”), like how long your child looked at a picture or which button they decided to press, but this will only be shared in a way similar to “one of the many five-year-olds who participated chose this option during the study” or “participant number five chose this option during the study.”

      We will never share or publish personal information like your email or children's birth dates or names.` | +| data_access_header | `Who has access to this information?` | +| data_access_content | `Running studies like ours online requires a small number of specific people at two universities to have access to all three types of information. At {institution}, our research group and [institution] Institutional Review Board (IRB), which is a group that makes sure your rights are protected when you participate in research, have access. At MIT, the administrative staff who run Lookit have access. To learn more about Lookit or the [institution] IRB, please see the specific questions about them below.
      Only people approved by the [institution] Institutional Review Board (IRB) to be on this study's research team or Lookit staff will have access to your personal information. Your personal information will only be used to make sure that you agreed to the study and to contact you about this study or future Project GARDEN studies, including sending you gift cards.
      Your study information will be shared with other Project GARDEN researchers and eventually other child development researchers outside Project GARDEN, but we take multiple steps to de-identify you and protect your privacy by removing personal information before doing so.
      Your video recordings will be shared or not shared according to the option you choose at the end of the study.` | +| data_management_header | `How do you make sure that my privacy is protected with "de-identification"?` | +| data_management_content | `Your study information will be de-identified by giving you and your child a “Family ID” and removing any personal information that can be used to identify you. We can give you two examples of how this “de-identification process” works:

      Example #1: In our research spreadsheets, we will use something like “F32” or “Family 32” to identify your family/your child instead of “the Smith family” or “Jane Smith”. This de-identified study information will be placed together with other families’ de-identified study information in spreadsheets/data files.

      Example #2: If your child is 5 years old, their information will usually be described as one of many other 5 year olds in the data set, and we will report findings saying something like “five-year-olds in this study were more likely to choose option A more often than other options” or “200 families with five-year-olds were in the Southeast U.S.”.

      If you have any more questions about who has access to your information or how it will be used, please contact us using the information at the end of this consent form. We would also be happy to share examples of papers we have published before so you can see how we use this information without identifying participating families (except in cases where they chose to share their video recordings with the public).` | +| data_sharing_header | `Will you ever share my information with anyone else?` | +| data_sharing_content | `Once your study information is de-identified (see “How do you make sure my privacy is protected?”), it will be shared with other Project GARDEN researchers at other universities and will be used to write up research findings which will be shared with the public. The de-identified study information will also eventually be shared with the public so other researchers can verify these findings and also see if there are other important things we can learn from the information. This will allow educators, families and other researchers to use the findings to [data_sharing_learn].
      You will have full control over which Project GARDEN studies you do or do not wish to participate in. You are only agreeing to participate in {experiment} with this consent form.` | +| research_rights_irb_header | `What is the [institution] IRB and what does it do?` | +| research_rights_irb_content | `The Institutional Review Board (IRB) is a department at [institution] that makes sure the rights of people who participate in research are protected.
      If you or your child has questions or concerns about your child's rights as a research subject, or if you would like to obtain information, offer input, or report a research-related issue, you may contact: [irb_contact]. [optional: irb_extra].`
      or, if `include_irb_contact_statement` is `true`:
      `The Institutional Review Board (IRB) is a department at [institution] that makes sure the rights of people who participate in research are protected. A representative of the [institution] IRB may contact you to gather information about your experience participating in this research. Just as with the research itself, you can choose to answer or not answer any questions an IRB representative may ask you.
      If you or your child has questions or concerns about your child's rights as a research subject, or if you would like to obtain information, offer input, or report a research-related issue, you may contact: [irb_contact]. [optional: irb_extra].` | +| lookit_info_header | `Who is Lookit and what do they do with my information?` | +| lookit_info_content | `Lookit is a website run by a group of researchers at MIT which you are using right now to participate in this study. When you sign-up for Lookit, you provide them with information about you and your family so that they can find studies in which you can participate.

      Because Lookit only exists to help with research on the website, they do not use your information for anything except running the site and only share your information with researchers if you agree to participate in a study. The Lookit administrative team has access to all three kinds of information (video recordings, personal information, and study information) so they can check and make sure that Lookit works well for all families and researchers and make improvements to how Lookit works. Lookit stores the information on your account for as long as you keep the Lookit account, but you have the option to withdraw your information at any time.` | +| voluntary_participation_header | `What happens if I choose not to participate or change my mind about participating?` | +| voluntary_participation_content | `You and your child may choose to not participate in this study at any time. You can also change your mind at any time. If you decide to not participate or change your mind about participating later, there are no penalties and you will not lose any benefits from this research.

      If you do choose to participate, it's okay to stop at any point during the session. Please do feel free to pause, take a quick break, or stop the session if your child becomes uncomfortable, bored, or decides they no longer wish to participate!` | +| video_sharing_header | `Who will be able to see your video recordings?` +| video_sharing_consent | `At the start of the study, you will be asked to use your webcam to record yourself consenting to participate in the study. This is called your consent recording, and we will review it to confirm you agreed to be in the study and are eligible. We will never share it or use it for any other purpose.` | +| video_sharing_study | `As part of the study, you will be asked to use your webcam to record you and your child as you go through the study itself. At the end of the study, we will give you some choices about if and when we can share those recordings. These are the choices:

      • Private: "Keep my videos private": Your video recordings will only be used for this study and will not be shared with anyone else (not even with other Project GARDEN researchers).
      • Scientific and educational: "You can only share my video recordings for scientific purposes". Your video recordings can be shared for scientific or educational purposes, like showing an example in a university class, showing an example to other researchers at a scientific conference, or sharing with other Project GARDEN researchers.
      • Publicity: “You can share my video recordings with the public”. Although we will never mention your name or other personal information, your video recordings can be added to public research databases or shared with the public, for example in a news segment about the research or to recruit more participants.


      If you choose “Scientific and educational” or “publicity” sharing, you can also choose for your videos to be added to “Databrary”, which is a nonprofit video database at New York University which can only be accessed by authorized researchers like us and be used for non-profit scientific and educational purposes only. You can read more about Databrary here: https://databrary.org/about.html

      You can also choose to remove your video recordings from the study entirely in Lookit. If you do, only your consent recording will be kept and all other video recordings will be deleted.`
      or, if `private_level_only` is `true`:
      `Researchers with access to your recordings will not share them with anyone else. At the end of the session, you will have the option to withdraw your recordings. If you do, only your consent recording will be kept and all other recordings will be deleted.`| +| databrary_content | `Separately, you can opt in to give access to your recordings and other data to authorized users of the secure data library Databrary. This means that other researchers besides the ones running this study will have access to your recordings, and may be able to use them to answer other questions about child development. Data sharing can lead to faster progress in research on human development and behavior. Authorized Databrary researchers have to agree to maintain confidentiality and not use the data for commercial purposes. If you have any questions about this data-sharing library, visit Databrary or email ethics@databrary.org.` | +| publication_header | `Will you ever share my information with anyone else?` | +| publication_content | `Once your study information is de-identified (see “How do you make sure my privacy is protected?”), it will be shared with other Project GARDEN researchers at other universities and will be used to write up research findings which will be shared with the public. The de-identified study information will also eventually be shared with the public so other researchers can verify these findings and also see if there are other important things we can learn from the information. This will allow educators, families and other researchers to use the findings to better understand how executive function skills develop in children ages 3- to 6-years-old.

      You will have full control over which Project GARDEN studies you do or do not wish to participate in. You are only agreeing to participate in the {experiment} with this consent form.` | +| contact_header | `How to contact us` | +| contact_content | `This study is run by [PIName] at [institution]. If you or your child have any questions or concerns about this study, or in the very unlikely event of a research-related injury, please contact [PIContact].

      If you or your child have any questions or concerns about the Lookit platform, please contact Lookit staff at lookit@mit.edu.` | +| consent_statement_text | `I have read and understand the consent document. I am this child's parent or legal guardian and we both agree to participate in this study.` | + + +## Data collected +---------------- + +The fields added specifically for this frame type are: + +- consentFormText: the exact text shown in the consent document during this frame + +## Events recorded +---------------- + +The events recorded specifically by this frame are: + +- downloadConsentForm: When participant downloads consent form \ No newline at end of file diff --git a/app/components/consent-garden/template.hbs b/app/components/consent-garden/template.hbs new file mode 100644 index 00000000..a523fe1d --- /dev/null +++ b/app/components/consent-garden/template.hbs @@ -0,0 +1,147 @@ +
      + + {{!-- header --}} + {{#if header}} {{exp-format header}} {{else}} {{t "consent-garden.header" experiment=experiment.name htmlSafe=true }} {{/if}} + +
      + +
      + \ No newline at end of file diff --git a/app/components/exp-lookit-stimuli-preview/component.js b/app/components/exp-lookit-stimuli-preview/component.js index 50c0d7d9..84ae34d9 100644 --- a/app/components/exp-lookit-stimuli-preview/component.js +++ b/app/components/exp-lookit-stimuli-preview/component.js @@ -8,7 +8,7 @@ import { computed } from '@ember/object'; import { videoAssetOptions, imageAssetOptions, audioAssetOptions } from '../../mixins/expand-assets'; /* - * A frame that to explain any blinding procedures to parents, and offer them the option to preview stimuli before the study. Two buttons allow the user to move forward: one goes to the next frame (if the parent wants to preview stimuli), and one skips the next frame and goes to the one after that (if the parent declins). Therefore, this frame should be followed by an {{#crossLink "Exp-video-preview"}}{{/crossLink}} frame. + * A frame that can be used to explain any blinding procedures to parents, and offer them the option to preview stimuli before the study. Two buttons allow the user to move forward: one goes to the next frame (if the parent wants to preview stimuli), and one skips the next frame and goes to the one after that (if the parent declins). Therefore, this frame should be followed by an {{#crossLink "Exp-video-preview"}}{{/crossLink}} frame. */ export default ExpFrameBaseComponent.extend(VideoRecord, ExpandAssets, { diff --git a/app/components/exp-lookit-video-consent/component.js b/app/components/exp-lookit-video-consent/component.js index 8cfbbd67..b5cf0466 100644 --- a/app/components/exp-lookit-video-consent/component.js +++ b/app/components/exp-lookit-video-consent/component.js @@ -27,6 +27,10 @@ Researchers can select from the following named templates: * `consent_004`: Same as consent_003 except that sentences in 'Data collection and webcam recording' are rearranged to make it clearer what happens if you withdraw video data, and the prompt says to read "out loud (or in ASL)" instead of just "out loud" for accessibility. +* `consent_005`: A reworked and simplified template that fixes a lot of mildly confusing sentences. Adds a separate risk_statement to separate information about procedures, risks, and compensation/benefits. + +* `consent_garden`: For Project GARDEN studies only. + Important: To look up the exact text of each consent template for your IRB protocol, and to understand the context for each piece of text to be inserted, please see https://github.com/lookit/research-resources/tree/master/Legal The consent document can be downloaded as PDF document by participant. @@ -335,12 +339,273 @@ export default ExpFrameBaseComponent.extend(VideoRecord, { default: '' }, + consent_statement_text: { + type: 'string', + description: 'Custom text for the consent statement to be read aloud.', + default: '' + }, + template: { type: 'string', - enum: ['consent_001', 'consent_002', 'consent_003', 'consent_004', 'consent_005'], + enum: ['consent_001', 'consent_002', 'consent_003', 'consent_004', 'consent_005', 'consent_garden'], description: 'Which consent document template to use', default: 'consent_001' + }, + + // GARDEN template parameters + lab: { + type: 'string', + description: 'GARDEN only: Name of lab running this study' + }, + + study_info_description: { + type: 'string', + description: 'GARDEN only: Brief (one-sentence) description of study to insert into the study_info_content default text.' + }, + + purpose_content: { + type: 'string', + description: 'GARDEN only: Brief description of the purpose of the study. ' + }, + + eligibility_content: { + type: 'string', + description: 'GARDEN only: Eligibility criteria.' + }, + + include_duration_in_procedures: { + type: 'boolean', + default: true, + description: 'GARDEN only: Whether or not to include the duration statement at the start of the procedures section.' + }, + + procedures_content: { + type: 'string', + description: 'GARDEN only: Statement summarizing study procedures.' + }, + + benefits_content: { + type: 'string', + description: 'GARDEN only: Statement summarizing the benefits of the research to the family or to society.' + }, + + data_sharing_learn: { + type: 'string', + description: 'GARDEN only: Statement about what additional things might be learned from the data from this specific study.' + }, + + irb_contact: { + type: 'string', + description: 'GARDEN only: Contact info for the research rights/IRB section.' + }, + + risk_content_additional: { + type: 'string', + description: 'GARDEN only: Additional risk statement to be added after the default text' + }, + + risk_content_discontinue_options: { + type: 'string', + description: 'GARDEN only: Additional study-specific discontinue options to be inserted into the default statement.' + }, + + risk_content_breach_of_confidentiality: { + type: 'string', + description: 'GARDEN only: Breach of confidentiality statement, if required by your IRB.' + }, + + data_collection_omit_video: { + type: 'boolean', + default: false, + description: 'GARDEN only: Whether or not to omit the video recordings data type form the data collection section.' + }, + + include_irb_contact_statement: { + type: 'boolean', + default: false, + description: 'GARDEN only: Whether or not to include the "IRB may contact you" sentence in the research rights/IRB section.' + }, + + irb_extra : { + type: 'string', + description: 'GARDEN only: Use this parameter to provide any additional institution IRB specific information.' + }, + + header: { + type: 'string', + description: 'GARDEN only: Custom header.' + }, + + intro_sentence: { + type: 'string', + description: 'GARDEN only: Custom intro sentence' + }, + + overview_header: { + type: 'string', + description: 'GARDEN only: Custom overview header.' + }, + + overview_content: { + type: 'string', + description: 'GARDEN only: Custom overview content.' + }, + + study_info_header: { + type: 'string', + description: 'GARDEN only: Custom study info header.' + }, + + study_info_content: { + type: 'string', + description: 'GARDEN only: Custom study info content.' + }, + + eligibility_header : { + type: 'string', + description: 'GARDEN only: Custom eligibility header.' + }, + + duration_statement: { + type: 'string', + description: 'GARDEN only: Custom duration statement.' + }, + + payment_header: { + type: 'string', + description: 'GARDEN only: Custom payment header.' + }, + + payment_content: { + type: 'string', + description: 'GARDEN only: Custom payment content.' + }, + + risk_content: { + type: 'string', + description: 'GARDEN only: Custom risk content.' + }, + + data_collection_header: { + type: 'string', + description: 'GARDEN only: Custom data collection header.' + }, + + data_collection_content: { + type: 'string', + description: 'GARDEN only: Custom data collection content.' + }, + + data_use_header: { + type: 'string', + description: 'GARDEN only: Custom data use header.' + }, + + data_use_content: { + type: 'string', + description: 'GARDEN only: Custom data use content.' + }, + + data_access_header: { + type: 'string', + description: 'GARDEN only: Custom data access header.' + }, + + data_access_content: { + type: 'string', + description: 'GARDEN only: Custom data access content.' + }, + + data_management_header: { + type: 'string', + description: 'GARDEN only: Custom data management header.' + }, + + data_management_content: { + type: 'string', + description: 'GARDEN only: Custom data management content.' + }, + + data_sharing_header: { + type: 'string', + description: 'GARDEN only: Custom data sharing header.' + }, + + data_sharing_content: { + type: 'string', + description: 'GARDEN only: Custom data sharing content.' + }, + + research_rights_irb_header: { + type: 'string', + description: 'GARDEN only: Custom Research Rights / IRB header.' + }, + + research_rights_irb_content: { + type: 'string', + description: 'GARDEN only: Custom Research Rights / IRB content.' + }, + + lookit_info_header: { + type: 'string', + description: 'GARDEN only: Custom Lookit Info header.' + }, + + lookit_info_content: { + type: 'string', + description: 'GARDEN only: Custom Lookit Info content.' + }, + + voluntary_participation_header: { + type: 'string', + description: 'GARDEN only: Custom voluntary participation header.' + }, + + voluntary_participation_content: { + type: 'string', + description: 'GARDEN only: Custom voluntary participation content.' + }, + + video_sharing_header: { + type: 'string', + description: 'GARDEN only: Custom video sharing header.' + }, + + video_sharing_consent: { + type: 'string', + description: 'GARDEN only: Custom video sharing consent content.' + }, + + video_sharing_study: { + type: 'string', + description: 'GARDEN only: Custom video sharing study content.' + }, + + databrary_content: { + type: 'string', + description: 'GARDEN only: Custom databrary content.' + }, + + publication_header: { + type: 'string', + description: 'GARDEN only: Custom publication header.' + }, + + publication_content: { + type: 'string', + description: 'GARDEN only: Custom publication content.' + }, + + contact_header : { + type: 'string', + description: 'GARDEN only: Custom contact header.' + }, + + contact_content: { + type: 'string', + description: 'GARDEN only: Custom contact content.' } + }, frameSchemaRequired: ['PIName', 'institution', 'PIContact', 'purpose', 'procedures', 'payment', 'template'], @@ -369,7 +634,7 @@ export default ExpFrameBaseComponent.extend(VideoRecord, { didInsertElement() { this._super(...arguments); - let validTemplateNames = ['consent_001', 'consent_002', 'consent_003', 'consent_004']; + let validTemplateNames = ['consent_001', 'consent_002', 'consent_003', 'consent_004', 'consent_005', 'consent_garden']; if (!validTemplateNames.includes(this.get('template'))) { console.warn('Invalid consent form specified. \'template\' parameter of \'exp-lookit-video-consent\' frame should be one of: ' + validTemplateNames.join(' ')); } diff --git a/app/components/exp-lookit-video-consent/template.hbs b/app/components/exp-lookit-video-consent/template.hbs index 6d2cb372..681414db 100644 --- a/app/components/exp-lookit-video-consent/template.hbs +++ b/app/components/exp-lookit-video-consent/template.hbs @@ -111,6 +111,76 @@ @omit_injury_phrase={{omit_injury_phrase}} /> + {{else if (eq template "consent_garden")}} + + + {{/if}} diff --git a/app/styles/app.scss b/app/styles/app.scss index 69f1bbca..f83ec297 100644 --- a/app/styles/app.scss +++ b/app/styles/app.scss @@ -24,6 +24,7 @@ @import "components/exp-lookit-start-stop-recording"; @import "components/exp-lookit-instruction-video"; @import "components/exp-lookit-survey-consent"; +@import "components/consent-garden"; #experiment-player { font-size: large; diff --git a/app/styles/components/consent-garden.scss b/app/styles/components/consent-garden.scss new file mode 100644 index 00000000..051bfd1f --- /dev/null +++ b/app/styles/components/consent-garden.scss @@ -0,0 +1,8 @@ +.exp-lookit-video-consent { + + h2 { + font-size: large; + font-weight: 900; + } + +} diff --git a/app/styles/components/exp-lookit-video-consent.scss b/app/styles/components/exp-lookit-video-consent.scss index 573dbc02..9332c9ae 100644 --- a/app/styles/components/exp-lookit-video-consent.scss +++ b/app/styles/components/exp-lookit-video-consent.scss @@ -139,6 +139,10 @@ width: 20% !important; } + video.pipeNormal { + min-height: unset !important; + } + [id^=pipeMenu] { width: 100% !important; margin: auto; diff --git a/translations/en-us.yaml b/translations/en-us.yaml index 75bb52b2..133a080c 100644 --- a/translations/en-us.yaml +++ b/translations/en-us.yaml @@ -123,7 +123,7 @@ consent-template-5: video-privacy-publicity-description: Researchers with access to your recordings may also share them for publicity, for instance in a news segment about the research or to recruit more participants. video-privacy-withdraw: You will also have the option to withdraw your recordings. If you do, only your consent recording will be kept and all other recordings will be deleted. video-privacy-withdraw-private-only: At the end of the session, you will have the option to withdraw your recordings. If you do, only your consent recording will be kept and all other recordings will be deleted. - databrary: Separately, you can opt in to give access to your recordings and other data to authorized users of the secure data library Databrary. This means that other researchers besides the ones running this study will have access to your recordings, and may be able to use them to answer other questions about child development. Data sharing can lead to faster progress in research on human development and behavior. Authorized Databrary researchers have to agree to maintain confidentiality and not use the data for commercial purposes. If you have any questions about this data-sharing library, visit Databrary or email ethics@databrary.org. + databrary: Separately, you can opt in to give access to your recordings and other data to authorized users of the secure data library Databrary. This means that other researchers besides the ones running this study will have access to your recordings, and may be able to use them to answer other questions about child development. Data sharing can lead to faster progress in research on human development and behavior. Authorized Databrary researchers have to agree to maintain confidentiality and not use the data for commercial purposes. If you have any questions about this data-sharing library, visit Databrary or email ethics@databrary.org. data-use-researchers-header: How we use your data data-use-researchers-content-1: If you participate in this study, we (the research group led by {name} at {institution}) will have access to data-use-researchers-item-1: webcam recordings and other data collected during this session @@ -143,6 +143,50 @@ consent-template-5: contact-statement-1: This study is run by {name} at {institution}. If {only_adult, select, true {you} other {you or your child}} have any questions or concerns about this study, {omit_injury, select, true {} other {or in the very unlikely event of a research-related injury,}} please contact {contact}. contact-statement-2: If {only_adult, select, true {you} other {you or your child}} have any questions or concerns about the Lookit platform, please contact Lookit staff at lookit@mit.edu. +consent-garden: + header: "Consent to participate in research: {experiment} for Project GARDEN" + intro-sentence: Researchers led by {name} at {institution} are running this study, {experiment}, on Lookit. + overview-header: We would like to invite you to participate in our study! + overview-content: As one of your child's main caregivers (legal guardians such as a parent), you are invited to participate in {experiment}, which is part of Children Helping Science's Project GARDEN (Growing and Advancing Research in Development and EducatioN; see What is Project GARDEN? for more details), which aims to better understand how children grow and develop in the ways that they think, learn, and understand the world around them!

      Right now you are reading the consent form, which will give you some information about this study and help you choose whether you would like to participate. After you read this information, you can decide to complete the form by following the instructions on the page. You may be invited to participate in other Project GARDEN studies later, but this consent form is only for {experiment}.

      We encourage people to ask questions, so please feel free to contact us by emailing us at {contact} if you are unsure about any part of this consent form or the study before you decide whether you would like to participate in {experiment}. + study-info-header: What is this study and who is running this study? + study-info-content: This is the {experiment} study run by {lab} at {institution} as part of Project GARDEN (see What is Project GARDEN? for more details). In this study, {description}. + purpose-header: Why are you running this study? + eligibility-header: Who gets to participate? + procedures-header: What happens during this study and how long will it take? + duration-statement: This study takes about {duration} to complete. + payment-header: What do I receive for participating in this study? + payment-content: You will receive an $5 Amazon.com gift card (usable on the U.S. website only) as soon as possible after participating in the study (within 7 business days). + benefits-header: What are some reasons I might want to participate? + risk-header: What are some reasons I might not want to participate? + risk-content-1: '{experiment} only takes about {duration}, but your child may find some questions uninteresting or boring. ' + risk-content-2: 'Your child may {risk_content_discontinue_options}choose to stop participating at any time. ' + risk-content-3: We will let you know if we become aware of any other reasons you may not want to participate in the future. + data-collection-header: What kinds of information will this study collect? + data-collection-content: "There are {omit_video, select, true {two} other {three}} types of information that are collected in this study:

      1. Personal Information, such as your name, email, and children's names & birthdays, that can be used to identify you. This also includes your Lookit account information and your consent video (where you record yourself stating you agree to participate in the study) and will never be shared outside of {institution} or Lookit.
      2. Study Information, such as choices or answers you or your child give to study questions, written descriptions of things you do during the study, or other information you give as part of participation in the study. This information will be “de-identified” and shared with other Project GARDEN researchers and eventually other child development researchers outside Project GARDEN. You can learn more about de-identifying and sharing of study information below.
      3. {omit_video, select, true {} other {
      4. Video recordings, of you and/or your child interacting with any part of the study. Video recordings are a special kind of information (you can definitely identify someone from their face!), so we will give you multiple choices for how you would like us to share or not share this information. See “Who will be able to see our video recordings” for more information and your choices.
      5. }}
      " + data-use-researchers-header: What will you use this information for? + data-use-researchers-content: We will never use any of your information for any purpose other than non-profit research.

      The results of this study may be presented at scientific meetings or published in scientific journals. We may publish individual responses from your de-identified (2) study information (see “How do you make sure my privacy is protected?”), like how long your child looked at a picture or which button they decided to press, but this will only be shared in a way similar to “one of the many five-year-olds who participated chose this option during the study” or “participant number five chose this option during the study.”

      We will never share or publish personal information like your email or children's birth dates or names. + data-access-header: Who has access to this information? + data-access-content: Running studies like ours online requires a small number of specific people at two universities to have access to all three types of information. At {institution}, our research group and {institution} Institutional Review Board (IRB), which is a group that makes sure your rights are protected when you participate in research, have access. At MIT, the administrative staff who run Lookit have access. To learn more about Lookit or the {institution} IRB, please see the specific questions about them below.

      Only people approved by the {institution} Institutional Review Board (IRB) to be on this study's research team or Lookit staff will have access to your personal information. Your personal information will only be used to make sure that you agreed to the study and to contact you about this study or future Project GARDEN studies, including sending you gift cards.

      Your study information will be shared with other Project GARDEN researchers and eventually other child development researchers outside Project GARDEN, but we take multiple steps to de-identify you and protect your privacy by removing personal information before doing so.

      Your video recordings will be shared or not shared according to the option you choose at the end of the study. + data-management-header: 'How do you make sure that my privacy is protected with "de-identification"?' + data-management-content: 'Your study information will be de-identified by giving you and your child a “Family ID” and removing any personal information that can be used to identify you. We can give you two examples of how this “de-identification process” works:

      Example #1: In our research spreadsheets, we will use something like “F32” or “Family 32” to identify your family/your child instead of “the Smith family” or “Jane Smith”. This de-identified study information will be placed together with other families’ de-identified study information in spreadsheets/data files.

      Example #2: If your child is 5 years old, their information will usually be described as one of many other 5 year olds in the data set, and we will report findings saying something like “five-year-olds in this study were more likely to choose option A more often than other options” or “200 families with five-year-olds were in the Southeast U.S.”.

      If you have any more questions about who has access to your information or how it will be used, please contact us using the information at the end of this consent form. We would also be happy to share examples of papers we have published before so you can see how we use this information without identifying participating families (except in cases where they chose to share their video recordings with the public).' + data-sharing-header: Will you ever share my information with anyone else? + data-sharing-content: Once your study information is de-identified (see “How do you make sure my privacy is protected?”), it will be shared with other Project GARDEN researchers at other universities and will be used to write up research findings which will be shared with the public. The de-identified study information will also eventually be shared with the public so other researchers can verify these findings and also see if there are other important things we can learn from the information. This will allow educators, families and other researchers to use the findings to {data_sharing_learn}.

      You will have full control over which Project GARDEN studies you do or do not wish to participate in. You are only agreeing to participate in {experiment} with this consent form. + research-rights-irb-header: What is the {institution} IRB and what does it do? + research-rights-irb-content: "The Institutional Review Board (IRB) is a department at {institution} that makes sure the rights of people who participate in research are protected. {include_irb_contact_statement, select, true {A representative of the IRB may contact you to gather information about your experience participating in this research. Just as with the research itself, you can choose to answer or not answer any questions an IRB representative may ask you.} other {}}

      If you or your child has questions or concerns about your child's rights as a research subject, or if you would like to obtain information, offer input, or report a research-related issue, you may contact: {irb_contact}. {irb_extra}" + lookit-info-header: Who is Lookit and what do they do with my information? + lookit-info-content: Lookit is a website run by a group of researchers at MIT which you are using right now to participate in this study. When you sign-up for Lookit, you provide them with information about you and your family so that they can find studies in which you can participate.

      Because Lookit only exists to help with research on the website, they do not use your information for anything except running the site and only share your information with researchers if you agree to participate in a study. The Lookit administrative team has access to all three kinds of information (video recordings, personal information, and study information) so they can check and make sure that Lookit works well for all families and researchers and make improvements to how Lookit works. Lookit stores the information on your account for as long as you keep the Lookit account, but you have the option to withdraw your information at any time. + voluntary-participation-header: What happens if I choose not to participate or change my mind about participating? + voluntary-participation-content: "You and your child may choose to not participate in this study at any time. You can also change your mind at any time. If you decide to not participate or change your mind about participating later, there are no penalties and you will not lose any benefits from this research.

      If you do choose to participate, it's okay to stop at any point during the session. Please do feel free to pause, take a quick break, or stop the session if your child becomes uncomfortable, bored, or decides they no longer wish to participate!" + video-sharing-header: Who will be able to see my video recordings? + video-sharing-consent: At the start of the study, you will be asked to use your webcam to record yourself consenting to participate in the study. This is called your consent recording, and we will review it to confirm you agreed to be in the study and are eligible. We will never share it or use it for any other purpose. + video-sharing-study-all: 'As part of the study, you will be asked to use your webcam to record you and your child as you go through the study itself. At the end of the study, we will give you some choices about if and when we can share those recordings. These are the choices:

      • Private: "Keep my videos private": Your video recordings will only be used for this study and will not be shared with anyone else (not even with other Project GARDEN researchers).
      • Scientific and educational: "You can only share my video recordings for scientific purposes". Your video recordings can be shared for scientific or educational purposes, like showing an example in a university class, showing an example to other researchers at a scientific conference, or sharing with other Project GARDEN researchers.
      • Publicity: “You can share my video recordings with the public”. Although we will never mention your name or other personal information, your video recordings can be added to public research databases or shared with the public, for example in a news segment about the research or to recruit more participants.
      If you choose “Scientific and educational” or “publicity” sharing, you can also choose for your videos to be added to “Databrary”, which is a nonprofit video database at New York University which can only be accessed by authorized researchers like us and be used for non-profit scientific and educational purposes only. You can read more about Databrary here: https://databrary.org/about.html

      You can also choose to remove your video recordings from the study entirely in Lookit. If you do, only your consent recording will be kept and all other video recordings will be deleted.' + video-sharing-study-private: Researchers with access to your recordings will not share them with anyone else. At the end of the session, you will have the option to withdraw your recordings. If you do, only your consent recording will be kept and all other recordings will be deleted. + databrary-content: Separately, you can opt in to give access to your recordings and other data to authorized users of the secure data library Databrary. This means that other researchers besides the ones running this study will have access to your recordings, and may be able to use them to answer other questions about child development. Data sharing can lead to faster progress in research on human development and behavior. Authorized Databrary researchers have to agree to maintain confidentiality and not use the data for commercial purposes. If you have any questions about this data-sharing library, visit Databrary or email ethics@databrary.org. + publication-header: Will you ever share my information with anyone else? + publication-content: Once your study information is de-identified (see “How do you make sure my privacy is protected?”), it will be shared with other Project GARDEN researchers at other universities and will be used to write up research findings which will be shared with the public. The de-identified study information will also eventually be shared with the public so other researchers can verify these findings and also see if there are other important things we can learn from the information. This will allow educators, families and other researchers to use the findings to better understand how executive function skills develop in children ages 3- to 6-years-old.

      You will have full control over which Project GARDEN studies you do or do not wish to participate in. You are only agreeing to participate in the {experiment} study with this consent form. + contact-header: How to contact us + contact-content: This study is run by {name} at {institution}. If you or your child have any questions or concerns about this study, or in the very unlikely event of a research-related injury, please contact {contact}.

      If you or your child have any questions or concerns about the Lookit platform, please contact Lookit staff at lookit@mit.edu. + exp-lookit-observation: Hide: Hide Show: Show