Extension:HeadScript
| HeadScript Release status: stable |
|
|---|---|
| Implementation | Hook |
| Description | Adds scripts just before </head> of the wiki |
| Author(s) | |
| Latest version | 1.1.1 (2021-12-03) |
| MediaWiki | >= 1.29.0 |
| Database changes | No |
| License | MIT License |
| Download | |
|
|
|
| Quarterly downloads | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| Public wikis using | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| Translate the HeadScript extension if it is available at translatewiki.net | |
The HeadScript extension allows scripts to easily be added just before </head> of the wiki.
The code for the head script is defined in "LocalSettings.php" and is controlled by variables.
This implementation makes it easy for inexperienced users to implement head scripts just before </head> of the wiki.
It also makes it possible to add head scripts that cannot be changed or removed, such as would be possible by wiki Administrators if the head script 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
- <translate> [[<tvar name=2>Special:ExtensionDistributor/HeadScript</tvar>|Download]] and move the extracted <tvar name=name>
HeadScript</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
<translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HeadScript - <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php</tvar> file:</translate>
wfLoadExtension( 'HeadScript' );
- Configure as required.
- File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>
Configuration
One or more head scripts can be added to the wiki. The head scripts can consist of any HTML and/or JavaScript.
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 = 'my-wonderful-script';
META and LINK elements can also be added, such as:
$wgHeadScriptCode = <<<'START_END_MARKER'
<meta name="author" content="Wikimedia Foundation" />
<link rel="author" type="text/plain" href="/humans.txt" />
<script></script>
START_END_MARKER;
See also
- Extension:HeaderExtension - Improved code
- Extension:Postscript - append a text or script in last of all artices.
