Skip to content

Latest commit

 

History

History
91 lines (58 loc) · 2.81 KB

installation.md

File metadata and controls

91 lines (58 loc) · 2.81 KB
Raw

Installation, Update, De-Installation

Requirements

  • PHP 7.4.3 or later (tested up to PHP 8.1)
  • MediaWiki 1.35 or later (tested up to MediaWiki 1.37)

Installation

There are two methods for installing Chameleon: with or without Composer.

If you install Chameleon with Composer, further required software packages will be installed automatically. In this case, it is not necessary to install any dependencies. Composer will take care of that.

If you install Chameleon without Composer, you will need to install and enable the Bootstrap extension before you install and enable Chameleon.

If unsure try the detailed installation instructions for Windows or Linux.

Here is the short version:

Installation with Composer

On a command line go to your MediaWiki installation directory and run these two commands

COMPOSER=composer.local.json composer require --no-update mediawiki/chameleon-skin:~4.0

composer update mediawiki/chameleon-skin --no-dev -o

Then, open LocalSettings.php in an editor, and add the following lines:

wfLoadExtension( 'Bootstrap' );
wfLoadSkin( 'chameleon' );

Optional: to set Chameleon as the default skin, find $wgDefaultSkin and amend it:

$wgDefaultSkin='chameleon';

Save the file. To verifying Chameleon was installed correctly, navigate to Special:Version on your wiki.

If you run into problems, try the troubleshooting.

Installation without Composer

  1. Install and enable the Bootstrap extension.

  2. Download Chameleon and place the file(s) in a directory called chameleon in your skins/ folder.

  3. Add the following code at the bottom of your LocalSettings.php:

    wfLoadSkin( 'chameleon' );

    To set Chameleon as the default skin, find $wgDefaultSkin and amend it:

    $wgDefaultSkin='chameleon';

  4. Done: Navigate to Special:Version on your wiki to verify that the skin is successfully installed.

Update with Composer

From your MediaWiki installation directory run composer update "mediawiki/chameleon-skin" --no-dev -o

If you want to upgrade from Chameleon 2.x to 3.x, first edit composer.local.json. Change "mediawiki/chameleon-skin": "~2.0" to "mediawiki/chameleon-skin": "~3.0".

De-installation with Composer

Before de-installation make sure you secure (move, backup) any custom files you might want to retain.

Remove the Chameleon skin from the composer.local.json file. Then run composer update "mediawiki/chameleon-skin" from the MediaWiki installation directory.