Hilfe:DPL

Stub: Stubbeschreibung notwendig oder Stub entfernen!  

Bei Listen aller Art (momentan aber am wahrscheinlichsten bei Fertigkeitslisten) wird man beim Bearbeiten der Seite auf Abschnitte stoßen, wie

<DPL> category = ... ... allowcachedresults = true </DPL> (Aufruf als Parsererweiterung)

oder

{{#dpl: | category = ... ... | allowcachedresults = true }} (Aufruf als Parserfunktion)

Es handelt sich dabei um die Dynamic Page List-Erweiterung, die in der Regel dazu verwendet wird, Seiten in bestimmten Kategorien als formatierte Liste auszugeben.

In dieser Hilfe sollen nur die Grundlagen erklärt werden und ein paar Beispiele, wie man sie im Wiki findet. Falls man darüber hinaus mehr lernen möchte, steht die (englischsprachige) Anleitung der Erweiterung zur Verfügung.

Allgemeine Funktionsweise

Zwischen die Tags <dpl>...</dpl> gehören eine Anzahl von Parameter = Werte-Paaren, die durch einen Zeilenumbruch getrennt werden. Sie kontrollieren verschiedene Funktionsbereiche:

Auswahl der Seiten (Ergebnisliste)

Parameter die Kriterien angeben, nach denen Seiten ausgewählt werden. Am einfachsten z.B. nach der Mitgliedschaft in bestimmten Kategorien, aber auch Auswahl nach Titel, Links, Verwendung von Vorlagen und mehr.

Auswahl des Inhalts

Welcher Teil der jeweiligen Seite in der Ergebnisliste soll zur Ausgabe zur Verfügung stehen? Bei einfachen Listen z.B. nur der Titel. Bei den Fertigkeitenlisten wird die ganze Infobox ausgewählt (und umgeleitet).

Formatierung

Parameter die angeben, wie der ausgewählte Inhalt der jeweiligen Seite angezeigt werden soll.

Sonstige

Sonstige interessante Einstellungen.

Parameter

Auswahl der Seiten

Argument	Beispiel	Beschreibung
category	Wählt Seiten nach Mitgliedschaft in einer oder mehreren Kategorien aus.
	category=Kategorie1|Kategorie2|Kategorie3	ODER-Verknüpfung: Alle Seiten, die in einer der aufgezählten Kategorien vorkommen.
	category=Kategorie1&Kategorie2&Kategorie3 oder category=Kategorie1 category=Kategorie2 category=Kategorie3	UND-Verknüpfung: Alle Seiten, die in allen aufgeführten Kategorien vorkommen. Zum Kombinieren mit der ODER-Verknüpfung muss die zweite Methode verwendet werden.
	category=*GuildWiki	Mit * vor der Kategorie werden Seiten in direkten Unterkategorien eingeschlossen. Im Beispiel werden alle Seiten in "GuildWiki" und alle Seiten in einer Unterkategorien von "GuildWiki" gewählt.
notcategory	Wählt Seiten die nicht in der angegebenen Kategorieliste vorkommen. Über die UND Verknüpfung mit category kann man so Seiten aus dem Ergebnis von category wieder ausschließen.
	category=Kategorie1|Kategorie2 notcategory=Kategorie3	Alle Seiten, die in "Kategorie1" ODER "Kategorie2" sind, aber NICHT in "Kategorie3".
categorymatch notcategorymatch	Wählt Seiten aus Kategorien, die dem (SQL) Muster entsprechen. % wirkt als Jokerzeichen (steht für beliebig viele beliebige Zeichen). Aufpassen: Unter Umständen bekommt man mit dieser Methode mehr Ergebnisse als man wünscht (oder unerwartete).
	categorymatch=Kategorie%	Alle Seiten, die in "Kategorie1" oder "Kategorie2" oder "Kategorie3" vorkommen und in allen anderen Kategorien, auf die das Muster passt.

Formatierung

Argument	Beispiel	Beschreibung
mode	Kontrolliert das generelle Ausgabeformat. Mögliche Werte: unordered, ordered, none, inline, category und userformat
	category=Kategorie1 mode=unordered	Einfache ungeordnete Liste der Seiten in Kategorie1, wie beim HTML-Tag <ul> oder der Wiki-Syntax mit *. Weiter unterscheiden sich die folgenden Werte nur durch ihre Trennzeichen: ordered - geordnete Liste, wie beim HTML-Tag <ol> oder der Wiki-Syntax mit #. none - getrennt durch einen Zeilenumbruch, wie beim HTML-Tag <br />. inline - Das Trennzeichen in der Liste der Seiten aus Kategorie1 kann über den Parameter inlinetext selbst gewählt werden.
	mode=userformat	Überlässt die Formatierung der Seiten in der Auswahl anderen Parametern üder die der Benutzer mehr Möglichkeiten zur Gestaltung bekommt.

Komplettbeispiele

Fertigkeitenlisten, am Beispiel der Seite: Macht des Herbeirufens-Fertigkeiten
<DPL> category=Macht des Herbeirufens-Fertigkeit notcategory=Historische Inhalte includepage={Infobox Fertigkeit} Kr mode=userformat allowcachedresults=true </DPL>	Auswahl der Seiten: category - Alle Seiten in der Kategorie:Macht des Herbeirufens-Fertigkeit, die aber nicht auch in Kategorie:Historische Inhalte vorkommen (UND-Verknüpfung mit notcategory). Auswahl des Inhalts: includepage - Alle Parameterangaben der Vorlage:Infobox Fertigkeit in der jeweiligen Seite. Diese werden komplett an die Vorlage:Infobox Fertigkeit Kr weitergeleitet und zur Anzeige verwendet. Formatierung: mode - Benutzerdefiniert. Die Formatierung wird in diesem Fall durch die Vorlage:Infobox Fertigkeit Kr übernommen, die durch includepage angesprochen wird. Sonstiges: allowcachedresults - Um den Server zu entlasten wird die Verwendung von Seiten aus dem Cache erlaubt.
Fertigkeitenlisten, am Beispiel der Seite Binderitual
<DPL> category=Binderitual category=Zwiesprache-Fertigkeit notcategory=Historische Inhalte notcategory=Ritualistenfertigkeit (Wintertag) format=,*{{fertigkeit icon|,%TITLE%}}\n, resultsheader='''Zwiesprache'''\n mode=userformat allowcachedresults=true </DPL>	Auswahl der Seiten: category - Alle Seiten in der Kategorie:Binderitual und Kategorie:Zwiesprache-Fertigkeit, die aber nicht auch in Kategorie:Historische Inhalte oder Kategorie:Ritualistenfertigkeit (Wintertag) vorkommen (UND-Verknüpfung mit notcategory). Auswahl des Inhalts: Kein spezieller Parameter, als Standard sind einige Variablen z.B. Seitenname und Titel verfügbar (als %PAGE%, %TITLE%). Formatierung: mode - Benutzerdefiniert. Die Formatierung wird in format angegeben (format=vor Liste,vor Eintrag,nach Eintrag,nach Liste). Hier wird eine ungeordnete Liste mit der Vorlage:Fertigkeit icon erzeugt, indem der Titel über %TITLE% als deren Parameter gesetzt wird. Der Inhalt von resultsheader wird (nur wenn Ergebnisse existieren) über der Liste ausgegeben. Hier wird damit eine Überschrift erzeugt. ("\n" ist ein Zeilenumbruch) Sonstiges: allowcachedresults - Um den Server zu entlasten wird die Verwendung von Seiten aus dem Cache erlaubt.