Extension:DynamicPageList (Wikimedia)/de

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:DynamicPageList (Wikimedia) and the translation is 40% complete.

Other languages:
Deutsch • ‎English • ‎español • ‎português do Brasil • ‎日本語
MediaWiki-Erweiterungen
OOjs UI icon advanced.svg
DynamicPageList
Erscheinungsstatus: stabil
DynamicPageList extension example.PNG
Einbindung Tag , Parser function
Beschreibung Outputs a bulleted list of most recent items residing in a category, or an intersection of several categories.
Autor(en) IlyaHaykinson and Amgine
Letzte Version Continuous updates
MediaWiki 1.23+
PHP 5.4+
Datenbankänderungen Nein
Lizenz GNU General Public License 2.0 or later
Herunterladen
Beispiel
<DynamicPageList>
Übersetze die DynamicPageList (Wikimedia) Erweiterung
Prüfe die Benutzungs- und Versionsmatrix.
Probleme Offene Aufgaben · (Wikimedia) Einen Fehler melden
This extension is used by Wikimedia, not to be confused with the DynamicPageList (third-party) extension or Extension:DynamicPageList3.

Diese Software-Erweiterung erlaubt es Wiki-Benutzern eine Liste von Seiten (z.B. Artikeln) zu erstellen, die in einer Reihe von Kategorien aufgeführt werden.

Origin

DynamicPageList ist eine Erweiterung der Software „Mediawiki 1.5“, die ursprünglich für die Benutzung bei der englischen Version von Wikinews entwickelt wurde, aber auch bei der deutschen Version von Wikinews verwendet wird und welche bei jeder Mediawikiinstallation eingebunden werden kann.

Eine erweiterte Version dieser Erweiterung wird auf der Seite Extension:DynamicPageList (third-party) beschrieben.


Installation and setup

Installation

  • Füge folgenden Code am Ende deiner LocalSettings.php hinzu:
    wfLoadExtension( 'intersection' );
    
  • Yes Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.

An Nutzer, die MediaWiki 1.27 und früher betreiben:

Die oben stehenden Anweisungen beschreiben den neuen Weg der Installation von diese Erweiterung per wfLoadExtension(). Falls du diese Erweiterung in einer dieser früheren Versionen (MediaWiki 1.27 und früher)  – an Stelle von wfLoadExtension( 'intersection' ); – installieren musst, benutze:

require_once "$IP/extensions/intersection/intersection.php";


Configuration

Die maximale Anzahl der ausgegebenen Seiten ist im Quelltext der Softwareerweiterung festgelegt.

# Configuration variables. Warning: These use DLP instead of DPL
# for historical reasons (pretend Dynamic list of pages)
$wgDLPmaxCategories = 6;                // Maximum number of categories to look for
$wgDLPMaxResultCount = 200;             // Maximum number of results to allow
$wgDLPAllowUnlimitedResults = false;    // Allow unlimited results
$wgDLPAllowUnlimitedCategories = false; // Allow unlimited categories
// How long to cache pages using DPL's in seconds. Default to 1 day. Set to
// false to use the normal amount of page caching (most efficient), Set to 0 to disable
// cache altogether (inefficient, but results will never be outdated)
$wgDLPMaxCacheTime = 60*60*24;          // How long to cache pages in seconds


DynamicPageList benutzen

Die Dynamic Page List (DPL) ist eine MediaWiki-Software-Erweiterung. Um sie zu benutzen, ist folgende XML-ähnliche Syntax auf der entsprechenden Wikiseite einzufügen:

<DynamicPageList>
category             = Pages recently transferred from Meta
count                = 5
order                = ascending
addfirstcategorydate = true
</DynamicPageList>

An example of a really complex DynamicPageList:

<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
</DynamicPageList>

Lists the 12th to the 34th pages in the file namespace that are also in category foo, formatting them into an image gallery, with the date they were added to category foo in the caption in year month day format, and having the images have a width of 70px


Page selection

verbindlicher Parameter: category

Solche Vorlagen wie {{CURRENTMONTHNAME}}, {{CURRENTDAY}}, {{CURRENTYEAR}} usw. können als Kategoriename verwendet werden. In Kombination mit anderen Kategorien ist aber Vorsicht geboten. Wenn keine Ergebnisse vorhanden sind, wird folgende Fehlermeldung ausgegeben: „DynamicPageList: No results!“

