Manual:Extension/DynamicPageList3

The extension DynamicPageList3 allows you to include lists of wiki pages on any content page.

Application examples

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

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

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 imn the namespace Manual in a 1-column layout:

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

                

Output:

• Files
• Images
• Tables
• Tables/Examples
• Version comparison

Selecting pages by namespace

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

                

Output:

• Admin Manual Introduction
• Archive/Extension/DocumentManager
• Archive:Extension/RatedComments
• BlueSpice Layout
• BlueSpice Layout/Footer

Selecting pages by category

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

                

Output:

Extension:DynamicPageList (DPL), version 3.3.2: Warning: No results.

Selecting pages with specific naming patterns

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

                

Output:

• File:A1.png
• File:A1A3.png
• File:AbBlSp1.jpg
• File:AboutBlSp1.jpg
• File:AddPhoto.jpg

Show a random page in a category

                    <div style="border:2px solid #f6f6f6; padding:10px; width:500px; height:500px; overflow:auto;">
{{#dpl:
|category=Customization
|randomcount=1
|includepage=*
|includemaxlength=10
|format=,\n==[[%PAGE%]]==\n,,}}
</div>

                

Output:

Manual:Extension/BlueSpiceBookshelf/Customized PDF OutputChanging the logo

How to adjust page breaks in multi-page PDFs.

Adjusting page breaks

By default, each chapter and sub-chapter in a Book-PDF is started on a new page. To avoid these page breaks and to create a continuous chapter flow, an administrator can add the following code

To change the logo of your wiki, update the logo path via the Config manager, extension BlueSpiceFoundation:

• Logo path: The logo image should be stored in the /images folder of your installation. If you store it in the /skins folder of your BlueSpice installation, it could be overwritten with an upgrade.

To upload the logo directly in the wiki:

1. Upload the logo on the page Extended file list (Special:ExtendedFilelist). This is a link under the Global actions navigation.
2. Search for the logo name in the extended file list.
3. Click on the thumbnail image of the logo. This opens the logo on a separate page.
   
   

   logo thumbnail image
4. Copy the relative logo path from the address bar.In a typical Wiki configuration, this path starts with /w/.... .
   
   

   relative image path
5. Paste the logo path into the text field for the logo.
   
   

   logo path
6. Click Save.
7. Refresh the page (Strg+F5).
   If the uploaded logo is too large, you can add the following code snippet to the page MediaWiki:Common.css

:/*PDF book - no page breaks between chapters*/ .bs-page-content { page-break-after: avoid; } If you want to start the main chapters on separate pages, use this code instead:/*PDF book - page break only after chapter levl 1 */ .bs-page-content { page-break-after: avoid; } .bs-page-content.booklevel-1 { page-break-before: always; }

You can add further chapter levels as needed:

/*PDF book - page breaks after chapter levels 1 and 2*/ .bs-page-content { page-break-after: avoid; } .bs-page-content.booklevel-1, .bs-page-content.booklevel-2 { page-break-before: always; }

1. . This automatically adjusts the image to the height of the main toolbar:

                                   .bs-logo a {background-size: contain;}
                               

• Favicon path: The favicon image should be stored in the /images folder of your installation. If you store it in the /skins folder of your BlueSpice installation, it could be overwritten with an upgrade. Favicon images have the file extension .ico.

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.

Related info

• Reference:DynamicPageList3