Handbuch:Erweiterungen

Mit Erweiterungen können Sie individuell anpassen, wie MediaWiki aussieht und funktioniert.

• Wiki-Benutzer können in bestehenden Erweiterungen stöbern oder eine neue Erweiterung erbitten.
• Systemadministratoren können Erweiterungen auf den MediaWiki-Installationen die sie verwalten, entweder installieren oder entfernen.
• Developers can write new extensions or improve or maintain extensions.

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 Versionen von MediaWiki. Du kannst Erweiterungen, besonders die als unsicher gekennzeichneten, daher nur auf eigenes Risiko einsetzen. If you are using an extension that requires patches to the core software, be sure to backup your database. This helps avoid the risk of breaking your wiki.

Types of extensions

Parser tags

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

→ Learn more about parser tags

Parser functions

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

→ Learn more about parser functions

Hooks

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

→ Learn more about hooks

Special pages

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

→ Learn more about special pages

Skins

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

→ Learn more about skins

Magic words

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

→ Learn more about magic words

API

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

→ Learn more about the MediaWiki API

Page content models

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.

→ Learn more about content models

Authentication

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

→ Learn more about authentication

Durchsuchen der Erweiterungen

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

Überprüfung von installierten 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 sind in der Regel als modulare Pakete 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'..

   Im Allgemeinen am Ende der LocalSettings.php Datei (aber oberhalb des PHP end-of-Code-Trennzeichen, "?>", falls vorhanden), sollte die folgende Zeile hinzugefügt werden:

   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, zum Beispiel 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 definierten Standardwerte in der Erweiterung, 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.

1. Abhängig von der Erweiterung 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. (Perform backup of your data before executing the script). Wenn Sie keinen Kommandozeilen-Zugang haben, können Sie auch den Web-Updater verwenden.

Diese Anweisungen 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

Remove the line from LocalSettings.php with the extension name to uninstall it:

wfLoadExtension( 'ExtensionName' );

• You must remove any lines pertaining to the configuration of the extension.
• If the extension provides any database changes, you must run update.php to remove them.

Siehe auch

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