File:banner-example.png and Manual:Extension/DynamicPageList3: Difference between pages

(Difference between pages)
No edit summary
 
No edit summary
Tag: 2017 source edit
 
Line 1: Line 1:
{{DISPLAYTITLE: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 [https://help.gamepedia.com/Extension:DPL3 Gamepedia].
This help page contains some typical examples as well as a [[Manual:Extension/DynamicPageList3#List of common parameters and their values|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:
<syntaxhighlight lang="text">
{{#dpl:|title=Manual:Semantic_MediaWiki|include=#Defining attributes}}
</syntaxhighlight>
===List of subpages===
The following code shows the subpages of the current page in a 3-column layout:
<syntaxhighlight lang="text">
{{#dpl:
|titlematch={{PAGENAME}}/%
|shownamespace=false
|replaceintitle=/{{PAGENAME}}\//,
|columns=3
|mode=none
|rowcolformat=width=100%
}}
</syntaxhighlight>
Example: Display the subpages of the page  ''VisualEditor'' in the namespace ''Manual'' in a 1-column layout:<syntaxhighlight lang="text">
{{#dpl:
|titlematch=VisualEditor/% 
|shownamespace=false
|namespace= Manual
|replaceintitle=/VisualEditor\//,
|columns=1
|mode=unordered
|rowcolformat=width=100%
}}
</syntaxhighlight>
'''Output:'''
{{#dpl:
|titlematch=VisualEditor/%
|shownamespace=false
|namespace= Manual
|replaceintitle=/VisualEditor\//,
|columns=1
|mode=unordered
|rowcolformat=width=100%
}}
If you want to limit the output to the first level of subpages, you can add:<syntaxhighlight lang="text">
|nottitlematch={{PAGENAME}}/%/%
</syntaxhighlight>
===Selecting pages by namespace===
<syntaxhighlight lang="text">
{{#dpl:
  |namespace=Manual
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}
</syntaxhighlight>
Output:
{{#dpl:
  |namespace=Manual
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
}}
===Selecting pages by category===
<syntaxhighlight lang="text">
{{#dpl:
  |category=Editing
  |addcategories=true
  |includesubpages=true
  |shownamespace=false
  |count=5
  |ordermethod=title
  |mode=ordered 
}}
</syntaxhighlight>
Output:
{{#dpl:
|category=Editing
|addcategories =true
|includesubpages=true
|shownamespace=false
|count=5
|ordermethod=title
|mode=ordered
}}
===Selecting pages with specific naming patterns===
<syntaxhighlight lang="text">
{{#dpl:
|namespace=File
|titlematch=A%
|count=5
}}
</syntaxhighlight>Output:{{#dpl:
|namespace=File
|titlematch=A%
|count=5
}}
==List of common parameters==
===Criteria for page selection===
{| class="wikitable" style="width:100%;"
!Parameter
!Syntax
! style="width:380px;" |Description
|-
|category
|''<nowiki>|category=QM|Setup...</nowiki>''
| style="width:380px;" |Pages in the category QM OR Setup
|-
|
|''<nowiki>|category=QM&Setup&...</nowiki>''
| style="width:380px;" |Pages in the categories QM AND Setup
|-
|
|''<nowiki>|category=QM|Setup...|category=Admin</nowiki>''
| style="width:380px;" |Pages in the categories QM OR Setup, and pages in the category Admin
|-
|notcategory
|''<nowiki>|notcategory=QM</nowiki>''
| style="width:380px;" |Pages that are not in the category QM
|-
|categoriesminmax
|''<nowiki>|category=QM|categoriesminmax=2</nowiki>''
| style="width:380px;" |Pages that are in the category QM and in at least 2 more categories
|-
|
|''<nowiki>|category=QM|categoriesminmax=,1</nowiki>''
| style="width:380px;" |Pages that are only in the category QM and in no other category
|-
|namespace
|''<nowiki>|namespace=</nowiki>''
| style="width:380px;" |Pages in the namespace (Main)
|-
|
|''<nowiki>|namespace=Help|Manual</nowiki>''
| style="width:380px;" |Pages in the namespace Help OR Manual
|-
|namespacenot
|''<nowiki>|namespacenot=Help</nowiki>''
| style="width:380px;" |Pages that are not in the namespace Help
|-
|
|''<nowiki>|namespacenot={{NAMESPACE}}</nowiki>''
| style="width:380px;" |Pages that are not in the namespace of the current wiki page
|}
===Output-Format===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Description
|-
|mode
|''<nowiki>|mode=ordered</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Unordered list
|-
|
|''<nowiki>|mode=unordered</nowiki>''
|Numbered list
|-
|
|<nowiki>|</nowiki>''mode=none''
|Line breaks
|-
|
|<nowiki>|</nowiki>''mode=category''
|Pages are grouped alphabetically with a letter heading (similar to category pages)
|-
|
|''<nowiki>|mode=inline|inlinetext=&amp;nbsp; &amp;bull; &amp;nbsp;</nowiki>''
|Page names are listed on the same line and separated with a bullet point
|}
===Sorting===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Description
|-
|ordermethod
|''<nowiki>|ordermethod=title</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Ordered by page (prefix+)title
|-
|
|''<nowiki>|ordermethod=titlewithoutnamespace</nowiki>''
|Ordered by page name independent of namespace
|-
|
|''<nowiki>|ordermethod=counter</nowiki>''
|Ordered by number of page views (popularity)
|-
|
|''<nowiki>|ordermethod=size</nowiki>''
|Ordered by page size
|-
|
|''<nowiki>|ordermethod=firstedit</nowiki>''
|Ordered by creation date
|-
|
|''<nowiki>|ordermethod=lastedit</nowiki>''
|Ordered by last edit date
|-
|
|''<nowiki>|ordermethod=user,firstedit</nowiki>''
|Ordered by author, then by creation date
|-
|
|''<nowiki>|ordermethod=user,lastedit</nowiki>''
|Ordered by last editor, then by last edit date
|-
|order
|''<nowiki>|order=ascending</nowiki>''
|Sorted in ascending order
|-
|
|''<nowiki>|order=descending</nowiki>''
|Sorted in descending order
|}
===Display of meta data===
{| class="wikitable" style="width:100%;" data-ve-attributes="{&quot;style&quot;:&quot;width:100%;&quot;}"
!Parameter
!Syntax
! style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Description
|-
|addcategories
|''<nowiki>|addcategories=true</nowiki>''
| style="width:380px;" data-ve-attributes="{&quot;style&quot;:&quot;width:380px;&quot;}" |Shows all categories of a page after the page name
|-
|addpagecounter
|''<nowiki>|category:QM|ordermethod=counter|order=descending</nowiki>''
''|addpagecounter=true|count=5''
|Shows the 5 most popular pages in the category QM
|-
|adduser
|''<nowiki>|category=QM|ordermethod=lastedit|adduser=true</nowiki>''
|Adds the name of the last editor in front of the page name
|-
|addauthor
|''<nowiki>|category=QM|addauthor=true</nowiki>''
|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.
See also: https://www.mediawiki.org/wiki/Help:Tracking%20categories
{{Box Links-en|Topic1=[[Reference:DynamicPageList3]]}}
[[en:{{FULLPAGENAME}}]]
[[de:Handbuch:Erweiterung/DynamicPageList3]]
[[Category:Organization]]
[[Category:Customization]]

Revision as of 14:31, 14 April 2022

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/BlueSpiceCategoryCheck . . Categories: Advanced | Editing
  5. 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=&nbsp; &bull; &nbsp; 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

File history

Click on a date/time to view the file as it appeared at that time.

Date/TimeThumbnailDimensionsUserComment
current11:03, 12 April 2022Thumbnail for version as of 11:03, 12 April 20221,153 × 427 (145 KB)Margit Link-Rodrigue (talk | contribs)

The following 2 pages use this file:

Metadata

Discussions