Extension:Theme

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual - list
Crystal Clear action run.png
Theme

Release status: stable

Implementation Skin
Description Allows using themes of skins
Author(s) Ryan Schmidt
Jack Phoenix
Last version 1.5
MediaWiki 1.17+
License Public domain
(the main PHP file is PD-licensed, while some of the actual theme files may not be)
Download
Example ShoutWiki
Parameters

$wgDefaultTheme

Hooks used
BeforePageDisplay
Check usage and version matrix

The Theme extension allows loading of themes (preset CSS to change the appearance of a skin). Currently, the $wgDefaultTheme variable can be used to control what theme is being used site-wide, and the usetheme=X parameter is accepted in LocalSettings.php to change the theme on a per-pageload basis. Future versions of this extension will also add fields to Special:Preferences to allow changing the theme on a per-account basis.

This extension was written by Skizzerz for ShoutWiki.

Installation [edit]

  1. Get the source code
  2. Add
    require_once("$IP/extensions/Theme/Theme.php");
    to your wiki's LocalSettings.php
  3. Installation can now be verified through Special:Version on your wiki

Parameters [edit]

$wgDefaultTheme controls which theme is displayed by default when users visit your wiki.

Adding themes [edit]

To add a new theme for a core skin (such as Modern or Vector), create a directory called skinname (i.e. vector) under $IP/extensions/Theme and place the CSS file(s) there.

To add a new theme for a custom skin, register a module for each theme in the skin's main setup file. The naming convention is skins.skinname-in-lowercase.themename-in-lowercase; for example, the module name of the AutumnLeaf theme for the BlueCloud skin would be skins.bluecloud.autumnleaf.