Extension:Theme
![]() Release status: stable |
|
---|---|
Implementation | Skin |
Description | Allows using themes of skins |
Author(s) | Ryan Schmidt Jack Phoenix Samantha Nguyen |
Latest version | 2.2.3 |
MediaWiki | 1.35+ |
License | Public domain (the main PHP file is PD-licensed, while some of the actual theme files may not be) |
Download | |
Example | ShoutWiki |
$wgDefaultTheme |
|
Translate the Theme extension if it is available at translatewiki.net | |
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.
InstallationEdit
- Download and place the file(s) in a directory called
Theme
in yourextensions/
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.
ParametersEdit
$wgDefaultTheme controls which theme is displayed by default when users visit your wiki.
Available themesEdit
- For MonoBook
- dark
- pink
- stellarbook
- For Vector
- dark
- deepsea
Adding themesEdit
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.