Benutzer:Phorgo/Labor/Hilfe:DPL: Unterschied zwischen den Versionen

Version vom 14. Oktober 2013, 22:53 Uhr

Diese Informationen sind noch nicht aktuell.

DPL steht für DynamicPageList und bezeichnet ein System zur Auflistung von Seiten aus gewählten Namensräumen oder Kategorien.

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.

order

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

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