Help:Extension:CampaignEvents/Registration/Collaborative contributions

Overview

The Event Registration tool in the CampaignEvents extension has a new feature: Collaborative Contributions. With this feature, you can:

• View contribution statistics, which are the edits made collectively during an event or a group activity on the wikis.
• Set an event goal, which allows the group to track progress against a goal with a public progress bar.

The edit data is visible on the Contributions tab of the EventDetails page for the event.

Data displayed on the wiki

Edits view of contributions tab. You can see the full list of edits made during the event and the progress against the event goal.

Editors view of the contributions tab. You can see the total impact per event participant, along with the collective progress against the event goal.

The Contributions tab currently displays:

• a summary view, with the number of:
  • participants
  • wikis edited
  • articles created
  • articles edited
  • total edit count
  • bytes changes
  • links changed
• an Edits tab, with a table view that displays data on every edit made, with the following sortable columns:
  • name of article edited (with link to article and a plus icon to indicate a newly created article)
  • wiki of the edit
  • username of editor (with link to user page)
  • timestamp of edit (with link to diff of edit)
  • bytes changed
  • actions column with a trash icon (if the editor viewing the page has the permission to remove an edit)
• an Editors tab, with a table view that displays data on the total impact made per editor, with the following sortable columns:
  • Username
  • Articles created
  • Articles edited
  • Edit count
  • Bytes

Goal setting

Progress bar for goal-setting on event page

Organizers have the option to set a group goal, based on any of the data points collected. For example, an organizer set a goal to make 100 edits or to create 50 articles. The progress against the goal is publicly displayed, except for special handling when a contributor was privately registered.

Global support

As a part of Event Registration, this is a global tool. This means that you can:

• View the Contributions tab on any wiki with the CampaignEvents extension. You don't need to go to the home wiki of the event to view the data.
• See contribution data from multiple wikis on the Contributions tab. So, for example, you can see contribution data for an event that targets Spanish Wikipedia, Portuguese Wikipedia, and Wikidata all on the same page.

Public and private registration support

All edits of publicly registered participants are visible to everyone who visits the Contributions tab. The edits of privately registered participants, as well as any contributions they made toward an event goal, are visible to anyone who is able to see the the private participant data on the wikis, which is usually: the participant who made the edit, the organizers of the event, and wiki admins.

Ability to change edit associations

If you are the editor who made the edit, or if you are an organizer of the event, you can remove an edit association via the Actions column.

We also be implementing a method to manually add an individual edit via the EventDetails page soon in an upcoming release

Instructions

Below, we have provided instructions on how the feature works today. We will update this page as we continue to further develop the feature.

Organizers: How to set up contribution statistics

Enabling contribution statistics with a goal of 100 edits

1. Create an event and choose to enable event registration (see instructions on how to do this).
2. When configuring event registration, ensure that:
   1. When selecting Event type, at least one of the options selected is a contribution event (Editing event, Media upload event, Backlog drive, or Contest)
   2. When selecting target wikis, either choose “Yes, open to all wikis” or select specific wikis. We strongly encourage you to pick specific wikis, since “Yes, open to all wikis” means that users will see the post-publication dialog on all wikis during the event time period.
   3. If the event is in person or online and in person, the event cannot be taking place in a country that is listed as “Not published” or “Higher risk” in the Wikimedia Foundation Country and Territory Protection List.
3. Navigate to the Impact statistics section.
4. If all of the conditions in step 2 are met, you will see that “Show contribution statistics” is automatically toggled on for the event. However, if you do not want it on, you can turn it off.

Organizers: How to set a group goal

If you have enabled contribution statistics, you can set a group goal for the event. To do this:

1. Navigate to the Impact statistics section.
2. Confirm that Contribution statistics is enabled.
3. Select a goal metric.
4. Select a target number. There is no maximum number.
5. You should now see a progress bar on the event page and in the Contributions tab in EventDetails. Participants will also see it in the post-publication dialog after they publish an edit that can be associated with the event.

Participants: How to associate edits with events with the post-publication dialog

Example of selecting between multiple events for edit association on patchdemo

1. An editor needs to register for an event that has contribution statistics turned on.
2. The editor must then make an edit on a target wiki of the event during the event time period (i.e., between the start and end times of the event).
3. After they save the edit, they will see a post-publication dialog, which will ask if they want to associate the edit with the event. If they are registered for multiple events that the edit could be associated with, they will see a drop-down of options to select the appropriate event. They can only associate an edit with one event.
4. If they associate an edit with an event, the edit data will then be displayed in the Contributions tab of EventDetails. If they do not associate an edit with an event, they will not see the data in the Contributions tab of EventDetails.

Organizers & participants: How to associate edits with events at any time

Example of adding an edit to an event via the Contributions tab

If you forgot to associate an edit with the post-publication dialog, or if you have chosen to disable the post-publication dialog for an event, you can always add an edit manually via the Contributions tab.

To do this, you need to be an organizer of the event or the person who made the edit. Here is how you do this

1. Go to the Contributions tab in EventDetails on the wiki where you made the edit. You will see that there is an "Add edit to this event" button.
2. You will see a pop-up appear to add an edit. To do this, you need to add the revision ID of the edit. You can find the revision ID of the edit if you go to the revision history of the article you edited, and then you click on timestamp associated with the revision.
3. You will see the revision ID in the URL. For example, if the URL is https://en.wikipedia.org/w/index.php?title=Congruence_(geometry)&oldid=12345, the revision ID is 12345. Copy/paste the ID and then click "Add edit."

Organizers & participants: How to track progress against goal

You can view the progress against the goal in the following places:

• On the event page, under the Event Registration header
• On the Contributions tab in Special:EventDetails
• In the post-publication dialog, which is viewable to event participants after they publish an edit that can be associated with the event

Organizers & participants: How to remove edits associations

If you are an organizer of the event, or if you are the person who made the edit, you can choose to remove an edit association from an event. Here is how you do this:

1. Go to the Contributions tab of EventDetails on the wiki where you made the edit.
2. Go to the Actions column. You will see that, for all of the edits that you have permission to remove, there will be a trash icon in the column. If you do not have the permission to remove any edits, you will not see the Actions column.
3. Click the trash icon for the edit you want to remove.
4. You will see a pop-up to confirm that you want to remove the edit.

Participants: How to opt out of the post-publication dialog

If you do not want to see the post-publication dialog after you make an edit, you can do the following things:

1. Go to the event page and click on "Manage Registration."
2. Go to the "Contribution statistics" section.
3. Uncheck the box that says, "After I publish an edit, ask me whether the edit is for this event."

Noteː This setting is on a per-event basis. This means that you can choose to see the post-publication dialog for some events, but not for other events, if you prefer.