Extension:DynamicPageList (Wikimedia)/de


 * Diese Erweiterung wird von Wikimedia verwendet. Bitte nicht verwechseln mit der Erweiterung oder .

Mit der Erweiterung "DynamicPageList" können Wiki-Benutzer eine Liste von Seiten erstellen, die in einer Reihe von Kategorien gelistet sind. Allgemeine Informationen findest Du unter Handbuch:Hilfe:DPL.

Ursprung
Es wurde ursprünglich für Wikinews entwickelt. Es ist derzeit in allen Wikinews-Projekten installiert (siehe n: Wikinews: DynamicPageList), Meta, Wikibooks und Wikiversity und kann in allen kleinen und mittleren Wikis installiert werden. Skalierbarkeitsprobleme mit sehr großen Wikis sind bekannt.

Diese Erweiterung war früher als DynamicPageList/old und später als Intersection bekannt. Möglicherweise interessierst Du Dich auch für die DynamicPageList von einem Drittanbieter, die über weitere Funktionen verfügt.

Konfiguration
Die Erweiterung unterstützt auch einige Konfigurationsvariablen. Normalerweise wirst Du die Standardeinstellung nicht ändern wollen, aber wenn Du dies tust, kannst Du sie nach der require_once-Zeile zu Deiner "LocalSettings.php" hinzufügen. Hier sind die unterstützten Konfigurationsvariablen mit ihren Standardwerten:

Verwendung
DynamicPageList kann in der Wiki-Bearbeitungsansicht mit XML-ähnlicher Syntax verwendet werden. Die Parameter steuern den Listen-, Ordnungs- und Anzeigemodus der Seiten. In den folgenden Abschnitten findest Du Informationen zu den einzelnen Parametern. Nachfolgend sind zum Beispiel die ältesten fünf Seiten in diesem Wiki, die kürzlich nach MediaWiki.org verschoben wurden.

 category            = Pages recently transferred from Meta count               = 5 order               = ascending addfirstcategorydate = true 

Beispiel für eine besonders komplexe DynamicPageList:

 category=foo count=20 namespace=file addfirstcategorydate=ymd imagewidth=70 galleryshowfilesize=yes galleryshowfilename=yes imagesperrow=7 gallerycaption=Galleries! ordermethod=sortkey order=ascending mode=gallery offset=12 

Listet die 12. bis 34. Seite im Dateinamensraum auf, die sich ebenfalls in der Kategorie foo befinden, und formatiert sie in eine Bildergalerie mit dem Datum, an dem sie der Kategorie foo in der Beschriftung im Format Jahr, Monat, Tag hinzugefügt wurden, und zwar mit einer Bildbreite von 70px

Parameter: category
Der Parameter categories listet Kategorien auf, die sich überschneiden sollen. DynamicPageList listet Seiten auf, die in "allen" aufgelisteten Kategorie gefunden wurden. Eine minimale und maximale Anzahl der aufzulistenden Einträge wird im Quellcode der Erweiterung festgelegt. Du kannst magic words wie August im Kategorienamen verwenden.

Die Syntax ist

 category = Demo category = Demo 1 

Parameter: notcategory
notcategory beschränkt die Liste der Seiten auf diejenigen, die nicht in einer bestimmten Kategorie einsortiert sind. Du kannst magic words wie August im Kategorienamen verwenden.

 category   = Demo notcategory = Demo 1 

Parameter: namespace
Der Parameter namespace schränkt die Liste der oben angegebenen Seiten auf die in einem bestimmten Namensraum angegebenen Seiten ein (siehe Liste der Standard Namensräume). Jeder ungültige Name entspricht dem Namensraum des Hauptartikels.

 category = Demo namespace = Help 

Parameter: redirects
redirects legt fest, ob Weiterleitung von Seiten eingefügt werden soll. Der Wert kann exclude (Standardeinstellung: keine Weiterleitungen auflisten), include (Weiterleitungen auflisten) oder only (keine Seiten auflisten, die keine Weiterleitungen sind) sein.

 category = Demo redirects = only 

stablepages (Stabile Seiten)
stablepages legt fest, ob stabile (markierte) Seiten bei Verwendung von Erweiterung:FlaggedRevisions einbezogen werden sollen. Der Wert kann "ausschließen" (nicht auflisten), "einschließen" (stabile und nicht stabile Seiten auflisten) oder "nur" (nur stabile Seiten auflisten) sein. Erfordert, dass FlaggedRevs installiert ist, um zu funktionieren.

