Extension:HeaderExtension

MediaWiki extensions manual

HeaderExtension Release status: stable
Implementation	Hook , MyWiki
Description	Adds Scripts and Meta data just before the ‎</head> tag of the wiki
Author(s)	JinRyuuNagy StarHeartHunt WikiMANNia (WikiForMentalk)
Latest version	2.1.1 (2023-11-22)
MediaWiki	1.29+
PHP	5.4+
Database changes	No
License	MIT License
Download	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net .
Parameters $wgHeadMetaName $wgHeadMetaCode $wgHeadScriptName $wgHeadScriptCode
Hooks used BeforePageDisplay

The HeaderExtension extension allows Scripts and Meta data to easily be added just before the ‎</head> tag of the wiki.

The code for the head Scripts and Meta data are defined in "LocalSettings.php " and is controlled by variables. This implementation makes it easy for inexperienced users to implement head Scripts and Meta data just before the ‎</head> tag of the wiki. It also makes it possible to add head Scripts and Meta data that cannot be changed or removed, such as would be possible by wiki Administrators if the head Scripts and Meta data were added to the Sitenotice . This makes the extension particularly useful for placing Cookie Consent plugin or CSS style links, as such content cannot be removed by abusive or rogue administrators.

Installation

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

  wfLoadExtension( 'HeaderExtension' );
  

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

Configuration

One or more head scripts can be added to the wiki. The head scripts can consist of any HTML and/or JavaScript .

Scripts

Scheme

To configure the head script, add the following to LocalSettings.php after the installation line:

$wgHeadScriptCode = <<<'START_END_MARKER'
<script></script>
START_END_MARKER;

Leave untouched the first and last line with START_END_MARKER stuff, this is a special syntax of PHP (without it, it would be tricky to deal with apostrophes inside the script). Do not add whitespaces around the last line’s marker, it would break it (more details about this syntax). Do add new line after.

To add additional scripts, simply include them between the markers:

$wgHeadScriptCode = <<<'START_END_MARKER'
<script></script>
<script></script>
<script></script>
START_END_MARKER;

You may specify a name for the script too if needed, add the following after the installation line:

$wgHeadScriptName = 'add_your_script_name_here';

Examples

Example (from Extension:Google Analytics Integration ):

$wgHeadScriptCode = <<<'START_END_MARKER'
<script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
  ga('create', 'UA-xxxxxxxx-xx', 'auto');
  ga('set', 'anonymizeIp', true);
  ga('send', 'pageview');
</script>
START_END_MARKER;
$wgHeadScriptName = 'googleanalytics';

Meta data

Scheme

To configure the head meta data, add the following to LocalSettings.php after the installation line:

$wgHeadMetaName = 'add_your_meta_data_name_here';
$wgHeadMetaCode = 'add_your_meta_data_code_here';

Examples

Example (from Extension:AgeClassification ):

$wgHeadMetaName = 'age-de-meta-label';
$wgHeadMetaCode = 'age=0 hash: yourdigitalcode v=1.0 kind=sl protocol=all';

See also

The extension HeaderExtension combines functionality from

• Extension:AgeClassification
• Extension:HeadScript
• Extension:PCR GUI Inserts