README

The SimpleBatchUpload extension provides basic, no-frills uploading of multiple files to MediaWiki.

It is maintained by Professional Wiki. Contact us for commercial support or MediaWiki development.

Requirements

• PHP 8.0 or later
• MediaWiki 1.43 or later

Use SimpleBatchUpload 2.x for older versions

Installation

Composer

COMPOSER=composer.local.json composer require --no-update mediawiki/simple-batch-upload:^3.0

composer update mediawiki/simple-batch-upload --no-dev -o

Manual installation

Download and place the files in a directory called SimpleBatchUpload in your extensions/ folder.

Enable the extension by adding the following to your LocalSettings.php:

wfLoadExtension( 'SimpleBatchUpload' );

Usage

See the SimpleBatchUpload usage documentation.

Customization

It is possible to specify dedicated parameter sets for the upload of specific file types by editing the MediaWiki:Simplebatchupload-parameters page. Each line of that page is considered as one set of parameters.

Available parameters are:

• Name of template to be stored as text on initial upload
• Upload comment
• Title line of the Special:BatchUpload page

Parameters should be separated by pipes (|).

The line to be used is selected by appending the name of the template as the subpage to the URL of the Special:BatchUpload page.

Example:

Consider the parameter line

Pics | These pics were uploaded using [[mw:Extension:SimpleBatchUpload{{!}}SimpleBatchUpload]] | Upload some pics!

• This can be selected by going to Special:BatchUpload/Pics.
• The title of this page will be Upload some pics!.
• The comment for the upload will be These pics were uploaded using [[mw:Extension:SimpleBatchUpload{{!}}SimpleBatchUpload]].
• If a file with that name is uploaded for the first time it will have {{Pics}} as wikitext.

Configuration

Available configuration options:

• $wgSimpleBatchUploadMaxFilesPerBatch - Array defining the maximum number of files that can be uploaded each time depending on the user group.
  Default:

$wgSimpleBatchUploadMaxFilesPerBatch = [
	'*' => 1000,
];

Note: Be aware that this is not the right setting to completely block file uploads! Users can still use the normal file upload or the MediaWiki API. See the paragraph on user permissions on Configuring file uploads on mediawiki.org.

License

GNU General Public License 2.0 or later