qualitypages (Qualitätsseiten)
qualitypages legt fest, ob bei Verwendung von Erweiterung: FlaggedRevisions Qualitätsseiten (gekennzeichnet auf der Ebene 'Pristine') einbezogen werden sollen. Der Wert kann "exclude" (nicht auflisten), "include" (sowohl Qualitätsseiten als auch Nichtqualitätsseiten auflisten) oder "only" (nur Qualitätsseiten) sein.

Hinweis: Die Auswirkung von qualitypages wurde gegenüber älteren Versionen geändert. In älteren Versionen wird qualitypages=exclude automatisch in stablepages=only umgewandelt. Dies erfolgt nicht mehr.

Parameter: count
count schränkt die Anzahl der angezeigten Ergebnisse ein. Standardmäßig werden die der zuletzt hinzugefügten Kategorie hinzugefügten Seiten angezeigt (siehe order). Beachte, dass die Erweiterung nicht mehr Ergebnisse, als die im Quellcode der Erweiterung definierte maximalen Anzahl der Seiten auflistet.

 category = Demo count   = 2 

offset
Mit offset beginnt die Liste an einer anderen Stelle als mit der ersten Seite der Liste. Dies kann zum Beispiel mit count verwendet werden, um mehrspaltige Layouts zu erstellen.

 category = Demo offset   = 2 

Spalten-Beispiel

Parameter: shownamespace
In shownamespace verhindert der Parameter "false" die Ausgabe der Namensraum-Bezeichnung. Wenn der Parameter "true" angegeben ist (Grundeinstellung), wird sie angezeigt.

 category     = Demo shownamespace = false </DynamicPageList>

Parameter: addfirstcategorydate
addfirstcategorydate zeigt das Datum an, an dem ein Artikel zur Kategorie hinzugefügt wurde. Der Wert kann "true" (Datum anzeigen), "false" (Standardeinstellung: Datum nicht anzeigen) oder eine Datumsbezeichnung (ymd, md, dm, dmy, mdy und ISO 8601) sein. Wenn viele Kategorien angegeben sind, wird die erste Kategorie verwendet. Den verlinkten Seitennamen wird das Datum vorangestellt, das gemäß Deinen lokalen MediaWiki-Einstellungen für die Datumsanzeige formatiert ist.

 category            = Demo addfirstcategorydate = true </DynamicPageList>

Parameter: mode
Für mode (Ausgabemodus)' ist einer der folgenden Parameter möglich:
 * unordered — Liste mit Aufzählungszeichen
 * ordered — Liste mit Nummerierung
 * none — Einfache Links mit Zeilenumbruch
 * gallery — Bildergallerie, wie
 * inline — Liste, mit Kommata getrennt

unordered:  category = Demo mode    = unordered </DynamicPageList>

Bestellt

 category = Demo mode    = ordered </DynamicPageList>

Einfache Links:

 category = Demo mode    = none </DynamicPageList>

Inline:

 category = Demo mode    = inline </DynamicPageList>

mode=gallery
"gallery" ist ein spezieller Modus, in dem die Ausgabe eine Bildergalerie ist. Wenn Du diesen Modus verwendest, möchtest Du normalerweise die Bezeichnung auf die Bildbreite beschränken.

 category = Demo mode    = gallery namespace= file </DynamicPageList>

Der gallery-Modus unterstützt auch die Optionen imagewidth (wie breit die Bilder in der Galerie sein sollen: möglicherweise musst Du hierbei auch die Bildhöhe (imageheight) festlegen), imageheight (Bildhöhe: wie hoch das Bild sein sollte) galleryshowfilesize (Bildgröße anzeigen, wie auf Kategorieseiten), galleryshowfilename (Dateinamen anzeigen, wie auf Kategorieseiten), imagesperrow (Anzahl der Bilder pro Zeile in der Galerie), gallerycaption (Bildunterschrift für die Galerie).

"addfirstcategorydate" zeigt das Datum an, an dem der Artikel zu der ersten in der DPL-Schleife genannten Kategorie hinzugefügt wurde.

Hinweis: gallerycaption akzeptiert derzeit keine Links. (Aber Angaben wie August sind zulässig.)