category=Kategoriename

<DynamicPageList>
category=Europäische Politik
category=US-Politik
</DynamicPageList>


Parameter: notcategory

Es geht bei diesem Parameter darum, dass bestimmte Seiten nicht ausgegeben werden sollen. Ähnlich wie der Kategorieparameter, erfordert aber, dass die Seiten, die hier ausgeschlossen werden sollen, nicht in einer bestimmten Kategorie enthalten sind.

<DynamicPageList>
category=Terrorismusbekämpfung
notcategory=US-Politik
</DynamicPageList>


Parameter: namespace

Die Namensraum-ID kann eine positive ganze Zahl einschließlich Null sein, unter der Voraussetzung, es gibt diesen Namensraum in dem jeweiligen System. Der Namensraum mit der Nr. Null ist der (Haupt-)Artikelnamensraum. Anstatt der Nummer, kann auch eine korrekte Namensbezeichnung für den Namensraum angegeben werden. Zum Beispiel (in den deutschen Wikinews:) „Diskussion“ oder „Benutzer Diskussion“ oder „Kategorie Diskussion“ oder „Kategorie“ usw. Ein ungültiger Name wird durch den (Haupt-)Namensraum ersetzt.

<DynamicPageList>
category=Deutsche_Politik
namespace=(Haupt-)
</DynamicPageList>


Parameter: redirects

