README

MediaWiki extension that adds support for local media files to Wikibase via a new data type.

Professional Wiki created and maintains Wikibase Local Media. We provide Wikibase hosting, Wikibase development, and Wikibase consulting.

Rhizome commissioned and funded the extension's initial development. Wikibase Local Media is an open-source project, and contributions are welcome!

Demo and screenshot

Also see this animated gif.

Platform requirements

• PHP 7.4 or later
• MediaWiki 1.40 or later
• Wikibase Repository

For more information on the different versions of this extension, see the release notes.

Installation

First, install MediaWiki and Wikibase Repository.

Using Composer (option 1/2)

The recommended way to install Wikibase Local Media is using Composer with MediaWiki's built-in support for Composer.

On the commandline, go to your wiki's root directory. Then run these two commands:

COMPOSER=composer.local.json composer require --no-update professional-wiki/wikibase-local-media:*
composer update professional-wiki/wikibase-local-media --no-dev -o

Manual download (option 2/2)

You can also install the extension via git clone or download. Place the WikibaseLocalMedia directory into extensions.

Enabling the extension

Then enable the extension by adding the following to the bottom of your wikis LocalSettings.php file:

wfLoadExtension( 'WikibaseLocalMedia' );

You can verify the extension was enabled successfully by opening your wikis Special:Version page in your browser.

PHP Configuration

Configuration can be changed via LocalSettings.php.

Setting foreign file repo

Optional wiki API URL, works in conjunction with $wgForeignFileRepos for retrieving images from any wiki

Variable: $wgWikibaseLocalMediaRemoteApiUrl

Default: null

Example: https://commons.wikimedia.org/w/api.php

Running the tests

• PHP tests: php tests/phpunit/phpunit.php extensions/WikibaseLocalMedia/tests/
• JS tests: index.php?title=Special%3AJavaScriptTest&filter=jquery.ui.mediasuggester

Release notes

Version 2.0.0

Released on March 30, 2025

• Raised the minimum MediaWiki version from 1.35 to 1.40
• Added support for MediaWiki 1.41, 1.42, 1.43, and the development version of 1.44
• Translation updates

Version 1.1.0

Released on February 16, 2025

• Added optional APU URL configuration variable wgWikibaseLocalMediaRemoteApiUrl (works together with wgForeignFileRepos)
• Translation updates

Version 1.0.4

Released on October 9, 2024

• Fixed support for non-English wikis
• Fixed deprecation warning of MediaWiki 1.40 and later
• Translation updates

Version 1.0.3

Released on March 30, 2023

• Added support for MediaWiki and Wikibase 1.38 and 1.39
• Translation updates

Version 1.0.2

Released on October 4th 2022

• Added support for MediaWiki and Wikibase 1.37
• Translation updates

Version 1.0.1

Released on March 17th 2021

• Allowed installation with PHP 7.2.x
• Translation updates

Version 1.0.0

Released on October 5th 2020

• Added optional integration with Wikibase Client
• Translation updates

Version 0.2.1

Released on September 28th 2020

• Fixed support for PHP 7.3.x

Version 0.2

Released on September 26th 2020

• Added support for MediaWiki/Wikibase 1.35
• The extension is now listed in the Wikibase group on Special:Version

Version 0.1

Released on September 26th 2020

• Initial release for MediaWiki/Wikibase 1.34