MediaWiki extensions manual

TemplateStylesExtender Release status: stableCategory:Stable extensions
Implementation	Parser extension Category:Parser extensions
Description	Extends Extension:TemplateStyles with new selectors
Author(s)	Octfxtalk
Latest version	2.0.0 (2025-06-02)
MediaWiki	1.43+Category:Extensions with manual MediaWiki version
PHP	>=8.0
Composer	octfx/template-styles-extenderCategory:Extensions supporting Composer
License	GNU General Public License 2.0 or later
Download	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net . Category:Extensions in GitHub version control
Parameters $wgTemplateStylesExtenderCustomPropertiesDeclaration $wgTemplateStylesExtenderExtendCustomPropertiesValues $wgTemplateStylesExtenderEnableUnscopingSupport $wgTemplateStylesExtenderUnscopingPermission
Hooks used ParserFirstCallInit Category:ParserFirstCallInit extensions TemplateStylesPropertySanitizer Category:TemplateStylesPropertySanitizer extensions TemplateStylesStylesheetSanitizer Category:TemplateStylesStylesheetSanitizer extensions

The TemplateStylesExtender extension extends Extension:TemplateStyles with new selectors and matchers. TemplateStylesExtender is developed based on css-sanitizer 5.5.0, which is being used by MediaWiki 1.43.

Features

• Declare CSS custom properties/variables
• Use CSS custom properties/variables in most properties
• Implement additional properties and values as listed below

Installation

• Download and place the file(s) in a directory called TemplateStylesExtender in your extensions/ folder.
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'TemplateStyles' );
  wfLoadExtension( 'TemplateStylesExtender' );
  

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

Configuration

Note CSS Vars

Currently using :root selectors won't work due to template styles prepending .mw-parser-output.

One possible fix is to wrap the entire content into a 'div' element and adding the declarations to this, e.g.

div#content-wrap {
   --padding: 10px
}

.content {
   padding: var( --padding )
}

Wikitext

<div id="content-wrap">
   <div class="content">
      The WikiText...
   </div>
</div>

Unscoping of CSS

Example: <templatestyles src="Foo/style.css" wrapclass="mediawiki" /> results in the CSS being scoped to .mediawiki instead of .mw-parser-output.

See also

• Extension:TemplateStyles

This extension is included in the following wiki farms/hosts and/or packages: Miraheze Category:Extensions included in Miraheze MyWikisCategory:Extensions included in MyWikis WikiForgeCategory:Extensions included in WikiForge This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm.