Help:DPL

DynamicPageList or DPL for short is a MediaWiki extension supporting intersections and other set operations of pages belonging to several categories.

FlavoursEdit

Two versions of dynamic page lists (DPL) exist, a variant using the tags <dynamicpagelist> plus </dynamicpagelist>, and another variant using tags <dpl> plus </dpl>. A project can support none, one, or both of these two extensions, see "parser extension tags" in Special:Version. <dynamicpagelist> is the only variant supported on Wikimedia projects, and only on smaller projects.

The advanced version covers all functions of the older variant, here only the latter is explained. For further details see the descriptions in DynamicPageList and DynamicPageList2.

OperationEdit

In essence categories are sets of related pages, created by adding [[Category:common property]] to the individual pages. In addition category pages are also ordinary pages in their first part with all features of normal pages, but their main purpose is to list all pages belonging to the category. This changes as soon as [[Category:common property]] is added or removed from one or more of the individual pages, the members of this set.

Watching the category page only tracks modifications to its first part (as for any ordinary page), but it doesn't show any additions or removals of member pages. DPLs address this missing feature, they also allow to sort member pages by various criteria where categories only offer a crude sort key or alphabetical order.

Simple DPLs start with <dynamicpagelist> followed by one or more category=name and optionally other parameter=value pairs, and they are terminated by </dynamicpagelist>. For a similar construct see inputbox.

One (first) category=name is required, and it's the base for some other attributes. Adding more category=name restricts the DPL to pages in the intersection of all specified categories.

With notcategory=name pages in that category are removed from the DPL. So for categories A, B, and C use category=A and category=B with notcategory=C for all pages in both A and B, but not C. And also not only in A, and not only in B.

Two DPLs could be used to get a kind of union, the first DPL for category A, and the second DPL for category B without A, but real unions require the advanced DPL features.

RestrictionsEdit

The attribute namespace= allows to restrict listed pages to a namespace given by its number or name. Use 0 for the main namespace.

The attribute redirects= can be exclude (default) not listing any redirects belonging to the selected categories. With include redirects are listed, and redirects=only limits the DPL to only redirects.

With count=n the DPL is limited to the first n member pages as determined by the sort order (see below). The default is a system-wide maximum, with two DPLs looking at the same set from both ends it's indirectly possible to determine if really all selected pages are shown (see below).

OutputEdit

Use suppresserrors=true to suppress error messages for an empty DPL, e.g. if the selected category doesn't exist.

The default output mode=unordered presents the DPL as unordered list, XHTML <ul>, like Wiki list markup *.

Similarly ordered results in numbered <ol> output like Wiki list markup #. Finally mode=none presents the DPL with one entry per line, terminated with <br />, roughly similar to Wiki list markup ; (semicolon).

Especially in conjunction with namespace= the attribute shownamespace=false allows to suppress the output of the namespace.

SortingEdit

DPLs are either sorted by the date of the addition to the first category (this is often not the date of the creation of the individual page), the default ordermethod=categoryadd, or by ordermethod=lastedit, the date of the last modification of the member pages.

Sorting can be order=descending (default, most recent first) or order=ascending, allowing to look at the same set from both ends in two DPLs (see above).

DatesEdit

With addfirstcategorydate=true the date of the addition to the first category is shown.

ExampleEdit

If the following example doesn't work where you read this page look at it on Meta.

<dynamicpagelist>
category=Reader handbook
order=ascending
ordermethod=lastedit
mode=ordered
shownamespace=false
</dynamicpagelist>

This results in a numbered list of help pages, oldest first:

  1. Redirect/expr
  2. Navigational template
  3. User contributions
  4. Linksearch
  5. Related changes
  6. Category
  7. Downloading pages
  8. Searching
  9. Handbook guidelines
  10. Self link
  11. Printable
  12. Go button
  13. Preferences
  14. Image page
  15. Special page
  16. Redirect
  17. Diff
  18. Tracking changes
  19. Reader handbook/Translations
  20. Tracking changes/fr
  21. Downloading pages/pt
  22. Handbook guidelines/pt
  23. Special page/tr
  24. Redirect/tr
  25. Item
  26. What links here
  27. Nemo bis/importing
  28. Project
  29. Date formatting and linking
  30. Page history
  31. Page history/uk
  32. Logging in
  33. Page name
  34. Recent changes


Another example:

<dynamicpagelist>
category=Handbook templates
notcategory=Templates using ParserFunctions
mode=none
addfirstcategorydate=true
</dynamicpagelist>

This creates a plain list with the dates of the addition to the first (here only) category:


