Handbuch:Erweiterungen

Mit Erweiterungen können Sie das Aussehen und die Funktionsweise von MediaWiki individuell anpassen.

• Wiki-Benutzer können in bestehenden Erweiterungen stöbern.
• Systemadministratoren können Erweiterungen auf den MediaWiki-Installationen, die sie verwalten, entweder installieren oder entfernen.
• Entwickler können neue Erweiterungen schreiben, oder Erweiterungen verbessern oder warten.

Während einige Erweiterungen von den MediaWiki-Entwicklern gepflegt werden, sind andere von Drittanbietern entwickelt worden. Dementsprechend haben viele davon Fehler, und es gibt nicht bei allen eine Garantie, dass sie kompatibel mit anderen Erweiterungen sind. Einige werden auch nicht weiterentwickelt / gepflegt; und nicht alle Erweiterungen funktionieren mit allen MediaWiki-Versionen. Du kannst Erweiterungen, besonders die als unsicher gekennzeichneten, daher nur auf eigenes Risiko einsetzen. Wenn du eine Erweiterung verwendest, die Korrekturen an der Kernsoftware erfordert, solltest du unbedingt ein Backup deiner Datenbank erstellen. Dies hilft, das Risiko zu vermeiden, dein Wiki zu zerstören.

Arten von Erweiterungen

Parser Tags

Parser tags extend the built-in wiki markup with additional capabilities, whether simple string processing, or full-blown information retrieval.

→ Erfahren Sie mehr über Parser Tags

Parserfunktionen

Parser functions are special wiki markup syntax that can 'interact' with other wiki elements in the page, and give a specific output.

→ Erfahren Sie mehr über Parserfunktionen

Hooks

Hooks allow custom code to be executed when some defined event (such as saving a page or a user logging in) occurs.

→ Erfahren Sie mehr über Hooks

Spezialseiten

Special pages are pages that are created by the software on demand to perform a specific function.

→ Erfahren Sie mehr über Spezialseiten

Oberflächen

Skins allow users to customize the look and feel of MediaWiki.

→ Erfahren Sie mehr über Oberflächen

Magische Wörter

Magic words are a technique for mapping a variety of wiki text strings to a single ID that is associated with a function.

→ Erfahren Sie mehr über Magische Wörter

API

MediaWiki provides an action API, a web service that allows access to some wiki-features like authentication, page operations, and search.

→ Erfahren Sie mehr über die MediaWiki-API

Seiteninhaltsmodelle

The ContentHandler introduced in MediaWiki 1.21 makes it possible for wiki pages to be composed of data other than wikitext, such as JSON or Markdown.

→ Erfahren Sie mehr über Inhaltsmodelle

Authentifizierung

MediaWiki provides SessionManager and AuthManager, two authentication-related frameworks to enhance security via custom authentication mechanisms.

→ Erfahren Sie mehr über Authentifizierung

Durchsuchen der Erweiterungen

Sie können die Kategorie:Erweiterungen nach Kategorie durchstöbern, um die gesamte Auswahl an Erweiterungen zu sehen, die bereits geschrieben worden sind. Für Informationen zur Installation dieser Erweiterungen oder das Schreiben eigener, siehe unten.

Überprüfen installierter Erweiterungen

Nur jemand mit Verwaltungszugriff auf das Dateisystem auf einem Server, kann Erweiterungen für MediaWiki installieren, jedoch kann jeder überprüfen, welche Erweiterungen auf einer Instanz von MediaWiki durch Zugriff auf den Spezial:Version-Artikel aktiv sind. Zum Beispiel sind diese Erweiterungen in der deutschen Wikipedia aktiv.

Installieren einer Erweiterung

MediaWiki ist bereit, Erweiterungen direkt nach Abschluss der Installation zu akzeptieren. Um eine Erweiterung hinzuzufügen, folgen Sie diesen Schritten:

1. 'Bevor Sie beginnen'

   Ein paar Erweiterungen erfordern die Installation eines Patches. Viele von ihnen stellen auch für die Installation entworfene Instruktionen zur Verfügung, konzipiert für den Einbau mit UNIX-Befehlen. Sie benötigen Shell-Zugang (SSH), um diese Befehle – die auf den Erweiterungs-Hilfeseiten aufgelistet sind – einzugeben.

