Hilfe:DynamicPageList

Dies ist eine optionale Erweiterung

Diese Erweiterung ist standardmäßig nicht aktiv. Ihre Aktivierung kann bei einem Wiki-Repräsentanten angefragt werden.

Die DynamicPageList (DPL) ist eine Erweiterung (Extension) für fortgeschrittene Wikis, die es ermöglicht, automatisch generierte Listen aus Artikeln zu erstellen.

Die Erweiterung sucht je nach vorgegebenen Kriterien, wie die Zugehörigkeit zu einer gewissen Kategorie oder die Nutzung einer bestimmten Vorlage, Seiten heraus und listet diese automatisch auf.

DPL kann wegen der enormen Komplexität der Erweiterung zum langsameren Laden von Seiten führen. Darum solltest du auf jeden Fall den Abschnitt über die effektive Nutzung von DPL lesen.

Vorteile von DPL

• Erstellt dynamische Auflistungen von Seiten, basierend auf verschiedenen Parametern, wie z.B. dem Seitennamen, dem Namensraum, der Zugehörigkeit zu einer gewissen Kategorie oder der Benutzung einer bestimmten Vorlage.
  • So kannst du bspw. eine Liste mit allen Seiten in zwei Kategorien, aber in keiner dritten, erstellen.
• Kann Informationen wie das Datum der letzten Bearbeitung, den Benutzernamen des letzten Autors und vieles mehr anzeigen.
• Die Listen können als Tabellen, Aufzählungen, nummerierte Listen, im Kategorieseiten-Stil oder inline angezeigt werden.
• Erlaubt die Erstellung von Listen mit eigenem Style oder Formatierung.

DPL benutzen

Der Code gibt am Ende 10 Ergebnisse aus.

DPL-Abfragen starten mit dem <dpl>-Tag und schließen mit dem </dpl>-Tag. In diesen Tags können Benutzer eine große Anzahl verschiedener Parameter setzen, um die endgültige Liste zu verändern und auf ihre Wünsche anzupassen.
Alternativ kann man auch {{#dpl: .... }} nutzen.

Hier ist ein einfaches Beispiel:

<DPL>
category=Hilfe
</DPL>

Die obige Abfrage würde eine Liste mit Seiten in der Kategorie Hilfe ausgeben.

Dies kann auch noch erweitert werden:

<DPL>
category=Hilfe
notcategory=Benutzer-Hilfe
namespace=Hilfe
mode=ordered
</DPL>

Diese Abfrage würde eine Liste mit Seiten im Hilfe-Namensraum zeigen, die außerdem in der Kategorie Hilfe sind, aber nicht die Kategorie Benutzer-Hilfe haben. Außerdem wäre die Liste sortiert, als ob man den HTML-Tag <ol> benutzen würde, anstatt, wie normalerweise, den <ul>-Tag (unsortiert).

Eine umfassende Liste mit allen DPL-Parametern ist hier zu finden und weitere Informationen zur Erweiterungen können auf der Seite MediaWiki.org gefunden werden.

DPL effektiv nutzen

DPL kann zu langen Ladezeiten führen, die das gesamte Wiki, in dem die Erweiterung genutzt wird, verlangsamen können. Die folgenden Tipps helfen dabei, ein solches Problem zu vermeiden.

Als erstes solltest du abschätzen, ob die Benutzung von DPL wirklich notwendig ist. Wenn es nur benutzt wird, weil es „cool“ ist, solltest du den Benutzern an der Stelle lieber etwas anderes anbieten, wie zum Beispiel Umfragen, Kalender, RSS oder Videos. Wenn du dir nicht sicher bist, ob es eine andere Möglichkeit - ohne die Nutzung von DPL - gibt, lies dir den Abschnitt Einfache Alternativen für DPL-Aufgaben durch und kontaktiere, wenn dir dies nicht hilft, den Support.

Wenn du dich dafür entschieden hast, dass DPL das beste Werkzeug für die Aufgabe ist, lass DPL die Ergebnisse zwischenspeichern (cachen). Füge der Abfrage einfach folgende Zeile hinzu:

allowcachedresults=true

Einfache Alternativen für DPL-Aufgaben

Erstellung einfacher Kategorie-Listen

Zum Erstellen einfacher Kategorie-Listen kannst du den <categorytree>-Tag benutzen (nähere Informationen (englisch)). Wenn du zum Beispiel Seiten in der Kategorie Hilfe aufgelistet bekommen willst, kannst du folgendes machen:

<categorytree mode="pages" hideroot=on>Hilfe</categorytree>

Zufälliger Inhalt

Benutze die RandomSelection-Erweiterung (englisch).

Dinge, die vermieden werden sollten

• Benutze DPL besser nicht für Funktionen, die „randomcount“ brauchen - diese können nicht Zwischengespeichert (gecached) werden.
• Benutze DPL niemals in Vorlagen, die auf ganz FANDOM genutzt werden (Vorlagen in der Community Central, die in anderen Wikis mit {{w:VORLAGENNAME}} eingebunden werden) - Das würde versteckte DPL-Anfragen auf ganz FANDOM verursachen.
• Mache keine zu großen Anfragen - Lass dir keine 500 Ergebnisse zeigen, wenn 20 reichen würden.
• Du solltest vermeiden, mehr als eine - höchstens zwei - DPL-Anfragen pro Seite zu verwenden. - Das würde die Ladezeit der Seite stark verlängern.

Häufige Probleme

• Wenn DPL komische Ergebnisse zeigt, versuche ?action=purge (oder &action=purge, wenn ? schon gebraucht wird) an die URL zu hängen und lade die Seite so neu, um den Cache zu leeren.

Externe Links

• Deutschsprachige Anleitung
• Seite zur Erweiterung bei MediaWiki.org (Deutsche Version)

Mehr Hilfe

• Ein Stichwortverzeichnis zu verschiedensten Hilfeseiten findest du auf Hilfe:Index.
• Einen geordneten Einstieg zur Hilfe gibt es auf der Seite Hilfe:Übersicht.
• Fragen an andere Benutzer kannst du in den Diskussionen des Community-Wikis stellen.
• Anmerkungen zu dieser Hilfeseite kannst du auf der dazugehörigen Diskussionsseite hinterlassen.
• Um Fehler zu melden, kontaktiere bitte einen Ansprechpartner oder nutze das entsprechende Kontaktformular.