Extension:Theme

MediaWiki extensions manual

Theme Release status: stable
Implementation	Skin
Description	Allows using themes of skins
Author(s)	Ryan Schmidt Jack Phoenix Samantha Nguyen
Latest version	2.1
MediaWiki	1.33+
License	Public domain (the main PHP file is PD-licensed, while some of the actual theme files may not be)
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history code review
Example	ShoutWiki
Parameters $wgDefaultTheme
Hooks used BeforePageDisplay GetPreferences OutputPageBodyAttributes
Translate the Theme extension if it is available at translatewiki.net
Check usage and version matrix.
Issues	Open tasks · Report a bug

The Theme extension allows loading of themes (preset CSS to change the appearance of a skin). Users can determine their preferred theme by configuring this in their preferences. The $wgDefaultTheme variable can be used to control what theme is being used site-wide, and the usetheme=X parameter is accepted on a request to change the theme on a per-pageload basis.

This extension was written by Skizzerz for ShoutWiki.

Installation

• Download and place the file(s) in a directory called Theme in your extensions/ folder.

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

  wfLoadExtension( 'Theme' );
  

•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Parameters

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

Available themes

For MonoBook

• dark
• pink
• stellarbook

For Vector

• dark
• deepsea

Adding themes

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, place the CSS file(s) there and register the new theme in Theme/extension.json file, under ResourceModules object.

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 themeloader.skins.skinname-in-lowercase.themename-in-lowercase; for example, the module name of the AutumnLeaf theme for the BlueCloud skin would be themeloader.skins.bluecloud.autumnleaf.