Template:Extension/de

  {{Documentation|content= {{intricate template}} {{lua|Module:Extension|Module:ExtensionJson|Module:String}} {{Uses TemplateStyles|Template:Infobox/styles.css|Template:Extension/styles.css|Template:Extension/status.css}} Diese Erweiterung sollte für alle Erweiterungs-Seiten in diesem Wiki (jedoch nur für die jeweiligen Hauptseiten) verwendet werden. Sie erzeugt eine nützliche Infobox (siehe unten) und kategorisiert die Erweiterung in {{ll|Category:All extensions}}, zusammen mit den passenden {{ll|Category:Extensions by status|Status-}} und {{ll|Category:Extensions by implementation type|Implementationstypen-}}Kategorien.

{{Clear}}

Verwendung


Inhalts-Parameter
In diesem Abschnitt werden Parameter beschrieben, die den Infobox-Inhalt steuern. Hilfe zu templatemode und anderen Steuerparametern finden Sie unter Steuerparameter. Jeder andere Wert für 'type' ist ungültig und wird dazu führen, dass die Erweiterung in Category:Extensions with invalid or missing type aufgeführt wird.
 *  - verändertes parameterabhängiges Vorlagen-Markup, z.B.
 *  - verändertes XML-Tag-Markup, z.B. 
 *  - verändertes parameterunabhängiges Vorlagen-Markup, z.B.
 *  - Erweiterungen, die standardmäßig nicht vorhandene Wiki-Sytax hinzufügen (d.h. keine Tags, Parserfunktionen, oder Variablen).
 * - für, also Erweiterungen, die Benutzerrechte erstellen, authetifizieren, vergeben oder entziehen oder die Aktivität von Benutzern aufzeichnen. Wenn du eine Zugriffserweiterung geschrieben hast, nutze bitte einen der spezifischeren Typen:
 * - Erweiterungen, die Benutzeraktivitäten aufzeichnen (Logins, Logouts, Benutzerkontenerstellungen, etc.)
 * - Erweiterungen, die Benutzerkonten erstellen oder löschen und/oder die Identität eines Benutzers verifizieren
 * - Erweiterungen für das Rechte-Management, z.B. Änderungen in der Rechtevergabe, API, Entwicklungswerkzeuge (umfasst nicht Erweiterungen, die lediglich Rechte benennen, die für die Nutzung der Funktionen dieser Erweiterung erforderlich sind; nutze für diesen Zweck den Parameter Rechte)
 * - für unkategorisierte Benutzeroberflächenerweiterungen.
 *  - Erweiterungen, die die Einbindung von Multimedia-Inhalten auf Wikiseiten durch die Registrierung einer Datei-Erweiterung mit ermöglichen.
 *  - Erweiterungen, die eine Infrastruktur anbieten, mit der Benutzer ihre MediaWiki-Erfahrungen personalisieren können und/oder bei der Verwaltung dieser Infrastruktur helfen
 * - Erweiterungen, die Emails an Benutzer versenden, Nachrichten übermitteln und andere Formen der Benachrichtigung der Gemeinschaft anbieten
 *  - Erweiterungen, die verbessern oder verändern. Dazu gehört alles, was eine Aktion implementiert, die eine Seite liest, schreibt, sucht, erstellt, umbenennt, löscht, umleitet oder bespricht. Sie tut dies nicht für Rechte (user rights verwenden) oder Protokolle (user activity verwenden).
 * - Erweiterungen, die Suchen durchführen und Seiten für Benutzer auswählen.
 * - Erweiterungen, die CSS oder JavaScript hinzufügen oder Hook-Funktionen zur Änderung des Aussehens über das Skin-Framework implementieren.
 * - Erweiterungen, die Ajax-Programmiertechniken nutzen.
 * - Erweiterungen, die Seiten der -Klasse verwenden, einen ihrer Hooks nutzen oder eine oder mehrere Funktionen aus verändern. Siehe  für weitere Informationen.
 * other
 * - Erweiterungen, die neue API-Module hinzufügen oder existierende API-Kernmodule erweitern.
 * - Hook-Erweiterung - definiert eine neue Hook - siehe hook1, etc. weiter unten, wenn du Hooks definieren möchtest, die von deiner Erweiterung genutzt werden
 * - fügt der Datenbank Tabellen und/oder Felder hinzu, die eine MediaWiki-Installation unterstützen
 * - Daten-Extraktion
 * - Erweiterung, die neue Datei-Repositorien-Typen als Datei-Backend hinzufügt
 * - Keine echte Erweiterung, aber ein Beispiel dafür, wie eine geschrieben wird
 * - Erweiterungen der neuen
 * - Erweiterungen der zugrunde liegenden Programmiersprache.
 * - Erweiterungen, gehörig zu Lokalisierung
 * - Erweiterungen, gehörig zu Lokalisierung

Anmerkung: Viele Erweiterungen haben mehr als einen Typ, wenn dies auf deine Erweiterung zutrifft, ersetze  durch. Du kannst bis zu sechs Typen für eine Erweiterung definieren. hook1 hook2 hook3 hook4 ... Name jedes von der Erweiterung verwendeten Hooks Die Eingabe von Werten in dieses Feld ist eine gute Möglichkeit, um deine Erweiterung bekannt zu machen und anderen Entwicklern zu helfen. Jeder dokumentierte Hook fügt die Erweiterung automatisch einer Kategorie hinzu, in der Erweiterungen aufgelistet sind, die diesen Hook verwenden. Diese Kategorie wird automatisch mit jeder Hook-Seite verknüpft, sodass Programmierer leicht Beispiele für Erweiterungen finden können, die einen bestimmten Hook verwenden.

Für built-in hooks:
 * verwende nur den Hook-Namen. Siehe für Werte (lasse jedoch das einleitende '/' weg).

Für benutzerdefinierte Hooks, die durch Erweiterungen definiert sind:
 * benutze extensionName/hookName. Eine unvollständige Liste der benutzerdefinierten Hooks befindet sich unter Extension hook registry.

Weise bei mehreren Hooks der ersten Hook hook1, der zweiten Hook hook2 und so weiter zu. newhook1 newhook2 newhook3 newhook4 ... newhook90  Name jedes von der Erweiterung bereitgestellten Hooks

Möglicherweise möchtest du die Hooks auch zu Extension hook registry hinzufügen. username  Benutzername des Autors auf MediaWiki.org (wenn er einen hat). Kann weggelassen werden; sofern vorhanden, wird er genutzt, um auf die Benuzerseite und die Diskussionsseite des Autors zu verlinken. Sollte ohne Namensraum und s angegeben werden. Name des Autors der Erweiterung, sofern vom MediaWiki.org-Benutzernamen verschieden. Freier Text. Sofern der Parameter weggelassen wird, wird das Feld 'Benutzername' genutzt (falls vorhanden). description  kurze Beschreibung Screenshot oder Logo der Erweiterung. Sollte ohne Namensraum und s angegeben werden. fakultativ, Größe des Bildes (Standardgröße sind 220px) letzte Version Datum des letzten Updates compatibility policy   (akzeptierte Werte sind master, rel und ltsrel). erforderliche MediaWiki-Version Most extensions should not need to use this — it defaults to the value of the property of. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version. erforderliche PHP-Version bedeutet, dass die Erweiterung die Änderung des Tabellenschemas der Datenbank oder eine ähnliche Aktion erfordert, bevor MediaWiki laufen kann. Dies ist häufig eine Gefahr: MediaWiki wird ins Stocken geraten, wenn du vergisst, update.php laufen zu lassen - wenn die Erweiterung dies erfordert. sollte als Wert gesetzt werden, da so sichergestellt wird, dass die Erweiterung nicht verlangt, dass update.php läuft, wodurch Unsicherheiten vermieden werden

Erweiterungen, die den MediaWiki-Softwarestandards entsprechen, verfügen über ein Skript zum Anpassen des Datenbankschemas, das einmalig manuell ausgeführt werden muss, bevor du MediaWiki starten und über deinen Browser nutzen kannst. Nachdem du alle Dateien der Erweiterung nach  kopiert und   in „LocalSettings.php“ eingefügt hast, führe Folgendes über die Kommandozeile aus:

composer  Der Name des Composer-Pakets der Erweiterung, im. Er wird automatisch eingefügt, wenn er in der "composer.json"-Datei einer Erweiterung festgelegt ist (d. h. dieser Parameter ist in diesem Fall nicht erforderlich). Sie wird mit der Seite der Erweiterung auf Packagist verlinkt. table1 table2 table3 table4 ... table30 Name jeder von der Erweiterung genutzten nicht-Core-Tabelle

Verlinkt auf eine Unterseite deiner Erweiterungsseite. Zum Beispiel verlinkt "table1 = cu_changes" auf nach. Liste keine Core-Tabellen wie oder  auf; liste nur Tabellen auf, die durch die Erweiterungen hinzugefügt werden. Lizenz dieser Erweiterung, Teil des Codes aus https://spdx.org/licenses/, z.B.,   oder  , etc. download  Downloadlink: Git, WikimediaDownload. repo  Name des Gerrit-Repositoriums, in dem der Code der Erweiterung gespeichert ist, sofern vom Seitennamen verschieden. Durch Setzen des Parameters wird automatisch download gesetzt und der Vorlage wird erlaubt, automatisch Daten aus der entsprechenden -Datei zu laden. externer Link auf die readme-Datei, z.B. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README externer Link auf die Änderungslogbuch-Datei, z.B. Extension:XGlossary/Changelog verfügbare Parameter für LocalSettings.php alle Tags, die deine Erweiterung nutzt (z.B. &lt;tag1&gt;, &lt;tag2&gt;). Durch die Erweiterung hinzugefügte Rechte. Nicht zu verwechseln mit der Lizenz! Rechte sind beispielsweise ' oder ', nicht GFDL, LGPL oder GPL - das sind Lizenzen! Namensraum, in dem die Erweiterung genutzt wird Link to user-help for the extension. If not provided, will look for. If provided, full wikitext link should be given (because you may want to link to e.g. an external page). Beispiel, Webseite oder Screenshot der funktionierenden Erweiterung Zusätzliche Kompatibilitätsinformationen, beispielsweise Kompatibilitätstabellen. Es wird empfohlen, auch alle Client-seitigen Kompatibilitätsinformationen hier anzugeben, insbesondere wenn es unterschiedliche Unterstützungen für Browser gibt. Optionaler Parameter, um auf die genaue Seite, auf der (mit der Nachrichtengruppen-ID) die Erweiterung im translatewiki.net übersetzt werden kann, sofern dies aktiviert ist, zu verlinken. Der Standardlink ist falsch und muss manuell geändert werden: Bugzilla Name der MediaWiki-Erweiterungskomponente Phabricator-Projektname überschreibt den Seitennamen, der für den Benutzungsprüfungs-Link verwendet wird.
 * ext-LOWERCASE(NOSPACES(Label wie definiert in )), aka
 * den Parameter, den du in der URL erhältst nach
 * Eingabe des Namens der Erweiterung in die Suche/Filterbox auf translatewiki:Special:Translate oder
 * Suche nach ihrem Namen auf languagestats nach Klicken auf "Alle anzeigen".



Kontrollparameter
gesetzt, da es sich um keine Seite einer Erweiterung handelt und wir diese Seite deshalb nicht dort kategorisieren wollen.
 * nousage - unterdrückt den 'Benutzungsprüfungs'-Link. Der Link wird auch unterdrückt, wenn es sich um eine Unterseite handelt, sich die Seite nicht im Extension-Namensraum befindet oder wenn sie durch 'templatemode=nocats' unterdrückt wird

Wenn dies leer gelassen wird, fügt diese Vorlage die Hostseite zu Category:All extensions und zu einer oder mehreren zusätzlichen Kategorien hinzu, abhängig von den Werten, die den Inhaltsparametern zugewiesen sind.



Benutzung der Infobox


Vorhandene Erweiterungs-Seiten
Wenn du die Infobox zu einer vorhandenen Seite hinzufügen möchten, kopiere den Code und füge ihn oben auf dieser Seite ein.



Erstelle eine neue Erweiterungs-Seite
Wenn du eine neue Erweiterungs-Seite erstellen möchtest, gebe den Namen unten ein und klicke auf die Schaltfläche. Eine neue Seite wird mit der bereits vorhandenen Infobox-Vorlage erstellt.



Verbessere diese Vorlage
Vielen Dank, wenn du diese Vorlage verbessern möchtest! Dies ist eine komplizierte Vorlage, daher hier etwas Hilfe:



Der Knopf zum Erstellen einer Erweiterung
Um das Verhalten des Knopfs zum Erstellen einer Erweiterung zu verbessern:


 * : Die Boilerplate-Erweiterung, die auf den neuen Seiten geladen wird.
 * : Eine Eingabe-Box, die überall eingesetzt werden kann, um Benutzern das einfache Erstellen von Erweiterungen zu ermöglichen. Zur Dokumentation des -Tags, siehe.



Infobox-Parameter
Allgemein:


 * Um die Vorlage einfach benutzen zu können, verlinkt jede Bezeichnung in der Infobox auf die Dokumentation der angezeigten Vorlagenparameter. Wenn du Parameter hinzufügst, stelle bitte sicher, sie auch zur Inhalts-Parameter-Dokumentation hinzuzufügen und von der Bezeichnung auf die Dokumentation zu verlinken.

Um die Implementationstypen-Parameter zu ändern/korrigieren/ergänzen:
 * Überprüfe die Diskussionsseite - über dieses Feld gab es bereits einige ausführliche Diskussionen.
 * Die gültigen Typen und wohin sie verlinken, ist auf Module:Extension definiert

Um das Verhalten der Haupt-Parameter zu ändern:


 * Template:Extension/HookInUse: Fügt Links und Kategorien für die Hook-Nutzung hinzu. Mehrere Hooks sind in dieser Vorlage mit Template:Foreach implementiert.
 * Template:Extension/HookInUseNoCats: Wird anstatt Template:Extension/HookInUse verwendet, wenn die Vorlage in  verwendet wird. Mit Template:Foreach genutzte Vorlagen können nur einen Parameter übernehmen, weshalb wir Template:Extension/HookInUse zusammen mit einer anderen Vorlage verwenden, die den Modus setzt.

<span id="Test_case">

Test
Sieh dir an, ob die folgenden Seiten in Ordnung sind, nachdem du die Vorlage bearbeitet hast.
 * Extension:Description2
 * Template:Extension

}} Maintenance: vulnerabilities, archived