redirects determines whether or not to include redirect pages. The value can be exclude (default, don't list redirects), include (list redirects), or only (don't list pages that aren't redirects).

<DynamicPageList>
category  = Demo
redirects = only
</DynamicPageList>


stablepages

stablepages determines whether or not to include stable (flagged) pages when using Extension:FlaggedRevisions. The value can be exclude (don't list), include (list stable and non-stable. default), or only (only list stable pages). Requires FlaggedRevs to be installed to work.


qualitypages

qualitypages determines whether or not to include quality (flagged at the 'pristine' level) pages when using Extension:FlaggedRevisions. The value can be exclude (don't list), include (list both quality and non-quality), or only (only list quality pages).

Note: the behaviour of qualitypages changed from older versions. In older versions qualitypages=exclude automatically made stablepages=only be set. This is no longer the case.


Parameter: count

count restricts the number of results that are shown. By default, the pages added to the category most recently are shown (see order). Note that the extension will not list more results than the maximum defined in the extension source code.

<DynamicPageList>
category=Deutsche_Politik
count=10
</DynamicPageList>


offset

offset starts the list from somewhere other than the first page on the list. For example, this can be used with count to make multi-column layouts.

<DynamicPageList>
category = Demo
offset    = 2
</DynamicPageList>

Column demo

<table>
<tr><th colspan="3"> recent articles in [[:category:Demo|:category:Demo]]</th></tr>
<tr><td>

<DynamicPageList>
category = Demo
count=5
</DynamicPageList>
</td>
<td>
<DynamicPageList>
category = Demo
offset    = 5
count= 5
</DynamicPageList>
</td>
<td>

<DynamicPageList>
category = Demo
offset    = 10
count=5
</DynamicPageList>
</td></tr></table>


Details displayed

Parameter: shownamespace

Dieser Parameter verhindert die Ausgabe der Namensraum-Bezeichnung. Nützlich zum Beispiel, wenn Kategorien aufgelistet werden sollen, jedoch der Präfix Kategorie: dabei unterdrückt werden soll. Wenn der Parameter nicht angegeben ist, ist die Grundeinstellung (default):true.

<DynamicPageList>
shownamespace=false
category=Wikinews
namespace=Kategorie
</DynamicPageList>


Parameter: addfirstcategorydate

addfirstcategorydate shows the date each article was added to category. The value can be true (display date), false (default, don't display date), or a date specifier (ymd, md, dm, dmy, mdy, and ISO 8601). If many categories are specified, it uses the first category. The linked page names are prepended with the date formatted according to your local MediaWiki date display preferences.

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


Parameter: mode

Für Ausgabemodus ist eine der folgenden Parameter möglich:

  • unordered — ungeordnete Liste mit Aufzählungszeichen — HTML-Element "ul" — (default)
  • ordered — gibt eine nummerierte Liste aus — HTML-Element "ol"
  • none — gibt eine unnummerierte Liste ohne Aufzählungszeichen aus, die einfach nach einem Titel eine neue Zeile erzeugt; sie benutzt das HTML-Element <br> um jede Ausgabe von der vorangehenden zu trennen.
unordered:
<DynamicPageList>
category = Demo
mode     = unordered
</DynamicPageList>

<pre>
<DynamicPageList>
category=!Hauptkategorie
mode=ordered
</DynamicPageList>

plain links: No pages meet these criteria.

inline: No pages meet these criteria.


mode=gallery

Gallery is a special mode where the output is an image gallery. When using this mode, you would usually want to restrict the namespace to file.

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

Gallery mode also supports the options imagewidth (how wide the images should be in gallery, you may need to also set imageheight if using this), imageheight (how high the image should be) galleryshowfilesize (show the image size, like on category pages), galleryshowfilename (show filename like on category pages), imagesperrow (number of images per row in gallery), gallerycaption (caption for gallery).

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

Note, gallerycaption at the moment cannot accept links. (but it can accept things like {{CURRENTMONTHNAME}})

A complex gallery example might be:

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


Parameter: suppresserrors

Erlaubt die Unterdrückung von Fehlermeldungen (bei leeren Listen). Falls man die Angabe dieses Parameters weglässt, ist die Grundeinstellung: false.

<DynamicPageList>
category=Nonexistent
suppresserrors=true
</DynamicPageList>

false: No pages meet these criteria.


nofollow

nofollow sets rel="nofollow" on the links. This prevents spiders from getting to the page through the link from the DynamicPageList. In general this is useless, as spiders will either be able to index the page from other links, or not at all due to robots.txt/$wgDefaultRobotPolicy. In general you should not use this option unless you know what you are doing, and have a good reason. The primary usecase is that on the English Wikinews, Google News considers anything linked from the main page to be an article.

<DynamicPageList>
category       = Demo
nofollow       = true
</DynamicPageList>


googlehack

This is a hack for wikinews. Previously, Google News only considered articles with numbers in them to be news articles [1], so this appends ?dpl_id=<id of article> to the end of the urls on the list. You shouldn't use this option unless you have a good reason to (however it won't hurt anything). This replaces the showcurid option that is no longer supported.

<DynamicPageList>
category       = Demo
googlehack       = true
</DynamicPageList>


Parameter: order

Parameter: ordermethod

Legt fest, welches Datum zur Ordnung der Liste benutzt wird.

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). popularity is only enabled on wikis that have $wgDisableCounters set to false. As such it will not work on Wikimedia wikis. If you do not specify a category, some of these order methods will not work—specifically, categoryadd and categorysortkey fallback to created if there is no category clause.

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

alphabetical example:

<DynamicPageList>
category             = Demo
ordermethod          = sortkey
</DynamicPageList>


order

Nummerierungsrichtung kann eine der beiden folgenden Parameter sein:

  • descending (absteigend) — sortiert die Liste vom jüngsten zum ältesten Datum — (default) (Grundeinstellung)
  • ascending (aufsteigend) — gibt die Liste in umgekehrter Reihenfolge vom ältesten zum neuesten Eintrag aus.
<DynamicPageList>
category=Deutsche_Politik
order=ascending
</DynamicPageList>


Templates

To use inside a template and pass parameters, use parser functions etc., use the {{#tag: function:

{{#tag:DynamicPageList|
category = {{{1}}
}
count    = {{#if: {{{2|}}} | 10 | 20 }}
ordermethod = sortkey
order = ascending
}}

The template page itself will display an error message because the category value is empty on the template page unless you put the template inside <includeonly> tags. Example: Error: You need to include at least one category, or specify a namespace!


Derived extensions

Derived extensions: DPLforum outputs in forum style. Extension:GoogleNewsSitemap is like this but outputs an RSS feed. Extension:DynamicPageList (third-party) 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 DynamicPageList (third-party) 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 ordermethod=sortkey.
Extension:DynamicPageListEngine makes dynamic page lists available to Scribunto modules.
Extension:Multi-Category Search provides similar functions.