11 May 2021: Template:Editor toc/zh-hant
11 May 2021: Template:Editor toc/zh
11 May 2021: Template:Editor toc/vi
11 May 2021: Template:Editor toc/ru
11 May 2021: Template:Editor toc/pt-br
11 May 2021: Template:Editor toc/ko
11 May 2021: Template:Editor toc/pt
11 May 2021: Template:Editor toc/ja
11 May 2021: Template:Editor toc/id
11 May 2021: Template:Editor toc/hu
11 May 2021: Template:Editor toc/fr
11 May 2021: Template:Editor toc/en
11 May 2021: Template:Editor toc/de
11 May 2021: Template:Editor toc/arz
11 May 2021: Template:Editor toc/da
11 May 2021: Template:Editor toc/ar
11 May 2021: Template:Editor toc
11 May 2021: Template:Reader toc/zh
11 May 2021: Template:Reader toc/zh-hant
11 May 2021: Template:Reader toc/sv
11 May 2021: Template:Reader toc/uk
11 May 2021: Template:Reader toc/sq
11 May 2021: Template:Reader toc/ru
11 May 2021: Template:Reader toc/pt-br
11 May 2021: Template:Reader toc/ko
11 May 2021: Template:Reader toc/ja
11 May 2021: Template:Reader toc/id
11 May 2021: Template:Reader toc/hu
11 May 2021: Template:Reader toc/fr
11 May 2021: Template:Reader toc/en
11 May 2021: Template:Reader toc/de
11 May 2021: Template:Reader toc/da
11 May 2021: Template:Reader toc/arz
11 May 2021: Template:Reader toc/ar
11 May 2021: Template:Reader toc
11 May 2021: Template:MediaWiki links
16 February 2021: Template:H:f Help/ko
17 August 2020: Template:-
11 July 2020: Template:H:f Help/pt-br
11 April 2020: Template:Edhf
11 April 2020: Template:Edi
2 October 2019: Template:Unclear
24 July 2019: Template:H:f Template
5 January 2019: Template:H:f Help/pt
25 December 2018: Template:H:l
21 August 2018: Template:H:f Help
5 August 2018: Template:H:h Help/zh-hans
5 August 2018: Template:Fdnw
5 August 2018: Template:Fd
26 June 2018: Help:Template/onlyinclude demo
4 January 2017: Template:H:h Help/nl
13 December 2016: Template:Ph:MediaWiki help policy
13 December 2016: Template:Ph:Vsebina
16 August 2016: Template:H:f Help/zh-hant
16 August 2016: Template:H-langs:
12 August 2016: Template:H:f Help/zh-hans
22 December 2015: Template:H:h Help/nb
6 March 2015: Template:MediaWiki links ms
4 March 2015: Template:मिडियाविकि दूवे
29 January 2015: Template:Ph:Contents/pt-br
29 January 2015: Template:Ediu
29 January 2015: Template:Xpdn
3 January 2015: Template:H:f Help/uk
26 November 2013: Template:Moderator toc/ru
26 November 2013: Template:System admin toc/ru
23 August 2013: Template:Moderator toc/zh-hant
29 August 2012: Template:Ph:CheckUser
20 May 2012: Template:System admin toc/zh-hant
20 May 2012: Template:Redaktuesi toc
20 May 2012: Template:Reader toc el
20 May 2012: Template:Ph:Page for demos in the Help namespace
20 May 2012: Template:MediaWiki връзки
20 May 2012: Template:MediaWiki nyje
20 May 2012: Template:MediaWiki linky
20 May 2012: User:AaronPeterson/css play
21 April 2012: Template:Modifier
21 April 2012: Template:Modif
21 April 2012: Template:Edde
21 April 2012: Template:EdML
21 April 2012: Template:H:h Help/fr
21 April 2012: Template:H:f Help/vi
21 April 2012: Template:H:f Help/sq
21 April 2012: Template:H:f Help/no
21 April 2012: Template:H:f Help/nl
21 April 2012: Template:H:f Help/ja
21 April 2012: Template:H:f Help/it
21 April 2012: Template:H:f Help/fr
21 April 2012: Template:H:f Help/ar
21 April 2012: Template:H:f Help/de
20 April 2012: Template:System admin toc/zh
20 April 2012: Template:Reader toc ja
20 April 2012: Template:Povezave za MediaWiki
20 April 2012: Template:Moderator toc/zh
20 April 2012: Template:MediaWiki links/Ru
20 April 2012: Template:Lezer inhoud
20 April 2012: Template:Kazalo za skrbnike
20 April 2012: Template:Editor toc pt
20 April 2012: Template:Amministratori toc
9 March 2012: Template:Moderator toc
25 April 2011: Template:H:mwg
25 April 2011: Template:Ed
9 April 2011: Template:Ill
19 December 2007: Template:Wikilink syntax tbl
9 June 2007: Help talk:Template/onlyinclude demo
9 June 2007: Template:H:htest
9 June 2007: Template:H:h Template
15 February 2007: Template:Timd
8 February 2007: Template:H:Language-dependent variables
8 February 2007: Template:H:Miscellaneous variables
8 February 2007: Template:H:Position variables
8 February 2007: Template:H:Size variables
8 February 2007: Template:H:Modifier variables
8 February 2007: Template:H:Formatting variables
8 February 2007: Template:H:Namespace variables
8 February 2007: Template:H:Statistics variables
8 February 2007: Template:H:Section variables
8 February 2007: Template:H:Page name variables
22 April 2006: Template:H:
22 April 2006: Template:System admin toc


Meta currently supports only the simple DPL.


Links to other help pagesEdit

Help contents
Meta · Wikinews · Wikipedia · Wikiquote · Wiktionary · Commons: · Wikidata · MediaWiki · Wikibooks · Wikisource · MediaWiki: Manual · Google
Versions of this help page (for other languages see further)
What links here on Meta or from Meta · Wikipedia · MediaWiki
Reading
Go · Search · Stop words · Namespace · Page name · Section · Backlinks · Redirect · Category · Image page · Special pages · Printable version
Tracking changes
Recent changes (enhanced) | Related changes · Watching pages · Diff · Page history · Edit summary · User contributions · Minor edit · Patrolled edit
Logging in and preferences
Logging in · Preferences · User style
Editing
Starting a new page · Advanced editing · Editing FAQ · Edit toolbar · Export · Import · Shortcuts · Edit conflict · Page size
Referencing
Links · URL · Piped links · Interwiki linking · Footnotes
Style and formatting
Wikitext examples · CSS · Reference card · HTML in wikitext · Formula · List · Table · Sorting · Colors · Images and file uploads
Fixing mistakes
Show preview · Testing · Reverting edits
Advanced functioning
Expansion · Template · Advanced templates · Parser function · Parameter default · Variable · System message · Substitution · Array · Calculation · Embed page
Others
Special characters · Renaming (moving) a page · Preparing a page for translation · Talk page · Signatures · Sandbox · Legal issues for editors
Languages: