installation-linux.md

Installation on Linux - Step by Step

Here is a step by step procedure for Linux, that should work for other unixy operating systems as well:

1. Open a command line window (e.g. using Konsole or XTerm).

2. If necessary install Composer:

   wget -cO - https://getcomposer.org/composer-1.phar > composer.phar
   sudo mv composer.phar /usr/local/bin/composer

3. Navigate to the root folder of your MediaWiki installation. That's the one with the LocalSettings.php file in it.

4. Open the composer.local.json file in an editor and add the Chameleon skin to the require section:

   "require": {
       "mediawiki/chameleon-skin": "~3.0"
   },

   Remark: If you do not have a composer.local.json file, but a composer.local.json-sample, rename the -sample file and add the "require" section. It should then look like this:

   {
       "require": {
           "mediawiki/chameleon-skin": "~3.0"
       },
       "extra": {
           "merge-plugin": {
               "include": [
                   "extensions/example/composer.json"
               ]
           }
       }
   }

5. To actually install Chameleon run the command

   COMPOSER=composer.local.json composer require --no-update mediawiki/chameleon-skin:~3.0
   composer update mediawiki/chameleon-skin --no-dev -o```

6. If there were no errors, close the command line window.

7. Open LocalSettings.php in an editor (e.g. Kate). Include

   wfLoadSkin( 'chameleon' );

   as the last line.

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

   $wgDefaultSkin='chameleon';

   Save the file and close the editor.

8. Done: Open your wiki in a browser and navigate to the Special:Version page to verify that the skin is successfully installed. (If you have set Chameleon as default skin it should also be obvious that the skin has changed.)

9. If not, force reload the page to refresh your browser cache. (On Firefox or Chrome press Ctrl+F5)