DoSomething Campaign Group - DoSomething/legacy-website GitHub Wiki

The Campaign Collection (machine name campaign_group) is a content type which contains multiple Campaign nodes, referred to as "children" or "child Campaigns" in this documentation. These Campaign nodes are stored in the field_campaigns EntityReference field.

Campaign Collections can collect Signups like a standard Campaign, and may also collect Pre-Signups, in order to broadcast communicatications to interested members.

Signups

Signups for a Campaign Group are collected based on whether or not the field_display_signup_form field is checked.

NOTE Future versions of this module will remove this toggle, as we'll use Taxonomy Terms and other custom Entities to handle collections which do not require signups.

Automatic Parent Signup

Whether to create an additional Signup for the Campaign Group upon signing up for a child Campaign.

See dosomething_signup_entity_insert.

Checked

Examples of this are The Hunt or Grandparents Gone Wired. By signing up for one of these Groups' child campaigns, you should also be signed up for the Campaign Group, in order to receive broadcasts specific to the Group (the messaging would apply to all of its children's campaigns).

Unchecked

This is useful when a Campaign may be included of a Campaign Group, but does not exist specifically as a child of the Campaign Group. e.g. "Bully Text" is a campaign which has been around for a long time, and we build a Campaign Group for a celebrity to include it. Signing up for Bully Text should not necessarily sign you up for the Celebrity Campaign Group which includes it.

Post Signup

The post signup fields will be displayed in the Campaign Group template if the User has already signed up (regardless of Launched or Pre-Launch state).

Pre-Launch

A Campaign Collection is considered to be in a Pre-Launch state if there are no published Campaign nodes defined in the field_campaigns field. In this state:

• The Signup Form, if set to display, will collect Pre-Signups records into the dosomething_signup_presignup table.
  • Writing a presignup does not opt-in the user to any third-party communications, this is done manually by the communications/data team if needed.
• The Prelaunch Title and Copy fields will be displayed in the Campaign Group template.

Launch

A Campaign Collection is considered to have launched if at least one published Campaign exists in the field_campaigns field.

Additional fields

• Intro Header/Copy/Image
• FAQ
• Scholarship Amount
• Additional Header/Copy/Image
• A Gallery