Handbuch:Erweiterung/TemplateData

Die Erweiterung TemplateData erleichtert Benutzern das Arbeiten mit Vorlagen. Hier zeigen wir Ihnen, wie Sie mit TemplateData schnell eine Vorlage mit Parametern erstellen können, deren Werte dann von Benutzern leicht über ein Formular eingegeben werden können.

Merkmale von TemplateData

• Tag <templatedata>: Beschreibung von Vorlagen-Parametern (z.B. Beschreibung, Typ, Beschriftung)
• Format: JSON
• Verwaltung: Über "TemplateData"-Dialog im VisualEditor
• Formular: Benutzer erhalten ein Formular zur Dateneingabe

Vorlage beschreiben

Erstellen Sie eine Vorlage mit Parametern. Auf den Wikiseiten, auf denen diese Vorlage eingebunden ist, können dann die Werte für die Parameter eingegeben werden. Damit dies für die Benutzer möglichst einfach ist, beschreiben Sie die Vorlage und die Parameter.

Vorlage vor dem Speichern

Speichern Sie die Vorlage. Nach dem Speichern erscheint die Schaltfläche TemplateData. Klicken Sie auf die Schaltfläche:

Schaltfläche TemplateData

Geben Sie eine Beschreibung für die Vorlage ein und speichern Sie das Formular (1). Klicken Sie erneut auf "Vorlagendaten verwalten". Wählen Sie "Block" als Wikitext-Formatierung (2). Die Parameter werden im Quelltext der Wikiseite übersichtlich im Paragraphen-Format dargestellt.

Bearbeitungsfenster

Der Vorlagen-Editor hat die bereits bestehenden Parameter erkannt. Diese können Sie nun weiter definieren. Klicken Sie also auf "vorgeschlagene Parameter hinzufügen" (3). Anschließend können Sie die Parameter einzeln bearbeiten.

Einzelne Paramter bearbeiten

Klicken Sie auf den ersten Parameter. Das Bearbeitungsformular erscheint.

Parameter bearbeiten

Geben Sie die Informationen für diesen Parameter ein (siehe Beschreibung der Eingabefelder) und klicken Sie anschließend Fertig. Bearbeiten Sie so alle Parameter ihrer Vorlage.

Nachdem alle Parameter beschrieben sind, klicken Sie Anwenden auf der Hauptseite des Vorlagen-Editors. Der Quelltext der Vorlage enthält nun die Vorlagen-Beschreibung in JSON-Format. Damit diese Beschreibung nicht auf den Wikiseiten selbst eingebunden wird, wird es über das Tag ... von der Einbindung ausgeschlossen.

Vorlagenbeschreibung in JSON-Format

Speichern Sie nun die Vorlage. Im Ansichtsmodus wird nun die Beschreibung der Vorlage mit den Parametern angezeigt.

Ausgabe der Vorlagenbeschreibung.

Über der Beschreibung wird die Vorlage selbst angezeigt. Diese Anzeige kann unterbunden werden, indem die Vorlage in das Tag eingeschlossen wird.

Beschreibung der Parameter-Eingabefelder

Key	Type	Default	Description
Name	InterfaceText	null	Ein sehr kurzer Name für den Paramter (z.B. unter 20 Zeichen)
Aliasse	Array containing strings	[]	Liste von Alias-Namen. Ein Alias ist ein alternativer Name für einen Parameter. Er kann anstelle des primären Namens (aber nicht zusätzlich zu ihm) benutzt werden. Alias-Namen sind nicht in einem separaten Parameter-Objekt dokumentiert. Sollten diese mehr information benötigen, sollten sie ihr eigenes Attribut erhalten, das als "veraltet" markiert ist.
Beschreibung	InterfaceText	null	Eine kurze Beschreibung des Parameters, damit Benutzer wissen, welchen sie von einer Auswahlliste auswählen sollen.
erforderlich	boolean	false	Ob der Parameter zwingend angegeben werden muss, damit die Vorlage funktioniert (Wert ist "true" wenn dieser Parameter angegeben werden muss).
vorgeschlagen	boolean	false	Whether the parameter is suggested for the template to be useful (true if this parameter should be specified).
veraltet	boolean or string	false	Whether the parameter is deprecated. The value can be a string of instructions giving the user guidance what instead can be done, or be simply true.
Standard	InterfaceText	null	Der Standardwert, den die Vorlage für diesen Parameter benutzt, wenn kein Wert angegeben wird, oder eine Beschreibung dessen.
Autowert	string	null	A dynamically-generated default value in wikitext, such as today's date or the editing user's name; this will often involve wikitext substitution, such as {{subst:CURRENTYEAR}}.
Beispiel	InterfaceText	null	Beispieltext für den Benutzer, damit ein passender Wert eingegeben wird.
Typ	string	"unknown"	Der Parameter-Typ, als (weicher) Typ-Hinweis. Einer der folgenden: String Value Type of Parameter "unknown" Assumed type if not set "number" Any numerical value (without decimal points or thousand separators) "string" Any textual value. May contain line breaks. "line" Short text field – use for names, labels, and other short-form fields. This is supposed to be text that is not expected to contain line breaks. "boolean" A boolean value ('1' for true, '0' for false, '' for unknown), see three-valued logic. "date" A date in ISO 8601 format, e.g. "2014-05-09" or "2014-05-09T16:01:12Z" "url" A URL, including protocol, e.g. "http://www.example.org", "https://example.org", or "//example.org". "wiki-page-name" A valid MediaWiki page name for the current wiki. Doesn't have to exist, but if not, should be a valid page name which could be created. "wiki-file-name" A valid MediaWiki file name for the current wiki. Doesn't have to exist, but if not, should be a valid file name which could be uploaded. Should not include the namespace (e.g. "Foo.svg" not "File:Foo.svg" or "Bild:Foo.svg"). "wiki-template-name" A valid MediaWiki Template name for the current wiki. "wiki-user-name" A valid MediaWiki user name for the current wiki. Doesn't have to exist, but if not, should be a valid user name which could be created. Should not include the namespace (e.g. "Foo" not "User:Foo" or "Usario:Foo"). "content" Page content in wikitext, such as text style, links, images, etc. "unbalanced-wikitext" Raw wikitext that should not be treated as standalone content because it is unbalanced – for example, templates concatenating incomplete wikitext as a bigger whole, such as {{echo|before=<u>|after=</u>}}

Weiterführende Links

• https://www.mediawiki.org/wiki/Extension:TemplateData/de

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.

Formatierungssprache für Wikiseiten. Der Wikitext kann im Quelltextmodus angesehen und bearbeitet werden.

Ein Uniform Resource Locator (Abk. URL; englisch für „einheitlicher Ressourcenverorter“) identifiziert und lokalisiert eine Ressource, beispielsweise eine Webseite, über die zu verwendende Zugriffsmethode (zum Beispiel das verwendete Netzwerkprotokoll wie HTTP oder FTP) und den Ort (englisch location) der Ressource in Computernetzwerken.

Protokoll zur Verschlüsselung und Authentifizierung der Kommunikation zwischen Webserver und Browser im World Wide Web.

Technische Referenz: TemplateData

---

Feedback zur Dokumentation ist im Community-Forum möglich.