Daocpedia:DynamicPageList

Aus Daocpedia

Mit der Wiki Erweiterung "DynamicPageList" lassen sich auf Basis von Kategorien Listen von Artikeln erstellen. Dabei kann man einfach definieren, in welchen (auch mehreren!) Kategorien die Artikel sein sollen. All die folgenden Schalter können miteinander kombiniert werden.

Bedienungsanleitung

Natürlich müssen ein paar Dinge definiert werden, z.B. welche Kategorien gewählt sind und ggf weiteres. Diese Punkte werden innerhalb des <DynamicPageList>-Tags definiert:

<DynamicPageList>
...Parameter...
</DynamicPageList>

Kategorien definieren

Kategorien werden mit "category=NAME" definiert, wobei NAME natürlich durch die Kategorie ersetzt werden soll. Dabei können insg. (inkl "notcategory" (siehe unten)) bis zu 9 Kategorien gewählt werden. Es werden dann nur die Artikel angezeigt, die in allen angegebenen Kategorien enthalten sind. Bitte beachte, das mindestens eine Kategorie ausgewählt sein muss. Zum Beispiel:

<DynamicPageList>
category=Hibernia
category=Klassen
</DynamicPageList>

Dies würde eine Liste mit allen Hibernia-Klassen erzeugen.

Kategorien ausschliessen

Es können auch Kategorien ausgeschlossen werden. Dies passiert mit "notcategory=NAME", wobei NAME natürlich durch die Kategorie ersetzt werden soll. Dabei können insg (inkl "category" (siehe oben)) bis zu 9 Kategorien gewählt werden. Es werden dann nur die Artikel angezeigt, die zwar in den "category" Kategorien sind, aber NICHT in den "notcategory" Kategorien. Zum Beispiel:

<DynamicPageList>
category=Hibernia
notcategory=Klassen
</DynamicPageList>

Dies listet alle Hibernia Artikel, ausser den Klassen auf.

Namensraum definieren

Zusätzlich zu den Kategorien kann man noch die Namensräume auswählen, die angezeigt werden sollen. Dies passiert mit "namespace=ID oder NAME", wobei NAME durch den Namensraumnamen oder ID durch die Namensraum ID ersetzt werden sollen. Es werden dann nur Artikel angezeigt, die in der Kategorie UND dem Namensraum sind. Zum Beispiel:

<DynamicPageList>
category=Hibernia
namespace=Portal
</DynamicPageList>

Dies listet alle Artikel auf, die in der Kategorie "Hibernia" sind und dem Namensraum "Portal" angehören.

Namensraum-Prefix ausblenden

Mit dem Schalter "shownamespace=false" kann man die Anzeige des Namenraum-Prefixes ausschalten. Dann wird z.B. aus "Portal:Hibernia" einfach nur "Hibernia" (das "Portal:" fällt weg).

<DynamicPageList>
category=Hibernia
namespace=Portal
shownamespace=false
</DynamicPageList>

Dies listet alle Artikel auf, die in der Kategorie "Hibernia" sind, dem Namensraum "Portal" angehören und blendet den Namensraum-Prefix aus.

Listentyp definieren

Normalerweise werden die Artikel als <ul> (nicht-nummeriert)-Liste ausgegeben. Das heisst mit den viereckigen Punkte vorran. Mit "mode=MODENAME" kann man dies umschalten, dabei ist "MODENAME" natürlich durch den unten definierten Tag zu ersetzten. Wird nichts angegeben, wird automatisch eine nicht nummerierte Liste ausgegeben:

  • mode=unordered -> gibt eine nicht nummerierte Liste aus (<ul>(Standard)
  • mode=ordered -> gibt eine nummerierte Liste aus (<ol>)
  • mode=none -> gibt keine Liste aus. Die einzelnen Artikel werden per <br>-Tab umgebrochen.
  • mode=listed -> gibt eine fortlaufende Liste mit einem "Mittelpunkt" ( · ) aus.
<DynamicPageList>
category=Quest Hibernia
category=Quest Klassik
mode=ordered
</DynamicPageList>

Dies gibt eine Liste mit allen Hibernia Klassik Quests aus. Dabei ist jeder Listenpunkt nummeriert.

Aufsteigend/Absteigend

Normalerweise wird die Liste Alphabetisch von A bis Z sortiert. Doch man kann es ändern. Das tut man am mit "order=RICHTUNG". Dabei wird "RICHTUNG" durch folgendes ersetzt:

  • order=abc -> Aufsteigend sortieren (Standard)
  • order=cba ->> Absteigend sortieren
<DynamicPageList>
category=Quest Hibernia
category=Quest Klassik
order=cba
</DynamicPageList>

Dies erzeugt eine Hibernia Klassik Liste in Alphabetischer, absteigendener Sortierung

Sortieren nach...

Jetzt hast du gelernt, wie du auf oder absteigend sortieren kannst. Doch es gibt noch einen weiteren Schalter für die Liste. Mit "ordermethod=SORTIERUNG" kannst die Liste ganz anders sortieren lassen. Dabei ist SORTIERUNG wieder durch folgendes zu ersetzen:

  • ordermethod=alphabet -> Alphabetische Sortierung (Standard)
  • ordermethod=date -> Sortierung nach der letzten Bearbeitung
<DynamicPageList>
category=Quest Hibernia
category=Quest Klassik
ordermethod=date
</DynamicPageList>

Sortiert die Hibernia Klassik Liste nach der letzen Bearbeitung. Zusammen mit dem "order" Schalter kann die Sortierung umgedreht werden.

Liste beschränken

Normalerweise wird die Liste in ihrem Umfang nicht beschränkt. Doch mit "count=ZAHL" kann man dies einschränken. ZAHL muss natürlich durch die Zahl ersetzt werden:

<DynamicPageList>
category=Quest Hibernia
ordermethod=date
count=10
</DynamicPageList>

Dies zeigt die 10 neuesten Hibernia Quest.

Fehlermeldungen unterdrücken

Stimmt irgendwas mit der Listen-Definition nicht, gibts eine Fehlermeldung. Wird die Liste z.B. in eine Vorlage eingearbeitet, kann das böse enden. Mit "suppresserrors=true" kann man diese Fehlermeldung unterdrücken:

<DynamicPageList>
category=Gibts nicht
suppresserrors=true
</DynamicPageList>

Gibt keine Ausgabe (auch keine Fehlermeldung)

Redirects

Normalerweise werden keine Redirects angzeigt, doch man kann dies mit "redirects=SCHALTER" ändern. Dabei muss SCHALTER durch folgendes ersetzt werden:

  • redirects=exclude -> Schliesst alle redirects aus der Liste aus (Standard)
  • redirects=include -> Zeigt auch redirects an
  • redirects=only -> Zeigt nur redirects an
<DynamicPageList>
category=Hibernia
redirects=include
</DynamicPageList>

Zeigt alle Artikel in der Kategorie Hibernia inklusive aller redirects (da bisher keine redirects kategorisiert wurden (wozu auch) zeigt dieser Schalter keine Funktion)

Datum

Mit "addfirstcategorydate=true" kann man in der Liste vor dem Artikel das Datum anzeigen lassen, andem der Artikel in die Kategorie aufgenommen wurde:

<DynamicPageList>
category=Hibernia
addfirstcategorydate=true
</DynamicPageList>

Zeigt eine Liste aller Hibernia Artikel inkl. dem Datums, andem der Artikel der Kategorie hinzugefügt wurde.