How to install extensions and skins¶

MediaWiki and the MediaWiki charm bundle a number of extensions and skins by default. However, you may want to install additional extensions and skins to further customize your MediaWiki deployment. This can be accomplished by leveraging Composer, a dependency manager for PHP.

The MediaWiki charms allows you to configure an arbitrary composer.json file using juju config, which is used by Composer to determine which packages to install.

For example, with a local composer.json file that specifies the extensions and skins you want to install, you can run the following command to update the charm’s configuration:

juju config mediawiki-k8s composer="$(cat ${PATH_TO_COMPOSER_FILE})"

When the composer configuration key is modified, the charm will run composer update to refresh the installed extensions and skins, as well as their dependencies.

Note

Extensions and skins will only be refreshed when the composer configuration key is modified, or if a previous attempt failed.

To verify that your extensions or skin was installed correctly, enable it by configuring the local settings. Then, go to the Special:Version page on your MediaWiki instance to see if the extension or skin is listed.