Commons:ISA Tool/Manual

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search

ISA is a fun tool aimed at the metadata enhancement of images contributed to the various Wiki Loves competitions on Wikimedia Commons. It is being created as a way to quickly add structured information to a collection of pre-defined images.

Access the tool :

Instructions for players[edit]

With ISA, campaign managers can choose a pre-defined set of images on Commons and then ask contributors to 'tag' these with multilingual structured metadata. During the creation of the campaign, the manager will decide

  • which category (or categories) of images will be considered in the campaign
  • which type of metadata can be asked from the participants. It may be depicts and/or captions.

As a user, you can access the list of campaigns on the campaign directory. Some campaigns will be archived (closed) whilst others will be available to join (opened). Select any open campaign you like !

Once on a campaign page, you will be provided with information related to the campaign... how many images are concerned... how many people already participated... how many images were improved etc.

To join the action, you need to be logged-in. This may be done on the top right. The way the system works is that you will log-in to your Wikimedia Commons account, and give authorization to the tool to save edits on your behalf. Anything you add or remove from the ISA tool will be directly recorded on Wikimedia Commons !

Once you are logged-in, you can join action. Note that if the campaign is related to a Wiki Loves image category, you will also be asked to select a country-set.

Once you are on the Participate page, you can 'play' by doing the following (depending on whether the campaign managed selected one.. or the other... or both...)

Depicts: add single words or a few words for each element that you see and link them to elements currently existing on WikiData. To better understand what depicts are : Commons:Depicts

b. Captions: add a description of what is happening in the image. To better understand what Captions are : Commons:File captions

After having changed captions and depicts, you may return to the campaign page and check out

  1. your participation rank
  2. other contributor participation rank...
  3. country participation (when relevant)
  4. download participation stats !

Note that propositions provided by default in the depict area are collected from Wikidata. You can change the language preference.

Instructions for campaign coordinators[edit]

English Flyer in English
French Flyer

The tool operates with campaigns created by coordinators.

A campaign is created by one coordinator. It is generally defined by

  • a starting date
  • an end date
  • one or several categories on Wikimedia Commons, from which the tool will collect images to be served to participants

Please note: examples of campaigns can be found on the Commons:ISA Tool/Challenges page or the Meta Data Weeks page


Example 1: the Nigerian community may wish to run a specific campaign to improve structured descriptions of images uploaded from Nigeria during Wiki Loves Africa 2014. The competition will take place on a Saturday afternoon during a dedicated edit-a-thon. One day before the edit-a-thon, one coordinator will create a specific campaign on the ISA Tool. That campaign will have a starting date on the Saturday morning and ending date at 5pm on Saturday afternoon. Only one category will be listed in the tool : Category:Images from Wiki Loves Africa 2014 in Nigeria. At the beginning of the Edit-a-thon, Nigerian teams share the past excitement and pleasure of participation to former Wiki Loves Africa and explains the importance of having structured data on the uploaded images. Then the Nigerian team share the link to the campaign to all edit-a-thon participants on what's app. During one hour, players compete and improve image descriptions at the same time. The coordinator keeps an eye on the participation stats on the ISA Tool. At 5pm, the competition is over and every player can see how much he helped and can compare himself with the others ! The Nigerian team declare winners the top 5 participants and provide goodies, sweets and certificates to celebrate ! At 5h15, a facebook post is send with a screenshot of the competition results to further push engagement. Everyone goes his way but on Sunday morning, one Nigerian happily goes to the tool campaign page to download info for a deep dive into participation data.

Example 2: A group of French speaking editors wants to run a specific drive to improve structured descriptions of images uploaded during Wiki Loves Africa 2015 in French speaking countries. etc.

Requirements to be a campaign creator[edit]

The only requirements to create a campaign are

  1. to have an account on Wikimedia Commons
  2. to be logged-in

How to create a new campaign[edit]

Watch how to create the ISA Tool campaign on Youtube

Before you create a new campaign, do the following things:

1. Think and look up which categories you want to include in your campaign

2. If you are not going to use a logo or square image, find an image on Commons that you wish to use as the banner image for your campaign. For the image to fit, look for a (preferably) landscape-oriented image . Download the image and crop it into a horizontal banner (recommended size: 2230 x 322px), then upload the cropped image to Commons (remember to provide the correct attribution for the original). Copy the new file name.

An example of a campaign header to use on ISA