Ein komplexes Beispiel für eine gallery kann wie folgt aussehen:

 count=20 namespace=file addfirstcategorydate=ymd imagewidth=70 galleryshowfilesize=yes galleryshowfilename=yes imagesperrow=7 gallerycaption=Look at my pretty gallery. mode=gallery shownamespace=false </DynamicPageList>

Parameter: suppresserrors
suppresserrors erlaubt beim Wert "true" die Unterdrückung von Fehlermeldungen. Der Wert "false" (Grundeinstellung) erlaubt die Anzeige von Fehlermeldungen.

true:  category      = Dem suppresserrors = true </DynamicPageList>

false:  category      = Dem suppresserrors = false </DynamicPageList>

nofollow
nofollow setzt  auf die Links. Dadurch wird verhindert, dass Suchmaschinen/Robots über den Link von DynamicPageList auf die Seite gelangen. Im Allgemeinen ist dies nutzlos, da Suchmaschinen die Seite von anderen Links aus entweder indizieren können oder aufgrund von robots.txt/ es nicht tun. Im Allgemeinen solltest Du diese Option nur verwenden, wenn Du weißt, was Du tust, und wenn Du einen guten Grund dafür hast. Der Hauptnutzen besteht darin, dass Google News in den englischen Wikinews alles, was von der Hauptseite verlinkt wird, sonst als Artikel ansieht.

 category      = Demo nofollow      = true </DynamicPageList>

Googlespezifische Modifikation
Dies ist ein Modifikation für Wikinews. In früheren Versionen von Google News wurden nur Artikel mit darin enthaltenen Nummern als Nachrichtenartikel betrachtet, daher wird ?dpl_id=&lt;id of article&gt; an das Ende der URLs auf der Liste angehängt. Du solltest diese Option nur verwenden, wenn Du einen guten Grund dafür hast (es schadet jedoch nicht). Dies ersetzt die Option "showcurid", die nicht mehr unterstützt wird.

 category      = Demo googlehack      = true </DynamicPageList>

Parameter: ordermethod
ordermethod legt fest, in welcher Reihenfolge und nach welchem Datum die Darstellung der Liste erfolgt. Folgende Werte sind möglich:
 * categoryadd — default, sort by date pages were categorised for first category
 * lastedit — sort by date pages were last edited
 * length — Nach Länge des Artikels
 * created — Nach Erstellungsdatum des Artikels
 * categorysortkey — essentially alphabetical order by the sort key of the first category
 * sortkey — Name von categorysortkey

It should be noted, that lastedit really sorts by the last time the page was touched. In some cases this is not equivalent to the last edit (for example, this includes permission changes, creation or deletion of linked pages, and alteration of contained templates). If you do not specify a category, some of these order methods will not work&mdash;specifically, categoryadd and categorysortkey fallback to created if there is no  clause.

 category            = Demo addfirstcategorydate = true ordermethod         = lastedit </DynamicPageList>

Alphabetisches Beispiel:

 category            = Demo ordermethod         = sortkey </DynamicPageList>

Parameter: order
order kann einer der beiden folgenden Parameter sein:
 * descending (absteigend); sortiert die Liste vom jüngsten zum ältesten Datum (Grundeinstellung)
 * ascending (aufsteigend); gibt die Liste in umgekehrter Reihenfolge vom ältesten zum neuesten Eintrag aus.

 category = Demo order    = ascending </DynamicPageList>

Vorlagen
Bei Verwendung innerhalb einer Vorlage und zur Übergabe von Parametern benutzt Du Parserfunktionen usw., benutze die Funktion :

Auf der Vorlagenseite selbst wird eine Fehlermeldung angezeigt, da der Kategoriewert auf der Vorlagenseite leer ist, sofern Du die Vorlage nicht in die Tags  einfügst. Beispiel:

Abgeleitete Erweiterungen

 *  Derived extensions: outputs in forum style.  is like this but outputs an RSS feed.  is a modified version with more features, but also more resource-expensive. Neither of the latter is used on Wikimedia's sites. 
 * Version 1.8.4 of is fully downward compatible with the extension described here. So the way is open for a re-unification of the different development paths. This is not true any more for the current versions since version 2.01 of DynamicPageList (third-party) does not support.
 * - makes dynamic page lists available to modules.
 * - provides similar functions.