Extension:UploadWizard/Campaigns

The UploadWizard can be configured to behave in a number of ways using various settings. Often one wants the UW on a single wiki to behave differently for different tasks, in which case more than one set of configuration is needed. The UW allows defining such sets of configuration, also called campaigns, which can then be put into effect by specifying a single argument in the URL via which the UW is accessed.

When navigating to Special:UploadWizard, no campaign will be used, so you will get the default configuration. To get the configuration for a campaign, add ?campaign=name to the URL, where "name" is the name of the campaign.

Campaign configuration is stored as JSON in the Campaign namespace. You can create a new campaign by simply creating a new page in that namespace, and placing the appropriate fields in it.

To create a new campaign, just go to a new page in the Campaign namespace like Campaign:MySuperNeatCampaign, then create a JSON configuration for the campaign you want to make.

This is a boolean variable that specifies if the campaign is enabled or not. This is a required field, and must always be present.

title

This is a string field that contains wikitext to be displayed as the Title. If this is absent, the name of the campaign page itself is displayed as title.

description

This is a string field that contains wikitext to be displayed as the description.

This field lets you control what banners to display in UploadWizard

It has the following properties:

The object reference feature adds messages to the user interface which can be overridden with the following campaign parameters:

This field lets you control the tutorial that is shown before the first step of Uploading.

It has the following properties:

Lets you control the default information to be added for the media uploaded. Note that the user can modify them at will before uploading.

It has the following properties:

Specifies wikitext and categories to be added automatically, without user intervention. The user cannot remove or modify these.

It has the following properties:

Specifies custom fields that can be used to request user input during the upload process, and then substituted into the description field of the {{Information}} template during upload. This is an array, and there can be as many fields as necessary.

Each field can have the following properties:

A single-line text field. Additional properties available for this type:

• maxLength - Maximum length allowed for this field. Defaults to 25. There is currently no way to specify 'no limits', so just set this to a large value if that is the case.
• initialValue - The initial value to be pre-filled for the field.

For example:

    "fields": [
        {
            "wikitext": "{{en|1=$1}}",
            "label": "parameter#1",
            "initialValue": "{{subst:PAGENAME}}"
        }
    ],

Will add a field to the upload form with label parameter#1 pre-filled with {{subst:PAGENAME}}. If you do not change it than a template {{en|1=...}} with filename instead of ..., will be appended to the description field in the {{Information}} template. Also interestingly the English description field does not show up by default and one can save images without additional description.

If you want a line break before the wikitext, prepend '\n'.

            "wikitext": "\n{{en|1=$1}}",

A dropdown select field. Additional properties available for this type:

• options - Object mapping field values (that will end up in final wikitext) to labels (which will be displayed to the user). The first value will be selected by default.

Specifies licensing selection options, both for own work and third party licenses.

It has the following properties:

"ownWork": {
    "licenses": [
        "cc-by-sa-3.0",
        "cc-by-3.0"
    ]
}

The start of the "active" period for the campaign. This is used mostly for contests where an active period requires different configuration - see #beforeActive, whileActive, and afterActive for more. This value uses strtotime to convert times, so please use compatible time formats. Please note that the time should be expressed in UTC.

The end of the "active" period for the campaign. This is used mostly for contests where an active period requires different configuration - see #beforeActive, whileActive, and afterActive for more. This value uses strtotime to convert times, so please use compatible time formats. Please note that the time should be expressed in UTC.

Specify automatically modified parts of the campaign configuration between the start and end dates. You may use modified versions of the display and autoAdd arrays. The display elements are used as replacements for the existing values, and the autoAdd elements are added to the existing values. Here's an example of the expected structure:

"beforeActive": {
    "display": {
        "headerLabel": "Foo campaign hasn't started yet"
    }
}

UploadWizard allows users to add Structured Data to files in the "Add Data" step of the upload process. Campaign administrators now have the option to disable the Structured Data features (either partially or entirely), or add suggested properties and values to all uploads that are part of a given campaign.

The Structured Data features for an UploadWizard Campaign are enabled by default. They can be disabled entirely though:

"wikibase": {
        "enabled": false
    }

The above example will disable captions in the Describe step and remove the Add Data step completely.

Individual components of Structured Data can be disabled/enabled as well. This example disables captions in the Describe step but keeps the Add Data step enabled:

"wikibase": {
        "enabled": true,
        "captions": false,
        "statements": true
    }

Default, pre-filled caption values can be added:

{
    "enabled": true,
    "wikibase": {
        "enabled": true,
        "captions": true
    },
    "defaults": {
        "caption": "SOME CAPTION"
    }
}

By default, this will fill in a caption for the language matching the user's current interface language. So, if the user's interface is in French, the caption language selector will default to French as well. The desired caption language can be explicitly set via HTML link by adding captionlang=<languagecode> as part of the querystring linking to UploadWizard. In the future, there will be an ability to set the caption language with the campaign JSON config.

Suggested statements can be added as part of the "defaults" option described above, under a "statements" key:

"defaults": {
    "statements": [
        {
            "propertyId": "P1",
            "dataType": "wikibase-entityid"
        }
    ]
}

This example will add a widget which allows the user to add values corresponding to property "P1" in Wikibase. Any number of statements can be provided in this way.

To automatically fill in a specific value for a given property, just add a "values" array to the block above, and include one value. For properties that require a Wikidata entity as input, use the appropriate Q ID from Wikidata:

"defaults": {
    "statements": [
        {
            "propertyId": "P1",
            "dataType": "wikibase-entityid",
            "values": [ "Q1" ]
        }
    ]
}

A new feature allows campaign organizers to enable a "sync to all files" button that will allow users to copy all structured data statements from one file to all other files in a batch upload. When clicked, this new button will copy the data from the currently selected file and overwrite/discard any existing data on other files in the batch (there will be an alert window informing users of this when the button is clicked). The "allowCopy" value defaults to false, and must be set to true in the campaign config file to enable it.

"wikibase": {
        "allowCopy": true
    }

Finally, campaign administrators can disable the ability of users to add arbitrary statements (they can still add and modify any default statements which are provided). To do this, a new option called "nonDefaultStatements" can be set to false (it defaults to true):

"wikibase": {
        "nonDefaultStatements": false
    }