Extension:UploadWizard

UploadWizard is an extension that allows a user to upload multiple files with a step-by-step JavaScript wizard. It was designed by Guillaume Paumier as part of the Multimedia usability project and developed by Neil Kandalgaonkar.

See also usability:Multimedia:Upload wizard.

This extension shares some of the same features as Extension:AddMediaWizard, which is part of Extension:UsabilityInitiative. AddMediaWizard and UploadWizard are expected to eventually share most of their uploading media backend code.

Enabling uploads and thumbnails
Your MediaWiki will need to be capable of hosting media files and creating thumbnails (smaller previews of media files). If you can upload images and see smaller previews on their File page, you're already ready. If not, for full instructions, see the manual page on image administration, particularly image thumbnailing.

Quick start for GNU/Linux or Mac OS X users:
 * Make sure that the images directory is writable by your web server.
 * Install the ImageMagick libraries and binaries.
 * Add the following configuration to LocalSettings.php:

Other configuration
This modifies the sidebar's "Upload file" link - probably in other places as well. More at Manual:$wgUploadNavigationUrl.
 * You need to have InstantCommons enabled in order to access the licensing tutorial. To enable InstantCommons add  to LocalSettings.php.
 * You may want to set  in LocalSettings.php, where /wiki/ is the correct path for your wiki. A more general way of doing this that works for whatever path configuration you have, but that requires PHP 5.3 or later is:

Several other options are available through a configuration array. For example:

$wgUploadWizardConfig = array( 	'debug' => false, 	'autoCategory' => 'Uploaded with UploadWizard', 	'feedbackPage' => 'FeedbackTest2', 	'altUploadForm' => 'Special:Upload', 	'fallbackToAltUploadForm' => false, 	'enableFormData' => false, # Should FileAPI uploads be used on supported browsers? 	'enableMultiFileSelect' => false );

URL arguments
There are several url arguments that can be specified to alter the behaviour of the UploadWizard:


 * campaign: Specifies which upload campaign to use.
 * skiptutorial: Sets if the licensing tutorial should be skipped or not. The value should be "1" or "true" to skip.
 * id: Sets the initial value for the id field.
 * description: Sets the initial value for the description field.
 * lat: Sets the initial value for the latitude field.
 * lon: Sets the initial value for the longitude field.
 * alt: Sets the initial value for the altitude field.
 * categories: Sets the initial value for the categories field, multiple categories seperated by |.

These arguments can be specified as follows: if you have an argument named "campaign" and want to provide the value "foobar", then append  to the url. For example  or.

Testing
If you're testing UploadWizard for whatever reason, and you've run out of "real" images to upload as test cases, you can always use the handy MediaWiki utility for creating test images. Open a terminal emulator, get into a directory where you want to store a bunch of test JPG files, and run

Here's a Bash script that should make it easier to do all of this without much trouble. It's a good idea to put this in your PATH and/or make a handy shortcut to it somewhere that will make it trivial to update your images with new ones.

Development status
While we feel that this is ready for others to use, so far, this extension has mostly been used only on Wikimedia wikis. We'd like to get reports from other MediaWiki installations as well.

Related specs

 * Custom WikiText License Feature
 * Location (entering gps coordinates / deriving them from EXIF)

Related extensions

 * Extension:Add Media Wizard