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:

Category format

<div class="dplcategory">
{{#dpl:
  |namespace=Manual
  |includesubpages=true
  |shownamespace=false
  |mode=category
  |ordermethod=titlewithoutnamespace
}}
</div>

Output:

If the sorting letters are displayed at the end of a column, the display can be improved by inserting css declarations on the page MediaWiki:Common.css :

/*dpl column layout - avoid header orphans */
.dplcategory {-webkit-column-count:3;column-count:3;}
.dplcategory .mw-category .mw-category-group {display:block}
.dplcategory .mw-category-group {margin:0 2em 2em 2em;}
.dplcategory .mw-category-group h3 {break-after:avoid}
.dplcategory .mw-category-group h3 {margin:0 0 0.3em; border-bottom:1px solid #e2e2e2}

Improved output:

Category layout

Selecting pages by category

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

Output:

Create Pages . . Categories: Editing
Create pages . . Categories: Editing
Delete article . . Categories: Editing
Extension/BlueSpiceCategoryCheck . . Categories: Advanced | Editing
Extension/BlueSpiceContextMenu . . 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:

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

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

Technical Reference: DynamicPageList3

To submit feedback about this documentation, visit our community forum.