Manual:Parser functions/de



Parserfunktionen, die in MediaWiki 1.7 hinzugefügt wurden, sind eine Art Erweiterung, die eng mit dem Parser integrieren. Der Begriff Parserfunktionen, sollte nicht mit Erweiterung:Parserfunktionen verwechselt werden, das ist eine Sammlung von einfachen Parserfunktionen.

Beschreibung
Tag-Erweiterungen sind integriert, um unverarbeiteten Text mitzunehmen und ihn als HTML zurück zu geben; sie haben sehr wenig Integration mit dem Rest des Parsers. Zum Beispiel kann die Ausgabe einer Tag-Erweiterung nicht als Vorlagenparameter verwendet werden. Ferner ist es möglich Vorlagen innerhalb einer Tag-Erweiterung auszubauen, aber es muss manuell erfolgen &mdash; ein fehleranfälliger Prozess, der sich von Version zu Version ändert.

Die typische Syntax für eine Parserfunktion lautet:

Erstellen einer Parserfunktion ist etwas komplizierter als die Schaffung eines neuen Tag, weil der Name der Funktion ein magisches Wort sein muss — ein Schlüsselwort, das Aliases und Lokalisierung unterstützt.

Einfaches Beispiel
Unten ist ein Beispiel von einer Erweiterung, die eine Parserfunktion erstellt.

Diese Datei sollte ExampleExtension.php genannt werden, wenn der Name Ihrer Erweiterung ExampleExtension ist :

Eine weitere Datei, ExtensionName.i18n.magic.php, sollte enthalten:

Mit dieser Erweiterung aktiviert,



produziert:


 * param1 ist hallo und param2 ist hi

Mehr Funktionen
Für mehr Funktionen, können Sie die Hook-Funktionen in eine _body.php oder Hooks.php Datei aufteilen und statische Funktionen von einer Klasse machen.

Dann können Sie die Klasse mit $wgAutoloadClasses laden und rufen die statischen Funktionen in den Hooks, z.B.:

Setzen Sie diese in Ihre  Datei:

Dann setzen Sie diese in Ihre   Datei:

Zwischenspeicherung
Wie bei Tag-Erweiterungen, $parser->disableCache kann verwendet werden, um den Zischenspeicher (Cache) für dynamische Erweiterungen zu deaktivieren.

Siehe auch

 * Handbuch Erweiterungen
 * Handbuch Tag-Erweiterungen
 * Handbuch Magische Wörter
 * Handbuch Parser.php
 * Erweiterungen FAQ (engl.)
 * Hilfe:Erweiterung:Parserfunktionen
 * Die Parserfunktionen Erweiterung ist eine bekannte Sammlung von Parserfunktionen.