User Stories: Volunteer Platforms

This article provides users stories to explain how volunteers and organizations interact with Double the Donation and your volunteer integration.

Testing Personas

The following user stories refer to the following testing personas:

  • Emma: Nonprofit client organization user with administrative access to the nonprofit's instance in the partner platform. 
  • Thomas: Volunteer registering for a volunteer shift.

User Stories: Activate Double the Donation Integration

Emma

Title: Emma should be able to activate an integration with her Double the Donation account

User value: As Emma I want to activate Double the Donation in my volunteer management platform so that my volunteers can discover volunteer grant and PTO programs

Acceptance Criteria:

GIVEN when I believe I have a Double the Donation Volunteering account

WHEN I enter my Double the Donation public and private API keys into the appropriate fields

THEN I am presented with a message indicating that activation was successful

OR THEN I am presented with a message indicating that my activation was not successful, including a reason why, and asking me to either verify that my keys are correct (DTD Support) or inquire to purchase an account

Dev Notes: Reference “Activate Double the Donation” → “Verify 360MatchPro Keys”

User Stories: Online Volunteer Registrations

Emma

Title: Emma should be able to add Double the Donation to and remove Double the Donation from all applicable volunteer registration forms

User value: As Emma I want to add Double the Donation to all my volunteer registration forms so I can discover where my volunteers work and my volunteers can discover their eligibility for volunteer incentive programs offered by their employer

Acceptance criteria:

GIVEN I have successfully activated Double the Donation

WHEN I edit my global registration form features and indicate that Double the Donation should be activated globally

THEN I am presented with a confirmation message

AND THEN Double the Donation volunteer plugin appears on all existing and future volunteer registration forms

NOTE: This user story is only applicable if global online registration form settings exist within the partner platform.


Title: Emma should be able to individually add and remove Double the Donation Volunteering to/from some registration forms and not others

User value: As Emma I want to add Double the Donation Volunteering to some of my registration forms so that I can target volunteer PTO and volunteer grants to only some campaigns

Acceptance Criteria: 

GIVEN I have successfully activated Double the Donation

WHEN I edit individual registration form settings/design for a new or existing registration form that does not currently have Double the Donation Volunteering activated

THEN I am presented with the option to enable Double the Donation Volunteering

AND THEN if I enable Double the Donation Volunteering for the individual form, Double the Donation appears on the individual form

OR WHEN I edit individual registration form settings/design for a new or existing registration form that does currently have Double the Donation Volunteering activated

THEN I am presented with the option to disable Double the Donation

AND THEN if I disable Double the Donation for the individual form, Double the Donation no longer appears on the individual form

Thomas

Title: Thomas should be able to register to volunteer online with a corporate email address and receive volunteer grant and volunteer PTO information/instructions

User value: As Thomas I want to register to volunteer online with a corporate email address so that I can receive volunteer grant and volunteer PTO information/instructions

Acceptance Criteria:

GIVEN I have completed the rest of the online volunteer registration process properly

WHEN I provide a corporate email address in the standard "Email" field of the registration form

THEN I am presented with the Double the Donation Volunteer Plugin on the confirmation page, populated with the volunteer grant/PTO database information for the company in the DTD database that matches the corporate email domain I provided

AND THEN my transaction record appears in the Double the Donation portal with my company name populated in the "Company".


Title: Thomas should be able to register online to volunteer with a non-corporate email address and self-report his employer within the registration experience and receive volunteer grant/volunteer PTO information/instructions

User value: As Thomas I want to register online to volunteer with a non-corporate email address and self-report my employer within the online registration experience so that I can receive volunteer grant/volunteer PTO information/instructions

Acceptance Criteria:

GIVEN I have completed the rest of the online volunteer registration process properly

WHEN I provide a non-corporate email address in the standard "Email" field of the registration form

AND WHEN I use the Double the Donation streamlined search field and select my company name

THEN I am presented with the Double the Donation Volunteer Plugin on the confirmation page, populated with the volunteer grant/volunteer PTO database information for the company in the DTD database I self-reported

AND THEN my transaction record appears in the Double the Donation Volunteering portal with my company name populated in the "Company" column.

OR WHEN I provide a non-corporate email address in the standard "Email" field of the registration form

AND WHEN I do not use the Double the Donation streamlined search field

THEN I am presented with the Double the Donation Volunteer Plugin on the confirmation page, which is blank and prompts me to search my company name

AND THEN I use the plugin to search and select my company name, which populates the volunteer grant/volunteer PTO database information for the company in the DTD database that I self-reported

AND THEN my transaction record appears in the Double the Donation Volunteering Portal with my company name populated in the "Company" column.