Extension:MediaUploader

MediaWiki extensions manual

MediaUploader Release status: experimental
Implementation	Media, Special page
Description	Flexible, multi-file, step-by-step uploader
Author(s)	Neil Kandalgaonkar, Jeroen De Dauw, Mark Holmquist, Ryan Kaldari, Ankur Anand, Yuvi Panda, Michael Dale, Ostrzyciel
Latest version	0.1.0
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki	1.36+
Database changes	Yes
Tables	uw_campaigns
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review README
Namespace Campaign
Parameters $wgMediaUploaderConfig $wgUploadWizardConfig
Added rights upwizcampaigns mass-upload
Hooks used ArticleDelete ArticleDeleteComplete ChangeTagsAllowedAdd ChangeTagsListActive CodeEditorGetPageLanguage ContentModelCanBeUsedOn EditFilterMergedContent EditPage::showEditForm:initial GetPreferences IsUploadAllowedFromUrl LinksUpdateComplete ListDefinedTags LoadExtensionSchemaUpdates MovePageIsValidMove PageMoveComplete PageSaveComplete UserGetReservedNames
Translate the MediaUploader extension if it is available at translatewiki.net
Check usage and version matrix.
Issues	Open tasks · Report a bug

MediaUploader is a flexible file upload tool forked from UploadWizard.

Installation

• 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 place the file(s) in a directory called MediaUploader in your extensions/ folder.
• Only when installing from git run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See task T173141 for potential complications.)
• Add the following code at the bottom of your LocalSettings.php:

  wfLoadExtension( 'MediaUploader' );
  

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

Updating from UploadWizard

TBD

Development status

We are currently identifying and resolving issues that should be fixed before the initial release. Until then, the extension may change a lot and break compatibility, so using it is not recommended for now. See this Phabricator task for more details.

Maintainer's note: progress is currently slow (May 2021) due to external factors, I plan to get back to faster development in July.

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