Handbuch:Erweiterungen

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Manual:Extensions and the translation is 85% complete.

Outdated translations are marked like this.
Other languages:
العربية • ‎български • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎español • ‎français • ‎magyar • ‎Bahasa Indonesia • ‎日本語 • ‎한국어 • ‎polski • ‎پښتو • ‎português do Brasil • ‎русский • ‎سنڌي • ‎ไทย • ‎Türkçe • ‎中文
Gnome-preferences-other.svg Erweiterungen:Manual:Extensions EntwicklungManual:Developing extensions Tag extensionsManual:Tag extensions Handbuch:Parser functionsManual:Parser functions HooksManual:Hooks SpezialseitenManual:Special pages Handbuch:SkinsManual:Skins Handbuch:Magische WörterManual:Magic words APIAPI:Extensions

Was sind Erweiterungen?

MediaWiki 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. Entwickler können neue Erweiterungen schreiben oder bestehende Erweiterungen verbessern.

Suche die Erweiterungen nach Stichwort(en):

Abhängig von Ihren Zielen, können Sie Erweiterungen benutzen zum:

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. Wenn du eine Erweiterung einsetzen möchtest, die Veränderungen am Kern-Code (Core) von MediaWiki oder an der Datenbank erfordern, sorge dafür, dass du vor dem Einspielen ein Backup der Datenbank und / oder des Kern-Codes hast, um das Risiko eines dauerhaften Schadens an deinem Wiki zu vermeiden.

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:$IPManual:$IP/extensions//de|$IPManual:$IP/extensions/]]/extensions/. Eine Liste der dokumentierten Erweiterungen ist auf der Erweiterungsmatrix auf MediaWiki.org verfügbar und eine Liste der Erweiterungen, abgelegt im Wikimedia SVN-Lager befindet sich unter svn:trunk/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:
    // mw.v 1.24.x or less
    require_once "$IP/extensions/extension_name/extension_name.php";
    // mw.v 1.25.x or above
    wfLoadExtension( '<extension-name>' );
    
    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.
//for mw.v 1.24.x or less
if ( !$wgCommandLineMode ) {
   require_once "$IP/extensions/extension_name/extension_name.php";
}
//for mw.v 1.25.x or above
if ( !$wgCommandLineMode ) {
   wfLoadExtension ( '<extension-name>' );
}

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.
Achtung! Achtung: Während die Erweiterungs-Deklaration an anderen Stellen in der LocalSettings.php Datei platziert werden kann, sollten Sie nie Erweiterungen vor der require_once "includes/DefaultSettings.php"; Linie platzieren (für MediaWiki-Versionen vor 1.17). Dadurch werden die Erweiterung Setup-Funktion Arrays geleert, so dass keine Erweiterungen installiert werden soll, und wahrscheinlich wird Ihr Wiki unzugänglich, bis Sie es bereinigen!


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. 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. (Running the update.php script when its unnecessary will not hurt anything, so if you're unsure don't be afraid to run it). Wenn Sie keinen Kommandozeilen-Zugang haben, können Sie auch den Web-Updater verwenden.
  4. Das ist alles, was Sie tun müssen. In den meisten Fällen wird jede Erweiterungskonfiguration, die Sie in der LocalSettings.php haben, auch mit der neueren Version der Erweiterung arbeiten.
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

Erweiterungen werden installiert, indem man eine Zeile in die Datei LocalSettings.php einfügt, was im Prinzip so aussieht:

// mw.v 1.24.x or less
require_once "$IP/extensions/extension_name/extension_name.php";
// mw.v 1.25.x or above
wfLoadExtension( '<extension-name>' );
Abhängig von der jeweiligen Erweiterung müssen bei der Installation gegebenenfalls noch weitere Dinge durchgeführt werden, die jetzt bei der Deinstallation entsprechend rückgängig gemacht werden müssen. For details see the section on installing an extension.
  1. Remove this line and the extension is uninstalled. If you want to, you can (and if you do not want to use this extension in the future you should) remove the files of this extension inside the folder "extensions/".
  2. Maybe you also have some other lines in LocalSettings.php, which have to do with the extension you want to remove. Most likely this will be lines, which give certain users the right to access pages, which are provided by the extension. These lines contain the variable "$wgGroupPermissions" and make some settings there. As far as they have to do with rights, which come from the removed extension, you can remove these lines as well.
  3. Maybe your extension also has added columns to your database. The updater maintenance/update.php removes them, when you run it, after you have uninstalled the extension.

Entwickeln von Erweiterungen

Dieses komplexe Thema wird auf der Hilfeseite Entwicklung von Erweiterungen behandelt.

Siehe auch

ErweiterungenManual:Extensions: Kategorie[[::Category:Extensions]]Alle[[::Category:All extensions]]AnfragenTag extensionsManual:Tag extensionsErweiterungen FAQExtensions FAQHookregister - ErweiterungStandardnamensraum - Erweiterung