Jump to content

Extension:HeaderExtension

From mediawiki.org
This page is a translated version of the page Extension:HeaderExtension and the translation is 100% complete.
MediaWiki-Erweiterungen
HeaderExtension
Freigabestatus: stabil
Einbindung Hook , MeinWiki
Beschreibung Fügt Skripte und Meta-Daten kurz vor ‎</head> des Wikis hinzu
Autor(en)
Letzte Version 2.1.1 (2023-11-22)
MediaWiki 1.29+
PHP 5.4+
Datenbankänderungen Nein
Lizenz MIT-Lizenz
Herunterladen

  • $wgHeadMetaName
  • $wgHeadMetaCode
  • $wgHeadScriptName
  • $wgHeadScriptCode

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 HeaderExtension im Ordner extensions/ ablegen.
  • Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:
    wfLoadExtension( 'HeaderExtension' );
    
  • Nach Bedarf konfigurieren.
  • Yes 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:

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

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.

Weitere Skripte sind einfach zwischen den Markierungen einzufügen:

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

Bei Bedarf auch einen Namen für das Skript angeben werden, indem nach der Installationszeile Folgendes hinzufügen wird:

$wgHeadScriptName = 'add_your_script_name_here';

Beispiele

Beispiel (aus 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-Daten

Schema

Um die Meta-Daten im Kopfbereich zu konfigurieren, ist Folgendes zu LocalSettings.php nach der Installationszeile hinzuzufügen:

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

Beispiele

Beispiel (aus Extension:Altersklassifizierung ):

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

Siehe auch

Die Erweiterung HeaderExtension kombiniert die Funktionalität von