This page is currently a draft. More information and discussion about changes to this draft may be on the discussion page.

MediaWiki extensions manual

MediaUploader Release status: betaCategory:Beta status extensions
Implementation	MediaCategory:Media handling extensions, Special page Category:Special page extensions
Description	Flexible, multi-file, step-by-step uploader
Author(s)	Ostrzyciel, authors of UploadWizard
Latest version	0.1.0
Compatibility policy	Master maintains backward compatibility.Category:Extensions with master compatibility policy
MediaWiki	1.37+Category:Extensions with manual MediaWiki version
PHP	7.3
Database changes	Yes
Tables	mu_campaign
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Browse repository (GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control README
Namespace Campaign
Parameters $wgMediaUploaderConfig $wgUploadWizardConfig
Added rights upwizcampaigns, mass-upload Category:Extensions which add rights
Hooks used PageDelete Category:PageDelete extensions PageDeleteComplete Category:PageDeleteComplete extensions ChangeTagsAllowedAdd Category:ChangeTagsAllowedAdd extensions ChangeTagsListActive Category:ChangeTagsListActive extensions CodeEditorGetPageLanguage Category:CodeEditorGetPageLanguage extensions ContentModelCanBeUsedOn Category:ContentModelCanBeUsedOn extensions EditFilterMergedContent Category:EditFilterMergedContent extensions EditPage::showEditForm:initial Category:EditPage::showEditForm:initial extensions GetPreferences Category:GetPreferences extensions LinksUpdateComplete Category:LinksUpdateComplete extensions ListDefinedTags Category:ListDefinedTags extensions LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions MovePageIsValidMove Category:MovePageIsValidMove extensions PageSaveComplete Category:PageSaveComplete extensions UserGetReservedNames Category:UserGetReservedNames extensions
Quarterly downloads	0
Translate the MediaUploader extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

MediaUploader is an easy to use and flexible file upload tool. It is designed to be configurable and meet the demands of a wide variety of wikis.

Installation

 Note: If you are migrating from UploadWizard, see the dedicated guide.

• 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 Manual:Image administration, particularly image thumbnailing.
• Download and move the extracted MediaUploader folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MediaUploader
• Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See T173141 for potential complications.)Category:Extensions requiring Composer with git
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'MediaUploader' );
  

• Run the update script which will automatically create the necessary database tables that this extension needs.
• Configure as needed.
• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Features

TBD

Configuration

MediaUploader has extensive and very flexible configuration that can also be partially adjusted on-wiki with the use of campaigns. If you find the config overwhelming, there are also several ready-to-use configuration sets that you can just copy to your wiki and get started in no time.

• Configuration overview
  • Upload form appearance
  • Licensing
  • Adding information to uploads and formatting it
  • Other config settings
• Campaigns
• Ready-to-use configuration sets

Origin and design

The idea of MediaUploader stemmed from the numerous issues with using UploadWizard on third-party wikis. The original tool was mostly designed for use by Wikimedia Commons, fulfilling its very specific needs (e.g. Wikibase support, specific licensing hacks, image-based tutorials). Third parties usually have a very different set of requirements that emphasize simplicity and flexibility. The two approaches are hard to reconcile in a single extension, especially given that UploadWizard must meet Commons' requirements and has no obligation to consider the needs of third parties. Thus, MediaUploader was born.

Main design goals of MediaUploader are:

• Ease of use, at least as good as the original UploadWizard.
• Configurability of all elements, well-described in documentation.
• Ability to simplify certain elements of the wizard for wikis with less strict image description requirements.
• Extensibility to allow for wiki-specific enhancements to be created locally.
• No Wikimedia Commons-specific features.

See also

• UploadWizard, the extension this was forked from

This extension is included in the following wiki farms/hosts and/or packages: Canasta Category:Extensions included in Canasta This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm.