Benutzer:Phorgo/Labor/Hilfe:DPL

Eine DPL wird nach folgendem Muster eingebunden:

<dynamicpagelist>
parameter = wert
parameter = wert
parameter = wert
…
</dynamicpagelist>

Falls einer der Parameterwerte mit einem Leerzeichen beginnt oder endet, muss dieses durch __S ersetzt werden, da jeglicher Leerraum am Anfang und am Ende abgeschnitten wird.

Unter Umständen muss bei den Formatierungsparametern mal ein Zeilenumbruch gesetzt werden. Da Zeilenumbrüche als Parametertrenner dienen, muss stattdessen __N geschrieben werden – anders als bei Leerzeichen auch innerhalb eines Parameterwertes.

Für den unwahrscheinlichen Fall, dass eine dieser beiden Zeichenfolgen mal literal, also ohne technische Bedeutung, als Fließtext dargestellt werden soll, kann man mit __U einen Unterstrich erstellen. __U_S wird folglich zu __S.

Seiten auswählen

Es gibt mehrere Parameter, mit denen man die anzuzeigenden Seiten eingrenzen kann. Grundsätzlich muss jedoch mindestens einer der Parameter namespace, category oder regex angegeben werden.

namespace

Schränkt die Liste auf Seiten im angegebenen Namensraum ein. Dieser Parameter kann nur einmal gesetzt werden und erfordert als Wert die ID des jeweiligen Namensraums. Diese sind auf Stupidedia:Namensräume aufgelistet. Namensräume mit negativer ID, sogenannte virtuelle Namensräume, werden von der DPL nicht akzeptiert.

category

Listet nur Seiten, die sich in der angegebenen Kategorie befinden. Gibt man diesen Parameter mehrfach an, müssendie Seiten in allen angegebenen Kategorien stehen.

Das Präfix Kategorie: ist erforderlich, falls der Kategorienname mit einem Namensraumpräfix beginnt. category = Nazischeiße funktioniert also, category = Stupidedia:Hammer-Artikel muss jedoch als category = Kategorie:Stupidedia:Hammer-Artikel geschrieben werden.

notcategory

Seiten, die sich in dieser Kategorie befinden, werden nicht gelistet. Dieser Parameter kann auch mehrfach notiert werden. In dem Fall werden alle Seiten ignoriert, die sich in mindestens einer der angegebenen Kategorien befinden.

Für Kategorien, die mit einem Namensraumpräfix beginnen, gelten die gleichen Regeln wie beim Parameter category.

regex

Es werden nur Seiten gelistet, auf die der angegebene reguläre Ausdruck zutrifft. Der Ausdruck ist case-sensitive und gilt für den Seitentitel ohne Namensraumpräfix. Fehlerhafte Ausdrücke verursachen einen Matrixfehler, der jedoch ohne weitergehende Folgen bleibt.

redirects

Gibt an, wie Weiterleitungen behandelt werden sollen:

• exclude: Weiterleitungen werden nicht gelistet. Das ist die Standardeinstellung.
• include: Alle Seiten werden angezeigt, ob Weiterleitungen oder nicht.
• only: Es werden nur Weiterleitungen in die Liste aufgenommen.

count

Legt fest, wie viele Ergebnisse angezeigt werden sollen. Dies können maximal 200 sein.

offset

Falls die Listeneinstellungen mehr Seiten erfassen, als count ermöglicht, kann man mit diesem Parameter eine beliebige Anzahl Seiten am Anfang der Liste ausschließen. offset = 200 zeigt erst Seiten ab ausschließlich Nr. 200.

Sortierung

Eine DPL kann nach verschiedenen Kriterien sortiert werden.

ordermethod

Legt das Sortierkriterium fest. Dabei sind folgende Werte möglich:

• categoryadd: Sortiert die Seiten nach dem Zeitpunkt, zu dem sie in die erstdefinierte Kategorie eingefügt wurde. Funktioniert nur, wenn eine Kategorie angegeben wurde.
• created: Die Seiten werden nach ihrem Erstellungsdatum respektive ihrer ID sortiert.
• lastedit: Sortiert nach dem Zeitpunkt der letzten Bearbeitung.
• length: Sortiert nach der Seitenlänge in Bytes.
• popularity: Die Seiten werden nach der Anzahl ihrer Aufrufe sortiert.
• sortkey: Sortiert nach dem Kategoriensortierungsschlüssel. Funktioniert nur, wenn eine Kategorie angegeben wurde und ist in den meisten Fällen identisch mit der Sortierung nach Titel.
• title: Sortiert die Seiten nach ihrem Titel ohne Namensraumpräfix. Dies ist die Standardeinstellung.
• awards: Sortiert nach Awards, entsprechend ihrer Gewichtung. Hat nur einen Effekt, wenn eine Gewichtung festgelegt ist (wie z.B. beim Daumen).
• random: Zufällige Sortierung.

order

Legt fest, ob die Seiten aufsteigend oder absteigend sortiert werden sollen.

• ascending sortiert die Seiten aufsteigend nach dem angegebenen Sortierkriterium.
• descending sortiert absteigend.

Formatierung

Es gibt diverse Möglichkeiten, eine DPL zu formatieren. Neben einigen vordefinierten Formatierungen kann man auch selber welche erstellen.

mode

Legt die Formatierungsbasis fest. Dies können folgende sein:

• gallery: Formatiert die Liste als Galerie, was natürlich nur bei Dateilisten Sinn macht.
• inline: Die Seiten werden in einer Zeile dargestellt und mit Kommata voneinander getrennt.
• none: Trennt die Listenelement mit br-Tags, also einfachen Zeilenumbrüchen voneinander.
• null: Gar nichts, die Seiten stehen nebeneinander wie die Pendler in der U-Bahn.
• ordered: Darstellung als geordnete Liste, entspricht einem # am Anfang einer Zeile.
• unordered: Wie ordered, nur ungeordnet, also * statt #. Dies ist der Standard.

Die folgenden fünf Parameter überschreiben mode. Sie dienen dazu, die DPL exakt zu formatieren und sind folgendermaßen zu verstehen:
startliststartitemSeiteenditemitemseparatorstartitemSeiteenditemitemseparatorstartitemSeiteenditemitemseparatorstartitemSeiteenditemitemseparatorstartitemSeiteenditemendlist

Im Fall von mode = unordered sieht das so aus (itemseparator ist dabei nicht vorhanden):
<ul><li>Seite</li><li>Seite</li><li>Seite</li><li>Seite</li><li>Seite</li></ul>

startlist

Wikicode, der sich am Anfang der Liste befindet.

endlist

Wikicode am Ende der Liste, der mit startlist die Liste umfasst.

startitem

Dieser Kram befindet sich vor jedem einzelnen Listenelement.

enditem

Das befindet sich am Ende jedes Listenelements

itemseparator

Wikicode, der sich zwischen den einzelnen Listenelementen befindet. Nützlich für z. B. Zeilenumbrüche oder Kommata.

addfirstcategorydate

Fügt hinter dem Link zur Seite das Datum, an dem die Seite in die zuerst angegebene Kategorie eingeordnet wurde, hinzu. Kann true, ISO 8601 oder ein aus y, m und d bestehendes Datumsformat sein. Ist standardmäßig false, das Datum wird also nicht angezeigt.

shownamespace

Legt fest, ob das Namensraumpräfix mit angezeigt werden soll. Ist standardmäßig true, auf false setzen, damit das Präfix ausgeblendet wird.

unlink

Auf einen beliebigen Wert außer false setzen, damit die Seiten nicht verlinkt werden. Nützlich für erweiterte Formatierungen unter Zuhilfenahme von Vorlagen.

suppresserrors

Auf beliebigen Wert setzen, damit Meldungen im Falle eines Fehlers oder einer leeren Ergebnismenge nicht angezeigt werden.

message

Damit kann man eine spezielle Fehlermeldung für eine leere Ergebnismenge definieren. Diese beginnt immer mit intersection_noresults- und liegt im MediaWiki-Namensraum. Ist dieser Parameter nicht gesetzt, wird MediaWiki:Intersection noresults verwendet.