To create a campaign, you should take the following steps to set up your campaign:
1. access the main page of the tool :
2. login using your credentials on your Wikimedia Commons account
3. from the tool main page, click on the button that says "create a new campaign using this tool"
4. fill up the form provided. Information that should be added is:

  • provide a name for the campaign. This will visible to the public, so choose short but specific name. For example, it could be People at Work across Africa
  • provide a short description of what the campaign is about (what you aim to do, if this is run by UserGroup, if this is part of a special drive etc.). For example, This campaign features images that were submitted during the Wiki Loves Africa 2017 contest around the theme of People of Work. The images should show people in some form of occupation.
  • enter a starting date (mandatory)
  • enter an end date (this can be left empty if you do not wish to specify an end date for the campaign)
  • add the list of categories on Wikimedia Commons from which you seek to have images retrieved. You can add up to 3-5 categories. Categories should be added as Category:Images from Wiki Loves Africa 2017 or Category: Images from Wiki Loves Africa 2016 in Ghana and Category: Images from Wiki Loves Africa 2014 in Ghana. Please note: as you type or paste the name of the category into the field, a blue dropdown will show that it is linking to the category on Commons. To confirm this category and for it to be included in the campaign, you need to click on this blue version of the category (rather than the field you typed).

5. Include the file name of the image that you wish to use. For example, File:Clothes dyers in Fez, Morocco) bannercrop.jpg
6. Select which metadata you wish to collect in the campaign (you can pick up only one or both). Two different types of metadata can be collected

7. add a long description (this is optional) that provides more information about where the images have come from and why you are interested in doing this particular campaign. An example is The images featured in this campaign were originally submitted to Wikimedia Commons as part of the Wiki Loves Africa 2017 photographic contest. It is important that the images are fully described, including local language names for the occupations featured. Wiki Loves Africa is an annual photographic contest that celebrates the diversity and richness of cultures and peoples across Africa through images contributed around a specific theme. Wiki Loves Africa is a Wiki In Africa project that is run by the Wikimedia communities across Africa. The project is facilitated by and supported by the Wikimedia Foundation.
8. To save the data and start the campaign, click on Publish Campaign.
9. Once saved, a campaign page will be created. This page will be visible by the public (logged-in or not-logged-in). This page will have a URL which you can use to communicate about the campaign. Be sure to tell people about it on social media as well as on Userpages. 10. List and document your campaign on the ISA Tool/Challenges. Feel free to include images if it is an in-person challenge!

Other useful information:

  • You can create as many campaigns as you wish.
  • You can access your campaign in the campaign directory, which may be accessed from the top bar menu or from the tool main page or from your own settings page.

How to modify a campaign[edit]

The campaign can be modified. Once saved, you can access your campaign in the campaign directory, which may be accessed from the top bar menu or from the tool main page or from your own settings.

The campaign can also be deleted (conditions)

How to track the ongoings of your campaign[edit]

sample of report

You can access your campaign in the campaign directory, which may be accessed from the top bar menu or from the tool main page or from your own settings page.

Use this page url to communicate about the campaign (on a wiki, by email, or on social media).

This page will be visible by the public (logged-in or not logged-in).

The information displayed on this page will be

  • the campaign name and the short description at the top
  • the campaign long description and your username at the bottom of the page
  • the campaign progress with
    • the total number of images descriptions to improved
    • the total number of images descriptions already modified. Once an image description is modified, it will be added to the counter.
    • the top contributors with the number of image description improved.
    • the top countries most improved (for Wiki Loves campaigns only).
  • Finally, this page will display a summary of your own contribution. Note that this information will be specific to each contributor

Let people know there is a campaign running![edit]

There is no point in creating a campaign if nobody knows about it! So, there are a number of ways you can let people know. Look on the ISA Challenges page for example of the kinds of campaigns that people run.

1. Running a campaign during an event

  • Announce the campaign during a presentation or at the event in person
  • Announce the campaign over the event group messenger
  • Remember: have the prizes with you at the event if you are going to run one at an event!

2. Use existing Social media channels

  • Announce the campaign through a project or community group (if you have one)
  • If you already have a project page set up on social media channels, make sure to create announcement posts, tweets or grams. Below you can view the kind that was used for the Africa at Play social media calls as an example.

How to measure engagement[edit]

The tool provides two types of stats.

1. Simple stats are provided on the tool itself on a graphic (see the example on the right hand side). Notice that the design of this report was specially designed for lazy busy program leaders. Just screenshot it and use it in your reports. It contains it ill, including licence and credits.
2. If you want to play with the data, download all participation data in a cdv format and enjoy !

Known problems[edit]

OAuth session problem[edit]

Error when trying to save your edits:

Oops! Something went wrong, your edits have not been saved to Wikimedia Commons
  • Login again to OAuth to refresh your session credentials

Image display is delayed[edit]

When choosing for "next image", the image description is instantly changed; the next image only follows much later. This asynchronous update of the page might confuse the user. The image and its description should be loaded together.