Vorlage:Erweiterung
This template employs intricate features of template syntax.
You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the general sandbox or your user space before changing anything here. |
Benutzt Lua: |
This template uses TemplateStyles: |
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 Kategorie:Alle Erweiterungen , zusammen mit den passenden Status- und Implementationstypen- Kategorien. It autofills some fields of the infobox with extension data collected by wikitech:Tool:Extjsonuploader.
Verwendung
Kopieren und Einfügen: {{Extension |templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |needs-updatephp = |composer = |virtual domain = |table1 = |table2 = |license = |download = |repo = |readme = |changelog = |help = |example = |namespace = |parameters = |tags = |rights = |compatibility = |phabricator = |translate = |vagrant-role = }}Für Hilfe bei den Parameterwerten, siehe unten. |
|
Inhalts-Parameter
In diesem Abschnitt werden Parameter beschrieben, die den Infobox-Inhalt steuern. Hilfe zu templatemode und anderen Steuerparametern finden Sie unter Steuerparameter.
Parameter | Beschreibung |
---|---|
name | Name der Erweiterung |
status |
aktueller Freigabestatus Eine aus:
Wenn der Status anders als oben beschrieben angegeben wird, wird er ignoriert und stattdessen der Standardwert 'Unbekannt' in der Vorlage angezeigt. In Fällen, in denen der Wert weggelassen wird, wird als unbekannt kategorisiert. In Fällen, in denen der Wert ungültig ist, wird in eine spezielle Kategorie einkategorisiert, damit der Fehler gefunden und behoben werden kann. |
type1 type2 type3 type4 type5 type6 | Implementationstyp
Die Implementationsstrategie(n), die in dieser Erweiterung genutzt werden. Dieser Parameter wird genutzt, um Kategorien zu erstellen, die Programmierern helfen, Beispiele für verschiedene MediaWiki-spezifische Implementationsstrategien oder -muster zu finden. Obwohl die Werte dieses Parameters teilweise mit den Benutzungsfällen oder dem Zweck einer Erweiterung übereinstimmen, ist dies nicht der Grund für diesen Parameter. Wenn die von dir für diesen Parameter ausgewählten Werte den Zweck oder mögliche Anwendungsfälle nicht ausreichend angeben, empfehlen wir weitere Kategorielinks. Erlaubte Werte für die Parameter type1, type2, ... sind:
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/de aufgeführt wird. Anmerkung: Viele Erweiterungen haben mehr als einen Typ, wenn dies auf deine Erweiterung zutrifft, ersetze|type= durch |type1=|type2=|type3=... . 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. 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 |
image | Screenshot oder Logo der Erweiterung. Sollte ohne Namensraum und [[]]s angegeben werden. |
imagesize | fakultativ, Größe des Bildes ohne das Hinzufügen von px, z. B. 360 (Standardgröße ist 300px) |
version | letzte Version |
update | Datum des letzten Updates |
version preview | Preview version |
update preview | Date of the last update to the preview version |
compatibility policy | Kompatibilitätsrichtlinie (akzeptierte Werte: master, main, rel, ltsrel). (Rückstand ) |
mediawiki | erforderliche MediaWiki-Version Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version . |
php | erforderliche PHP-Version |
needs-updatephp |
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
$IP steht für den Installationspfad (oder "Verzeichnis") deiner MediaWiki-Installation, dem selben Verzeichnis das die LocalSettings.php , index.php etc. beinhaltet. |
composer | Der Name des Composer-Pakets der Erweiterung, im [1]. 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. |
virtual domain | The virtual database domain used by the extension. |
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 Extension:CheckUser nach Extension:CheckUser/cu_changes table . Liste keine Core-Tabellen wie page oder revision auf; liste nur Tabellen auf, die durch die Erweiterungen hinzugefügt werden. |
license | Lizenz dieser Erweiterung, Teil des Codes aus https://spdx.org/licenses/, z.B. GPL-2.0-or-later , GPL-2.0-only oder GPL-3.0-or-later , etc. |
download | Downloadlink: Git, {{WikimediaDownload/de }}. |
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 extension.json -Datei zu laden. |
readme | externer Link auf die readme-Datei, z.B. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | externer Link auf die Änderungslogbuch-Datei, z.B. Extension:GeoGebra/Changelog |
help | Link to user-help for the extension. If not provided, will look for Help:Extension:ExtensionName . If provided, full wikitext link should be given (because you may want to link to e.g. an external page). |
example | Beispiel, Webseite oder Screenshot der funktionierenden Erweiterung |
namespace | Namensraum, in dem die Erweiterung genutzt wird |
parameters | verfügbare Parameter für LocalSettings.php |
alle Tags, die deine Erweiterung nutzt (z.B. <tag1>, <tag2>). | |
rights | Durch die Erweiterung hinzugefügte Rechte. Nicht zu verwechseln mit der Lizenz! Rechte sind beispielsweise makebot oder desysop , nicht GFDL, LGPL oder GPL - das sind Lizenzen! |
compatibility | 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. |
bugzilla | Bugzilla Name der MediaWiki-Erweiterungskomponente |
phabricator | Phabricator-Projektname |
translate |
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:
|
vagrant-role | MediaWiki-Vagrant role |
CheckUsageNameOverride | überschreibt den Seitennamen, der für den Benutzungsprüfungs-Link verwendet wird. |
Kontrollparameter
Parameter | Beschreibung |
---|---|
templatemode |
Kontrolliert die automatische Kategorisierung der Hauptseite. Normalerweise freigelassen. Alternative Werte 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.
Ein Entwickler, der sein Code im MediaWiki-Coderepositorium teilt, sollte folgendes erwarten:
- Rückmeldung / Kritik / Code-Überprüfungen
- Review and comments by other developers on things like framework use, security, efficiency and usability.
- Developer tweaking
- Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
- Improved access for wiki sysadmins
- If you do decide to put your code on the wiki, another developer may decide to move it to the MediaWiki code repository for easier maintenance. You may then create a Entwicklerkonto to continue maintaining it.
- Zukünftige Versionen von anderen Entwicklern
- New branches of your code being created automatically as new versions of MediaWiki are released. You should backport to these branches if you want to support older versions.
- Incorporation of your code into other extensions with duplicate or similar purposes — incorporating the best features from each extension.
- Credit
- Credit for your work being preserved in future versions — including any merged extensions.
- Similarly, you should credit the developers of any extensions whose code you borrow from — especially when performing a merger.
Any developer who is uncomfortable with any of these actions occurring should not host in the code repository. You are still encouraged to create a summary page for your extension on the wiki to let people know about the extension, and where to download it.
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:
- Template:Extension/Sample : Die Boilerplate-Erweiterung, die auf den neuen Seiten geladen wird.
- Vorlage:Extension/CreateExtensionInputBox : Eine Eingabe-Box, die überall eingesetzt werden kann, um Benutzern das einfache Erstellen von Erweiterungen zu ermöglichen. Zur Dokumentation des
<inputbox>
-Tags, siehe Extension:InputBox .
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
templatemode=nocats
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.
Test
Sieh dir an, ob die folgenden Seiten in Ordnung sind, nachdem du die Vorlage bearbeitet hast.
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Dies ist die TemplateData-Dokumentation für diese Vorlage, die von VisualEditor und weiteren Tools verwendet werden. Extension An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived