Main Page

Manual

DynamicPageList3 (DPL3) is a powerful MediaWiki extension that generate lists of pages, page properties (metadata), and/or template parameter values, for display in other articles. DPL3 lists are automatically updated whenever the data it fetches changes and the cache is cleared or expires. The output can be formatted to create a range of displays from lists (the default format), to in-line paragraph text/content, tables, galleries, navigation, and many other possibilities.

As a basic example, DPL3 can be used to insert in a wiki page, an always-current list of all pages of a particular category. The data displayed may be selected and sorted based on factors like author, namespace, date, name pattern, usage of templates, or references to other articles, with a variety of custom formatting.

Installation

• For Miraheze and WikiForge (WikiFarm) users, the DPL3 MediaWiki extension is already installed, it simply needs to be enabled by a user with the appropriate privileges in Meta:ManageWiki.

• Other users should see the MediaWiki software DynamicPageList3 Extension installation page section for information on how to install the extension in MediaWiki.

Configuration

DPL3 has a variety of configuration settings that can be used, as well as a number of defaults that are important to note. Settings should be defined before enabling the extension.

• For Miraheze and WikiForge (WikiFarm) users, the DPL3 MediaWiki extension is already configured.

• Other users should see the MediaWiki software DynamicPageList3 Extension configuration page section for a list of configuration options.

Limiting results and resource consumption

To prevent a DPL3 query from returning huge output (or consuming too many resources such as CPU or causing database load). The following configuration variables are noteworthy:

Setting	Default	Description
$wgDplSettings['maxQueryTime']	10000	Limits the time amount (in milliseconds) allowed for database queries.
$wgDplSettings['maxCategoryCount']	4	Limits the number of categories allowed in queries (default is 4).
$wgDplSettings['maxResultCount']	500	Limits the number of results returned in a query (default is 500).
$wgDplSettings['runFromProtectedPagesOnly']	false	Causes DPL3 to only run from protected pages (if set to true), which can aid administrators having problems with malicious user activity resulting in computationally expensive queries.

Note: For Miraheze and WikiForge users, these settings are set automatically and can not be currently changed except by request.

Functional richness

DynamicPageList3 has different levels of functional richness, which can be configured as needed. Higher levels of functionality should be considered carefully and used sparingly.

Note: For Miraheze and WikiForge users, these settings are set automatically and can not be currently changed except by request.

Setting	Value	Description
$wgDplSettings['functionalRichness']	0	Provides functionality equivalent to Wikimedia's DynamicPageList (also known as Intersection).
$wgDplSettings['functionalRichness']	1	Adds additional parameters for formatting.
$wgDplSettings['functionalRichness']	2	Adds features (performance equivalent) for pagelinks and templates.
$wgDplSettings['functionalRichness']	3	Allows more-expensive inclusion features, such as queries on revision level, and regular expression queries (default).
$wgDplSettings['functionalRichness']	4	Permits potentially dangerous and exotic batch delete and update operations; not recommended for public websites. Also includes extra debugging parameters for development and testing.

Important: Some levels of functional richness can cause high database or CPU load, and should be carefully considered.

Other

Setting	Default	Description
$wgDplSettings['allowedNamespaces']	null	All existing namespaces are used by default when DPL3 is initialized. An array of namespace constants can be provided to restrict DPL3 to only working in the specified namespaces.
$wgDplSettings['allowUnlimitedCategories']	false	Ignores 'maxCategoryCount' and allows unlimited categories, if set to true. Note that large numbers of categories in queries can cause servers to slow or crash.
$wgDplSettings['allowUnlimitedResults']	false	Ignores 'maxResultCount' and allows unlimited results, if set to true. Note that large sets of results may cause pages to slow or fail to load.
$wgDplSettings['alwaysCacheResults']	false	Ignores 'allowcachedresults' and enables the parser cache, if set to true.
$wgDplSettings['categoryStyleListCutoff']	6	Maximum number of items permitted in a category list, additional are cut off.
$wgDplSettings['handleSectionTag']	false	Set this to have DPL3 handle open tags outside DPL parser tags.
$wgDplSettings['minCategoryCount']	0	Minimum number of categories permitted in DPL3 queries.
$wgDplSettings['recursiveTagParse']	false	Performs recursive parsing on open parser tags, converting tags and functions (for example, magic words like {{PAGENAME}}). Though it may not work the same in all cases, this functions similarly to the {{#dpl}} DPL3 parser function (see Other Modules).
$wgDplSettings['queryCacheTime']	0	Specifies the amount of time to cache a query for, the query cache then cannot be purged. Values between 30 and 600 are suggested.

Usage

The General use and invocation syntax page is essential to read, to understand the fundamentals of DPL3 use, it is not recommended to skip this section of the manual.

• General usage and invocation syntax

Primary DPL3 module

These sections contain documentation on DPL3's primary module. This is the DPL3 functionality used most often, and has a wide range of powerful coding options.

• Criteria for page selection
• Controlling output format
• Controlling output order
• Controlling output volume
• Other parameters

Other DPL3 modules

These sections detail some additional functions provided by the DPL3 extension.

• {{#dplchapter: ... }}
• {{#dplvar: ... }}
• {{#dplreplace: ... }}
• {{#dplnum: ... }}
• {{#dplmatrix: ... }}

More information

• Compatibility with previous versions
• Bug reporting and feature requests
• Examples for a complete list of examples.
• For the legacy manual Table of Contents, see Parameter Quick Reference.
• DPL3 Changelog on Github