README.md

Wikibase Local Media

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

Wikibase Local Media was created by Professional.Wiki with Funding from Rhizome. It is an open source project and contributions are welcome!

Professional.Wiki provides commercial Wikibase hosting, MediaWiki development and support.

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.37
• Wikibase Repository REL1_34, REL1_35, REL1_36 or REL1_37

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

Released on October 4th 2022

• Added support for MediaWiki and Wikibase 1.37

Version 1.0.1

Released on March 17th 2021

• Allowed installation with PHP 7.2.x

Version 1.0.0

Released on October 5th 2020

• Added optional integration with Wikibase Client

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