Jump to content

Extension:HeaderExtension

From mediawiki.org
This page is a translated version of the page Extension:HeaderExtension and the translation is 96% complete.
Outdated translations are marked like this.
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 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

  • $wgHeaderHeadItems
  • $wgHeaderMetaItems
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 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:

(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