2. 'Herunterladen ihrer Erweiterung'.

   Extension Distributor hilft Ihnen, die beliebtesten Erweiterungen auszuwählen und herunterzuladen.

   Erweiterungen werden in der Regel als Modulpakete verbreitet. Sie gehen in der Regel in ihr eigenes Unterverzeichnis von [[Manual:$IP /extensions//de|$IP /extensions/]]/extensions/. Eine Liste der Erweiterungen, die in dem [Special:MyLanguage/Gerrit|Git-Repository] der Wikimedia gespeichert sind, findet man unter git:mediawiki/extensions. Einige Erweiterungen sind als Quellcode in diesem Wiki verfügbar. Sie können sie automatisieren, sie zu kopieren.

   Inoffizielle Softwarepakete der Erweiterungen im Wikimedia SVN-Lager, können auf dem Toolserver gefunden werden.

3. 'Installieren Sie ihre Erweiterung'..

   Füge am Ende der LocalSettings.php -Datei Folgendes hinzu:

   wfLoadExtension( 'ExtensionName' );
   

   Diese Zeile zwingt den PHP-Interpreter, die Erweiterungs-Datei zu lesen und damit MediaWiki zugänglich zu machen.

   Einige Erweiterungen können mit Wartungs-Skripten in Konflikt geraten, beispielsweise, wenn sie direkt auf $_SERVER zugreifen (nicht empfohlen).

   In diesem Fall können sie bedingt gepackt werden, so dass Wartungsskripte trotzdem laufen können.

if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}

Das Wartungsskript importDump.php wird bei jeder Erweiterung scheitern, welches maßgeschneiderte Namensräume erfordert, die innerhalb des bedingten oberhalb inbegriffen sind, wie zum Beispiel Extension:Semantic MediaWiki, Extension:Semantic Forms.

Stellen Sie sicher, dass die erforderlichen Berechtigungen für Erweiterungen gesetzt sind!

Während dieses Installationsverfahren für die meisten Erweiterungen ausreichend ist, erfordern einige ein anderes Installationsverfahren. Überprüfen Sie die Dokumentation ihrer Erweiterung für Details.

Wenn Sie Konfigurationsvariablen in LocalSettings.php verändern wollen, müssen Sie das normalerweise danach einschließlich der Erweiterung tun. Sonst werden die in der Erweiterung definierten Vorgabewerte ihre Einstellungen überschreiben.

Aktualisieren einer Erweiterung

Einige Erweiterungen sind erforderlich aktualisiert zu werden, wann immer Sie MediaWiki aktualisieren werden, während andere mit mehreren Versionen arbeiten. Um auf eine neue Version einer Erweiterung zu aktualisieren:

1. Laden Sie die neue Version der Erweiterung herunter
2. Ersetzen Sie alle Dateien der Erweiterung im extension/ExtensionName Verzeichnis mit den neuen Dateien. Entfernen Sie nicht die bestehende Erweiterungs-Konfiguration in der LocalSettings.php.
3. Wenn die Erweiterung Änderungen an der MediaWiki Datenbank erfordert, müssen Sie eventuell das Update.php Wartungsskript ausführen. Die meisten Erweiterungen werden erwähnen, ob das Skript ausgeführt werden muss oder nicht. (Sichern Sie Ihre Daten, ehe Sie dieses Skript ausführen!). Wenn Sie keinen Kommandozeilen-Zugang haben, können Sie auch den Web-Updater verwenden.

Diese Anleitungen treffen für 99% der Erweiterungen zu. Wenn die spezifische Erweiterung, die Sie aktualisieren, abweichende Anweisungen hat, sollten Sie eher den spezifischen Erweiterungen-Anweisungen folgen.

Deinstallieren einer Erweiterung

Entfernen Sie die Zeile mit dem Namen der Erweiterung aus der LocalSettings.php, um sie zu deinstallieren:

wfLoadExtension( 'ExtensionName' );

• Sie müssen alle Zeilen der Konfiguration der Erweiterung löschen
• Wenn die Erweiterung Änderungen an der Datenbank vorsieht, müssen Sie update.php ausführen, um diese zu entfernen.

Siehe auch

• Kategorie:Erweiterungen
• Vorlage:Erweiterung
• Handbuch: Entwickeln von Erweiterungen
• Handbuch: Erweiterungen übersetzen - Informationen zum Übersetzen von Erweiterungen.