Creating page lists with DPL3

The extension DynamicPageList3 allows you to display lists of wiki pages on other pages. In addition, individual page sections from one wiki page can be included (=transcluded) in another page.

Examples

You can view a documentation of all selection criteria and formatting options at Gamepedia.

This help page contains some typical examples as well as a list of common parameters and their values.

Transcluding page sections

To display a section of one wiki page on another page, provide the page name (title) and the section header (include) as parameters:

{{#dpl:|title=Manual:Semantic_MediaWiki|include=#Defining attributes}}

List of subpages

The following code shows the subpages of the current page in a 3-column layout:

{{#dpl:
|titlematch={{PAGENAME}}/%
|shownamespace=false
|replaceintitle=/{{PAGENAME}}\//,
|columns=3
|mode=none
|rowcolformat=width=100%
}}

Example: Display the subpages of the page VisualEditor in the namespace Manual in a 1-column layout:

{{#dpl:
|titlematch=VisualEditor/%  
|shownamespace=false
|namespace= Manual
|replaceintitle=/VisualEditor\//,
|columns=1
|mode=unordered
|rowcolformat=width=100%
}}


Output:


If you want to limit the output to the first level of subpages, you can add:

|nottitlematch={{PAGENAME}}/%/%

Selecting pages by namespace

{{#dpl:
  |namespace=Manual
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}

Output:

Selecting pages by category

{{#dpl:
  |category=Editing
  |addcategories=true
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
  |mode=ordered  
}}

Output:

  1. Create Pages . . Categories: Editing
  2. Create pages . . Categories: Editing
  3. Delete article . . Categories: Editing
  4. Extension/BlueSpiceContextMenu . . Categories: Editing
  5. Extension/BlueSpiceCountThings . . Categories: Editing

Selecting pages with specific naming patterns

{{#dpl:
 |namespace=File
 |titlematch=A%
 |count=5
 }}

Output:



List of common parameters

Criteria for page selection

Parameter Syntax Description
category |category=QM|Setup... Pages in the category QM OR Setup
|category=QM&Setup&... Pages in the categories QM AND Setup
|category=QM|Setup...|category=Admin Pages in the categories QM OR Setup, and pages in the category Admin
notcategory |notcategory=QM Pages that are not in the category QM
categoriesminmax |category=QM|categoriesminmax=2 Pages that are in the category QM and in at least 2 more categories
|category=QM|categoriesminmax=,1 Pages that are only in the category QM and in no other category
namespace |namespace= Pages in the namespace (Main)
|namespace=Help|Manual Pages in the namespace Help OR Manual
namespacenot |namespacenot=Help Pages that are not in the namespace Help
|namespacenot={{NAMESPACE}} Pages that are not in the namespace of the current wiki page

Output-Format

Parameter Syntax Description
mode |mode=ordered Unordered list
|mode=unordered Numbered list
|mode=none Line breaks
|mode=category Pages are grouped alphabetically with a letter heading (similar to category pages)
|mode=inline|inlinetext=  •   Page names are listed on the same line and separated with a bullet point

Sorting

Parameter Syntax Description
ordermethod |ordermethod=title Ordered by page (prefix+)title
|ordermethod=titlewithoutnamespace Ordered by page name independent of namespace
|ordermethod=counter Ordered by number of page views (popularity)
|ordermethod=size Ordered by page size
|ordermethod=firstedit Ordered by creation date
|ordermethod=lastedit Ordered by last edit date
|ordermethod=user,firstedit Ordered by author, then by creation date
|ordermethod=user,lastedit Ordered by last editor, then by last edit date
order |order=ascending Sorted in ascending order
|order=descending Sorted in descending order

Display of meta data

Parameter Syntax Description
addcategories |addcategories=true Shows all categories of a page after the page name
addpagecounter |category:QM|ordermethod=counter|order=descending

|addpagecounter=true|count=5

Shows the 5 most popular pages in the category QM
adduser |category=QM|ordermethod=lastedit|adduser=true Adds the name of the last editor in front of the page name
addauthor |category=QM|addauthor=true Adds the name of the original author in front of the page name.

Disabling automatically generated DPL categories

This extension is creating some sometimes unwanted automatic system categories that are then displayed on each wiki page that includes a DPL parser function.


To hide these categories, follow these steps:

  1. Go to page Special:TrackingCategories in your wiki
  2. Click on dpl-parserfunc-tracking-category in the column Message name
  3. Replace the text Pages using DynamicPageList parser function not wanted with a dash ("-"). The category will no longer be displayed on your wiki pages.
  4. Save the page.

The system category is no longer displayed on your wiki pages.

See also: https://www.mediawiki.org/wiki/Help:Tracking%20categories


Related info

Discussions

Attachments