Extension:HeaderExtension
Freigabestatus: stabil |
|
|---|---|
| Einbindung | Hook, MeinWiki |
| Beschreibung | Fügt Skripte und Meta-Daten kurz vor </head> des Wikis hinzu |
| Autor(en) |
|
| Letzte Version | 3.1.0 (2026-04-22) |
| Kompatibilitätspolitik | Der Master behält die Abwärtskompatibilität bei. |
| MediaWiki | 1.35+ |
| PHP | 7.3.19+ |
| Datenbankänderungen | Nein |
|
|
|
| Licence | MIT-Lizenz |
| Herunterladen | README CHANGELOG |
Die Erweiterung HeaderExtension ermöglicht das einfache Hinzufügen von Skripten und Meta-Daten kurz vor </head> des Wikis.
Der Code für Skripte und Meta-Daten im Kopf-Bereich ist in "LocalSettings.php" definiert und wird durch Variablen gesteuert.
Diese Implementierung macht es unerfahrenen Benutzern leicht, Skripte und Meta-Daten kurz vor </head> des Wikis einzufügen.
Es ermöglicht auch das Hinzufügen von Skripten und Meta-Daten im Kopf-Bereich, die nicht geändert oder entfernt werden können, wie es bei Wiki Administratoren möglich wäre, wenn Skripte und Meta-Daten zu Sitenotice hinzugefügt würde.
Dies macht die Erweiterung besonders nützlich für die Platzierung von Cookie-Consent-Plugins oder CSS-Links, da solche Inhalte nicht von missbräuchlichen oder bösartigen Administratoren entfernt werden können.
Installation
- Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens
HeaderExtensionim Ordnerextensions/ablegen. - Folgenden Code am Ende deiner LocalSettings.php-Datei einfügen:
wfLoadExtension( 'HeaderExtension' );
- Nach Bedarf konfigurieren.
Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.
Konfiguration
Ein oder mehrere Skripte können in dem Head-Bereich des Wikis hinzugefügt werden. Die Skripte im Head-Bereich können aus beliebigem HTML und/oder JavaScript bestehen.
Skripte
Schema
Um das Head-Skript zu konfigurieren, ist zu LocalSettings.php nach der Installationszeile hinzuzufügen:
(Since Version 3.1)
$wgHeaderHeadItems = [
'<script>Script example 1 here</script>',
'<script>Script example 2 here</script>'
];
Die erste und letzte Zeile mit dem START_END_MARKER-Zeug sollte unangetastet bleiben, dies ist eine spezielle Syntax von PHP (ohne sie wäre es schwierig, mit Apostrophen innerhalb des Skripts umzugehen). Es dürfen keine Leerzeichen um die Markierung der letzten Zeile eingefügt werden, das würde sie umbrechen (weitere Einzelheiten zu dieser Syntax). Zum Abschluss eine "Neue Zeile" einfügen.
Beispiele
Beispiele:
$_GoogleAnalyticsId = 'your_code';
$wgHeaderHeadItems = [
'<script async src="https://www.googletagmanager.com/gtag/js?id=' . $_GoogleAnalyticsId . '"></script>',
'<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag("js", new Date());
gtag("config", "' . $_GoogleAnalyticsId . '");
</script>',
'<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=' . $_GoogleAnalyticsId . '" height="0" width="0" style="display:none;visibility:hidden"></iframe>'
];
$wgHeaderHeadItems = [
'<meta name="robots" content="noarchive" />'
];
Meta-Daten
Schema
Um die Meta-Daten im Kopfbereich zu konfigurieren, ist Folgendes zu LocalSettings.php nach der Installationszeile hinzuzufügen:
(Since Version 3.1)
$wgHeaderMetaItems[ 'meta_key_1' ] = 'Meta example 1 here';
$wgHeaderMetaItems[ 'meta_key_2' ] = 'Meta example 2 here';
Beispiele
Beispiel (aus Extension:Altersklassifizierung):
$wgHeaderMetaItems = [
[ 'age-de-meta-label', 'age=0 hash: yourdigitalcode v=1.0 kind=sl protocol=all' ],
[ 'robots', 'noarchive' ]
];
Siehe auch
Die Erweiterung HeaderExtension kombiniert die Funktionalität von
