As a grant officer, I want organizers to be able to specify the grant ID when they configure event registration, so that I can more easily track and analyze event impact.
Background: Some organizers within the Wikimedia movement receive grants from the Wikimedia Foundation Funds to support their events. We would like to make it easier for grant officers at the Wikimedia Foundation to understand the impact of the grant that they offer to organizers. To do this, we will allow organizers to optionally add the grant ID to their event registration configuration, so that the grants team can later query to look into the outcomes of events that received grant funding, such as the number of participants.
Priority: This is high-priority for Advancement.
Acceptance Criteria:
- When an organizer is configuring the event registration form, they should be able to optionally add the grant ID
- The details of the field are as follows:
- The organizer should be able to add the numbers of the grant ID only, e.g., 1234-1234
- The grant ID section should be the last section in the registration configuration form
- The label for the field should be "Grant ID"
- The grant ID information should be entered as freeform text
- There should be help text that reads:
If this program or event is supported by a grant from the Wikimedia Foundation, please provide your Grant ID, which you can find in the Grantee Portal (Fluxx). Please enter the numbers and dashes in your grant ID, but exclude the letters. For example, if your grant ID is G-1111-1111, please enter 1111-1111.
- The field should have the placeholder «e.g. 1201-3302»
- When the organizer chooses to enable registration, we should validate that the grant ID is valid.
- If it is valid, the registration should be enabled
- If it is invalid, the organizer should not be able to enable registration:
- They should receive a error message, which reads: "The Grant ID you entered seems to be incorrect. Please double-check your Grant ID in the Grantee Portal (Fluxx) and re-enter."
- They can only enable registration if they update the grant ID to a valid ID or leave the grant ID field blank.
- If there is an error due to the Fluxx API:
- The user should see the following message: "There was an issue with validating your Grant ID. You can try submitting the form again in a few minutes. If the issue persists, you can still submit the form without a Grant ID and add it later by editing the event details."
- They cannot enable registration until the issue is resolved, unless they leave the field blank.
- The organizer should be able to edit the grant ID in the following way:
- When they edit registration, they should see the grant ID as editable text
- They should be able to edit the grant ID text and save changes
- The same validation logic applies to editing grant ID as it does to first entering the grant ID
- The grant ID should only be viewable in Special:EventDetails for event organizers.
Design
Design specs for the form field
Design specs for event details