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 initial development of the extension. Wikibase Local Media is an open source project and contributions are welcome!

Demo and screenshot

Also see this animated gif.

Platform requirements

PHP 7.2 or later, including PHP 8.0
MediaWiki 1.34 up to 1.39
Wikibase Repository REL1_34, REL1_35, REL1_36, REL1_37, REL1_38, or REL1_39

See the release notes for more information on the different versions of this extension.

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 wikis 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.

Finally, please consider sponsoring the project.

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 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