Difference between revisions of "Extension DPL"

Revision as of 06:35, 25 June 2009

As its name (Dynamic Page Lister) implies, DPL is a report generator for MediaWikis. This is the most important extension we provide. The name of this website (dpldemo) is derived from the idea to demonstrate the many uses of DPL. DPL is a true monster in terms of functionality. Although there is a detailed DPL manual most people will find it easier to look for an existing DPL example which is similar to their needs.

Once you have seen the examples you may want to

Examples: selecting articles

List articles by category

• Create a list of articles belonging to a certain category DPL Example 005
• Create a list of articles belonging or not belonging to certain categories DPL Example 006
• List articles belonging to subcategories DPL Example 007

Find articles which have been changed recently

• Find articles which have (not) been changed recently DPL Example 016

Show the context of an article

• Print a list of pages, templates, categories and images which are related to a certain article DPL Example 018
• Export an article form a wiki with all its (direct) environment (pages, templates, categories and images) DPL Example 024

Show Images

• List images which are part of a certain article DPL Example 019

Examples: defining the amount of output

Show template values

• show a single template parameter of a single page DPL Example 025
• Create a table of articles where the columns show parameter values of template calls DPL Example 001
• Make that table sortable and define a headline for the first column DPL Example 002
• Add meta data (hit count) and apply individual formatting to the fields DPL Example 003
• change the sequence of fields and apply a nested DPL within a phantom template DPL Example 004

Sort output according to values ot template parameters

• Sometimes you want to use the value of a template parameter as a sort key DPL Example 023

Show chapter content

• Show the content of a certain chapter of some articles DPL Example 011
• Show the content of a certain chapter of some articles if a given text pattern occurs DPL Example 012

Filter transcluded contents

• Suppress unwanted parts of content (text, links, catgeory assignments) transcluded from articles DPL Example 015

Other examples, showing meta data, content, images etc.

• simple example
• realistic example
• other examples
• treeview example

Examples: defining output layout

Tree output

• category tree DPL Example 008
• category tree (improved) DPL Example 009
• tree of relations, templates and categories for a given page DPL Example 010

Table output

Examples: Other features

Split large result sets into several pages

• Flip through a long result set DPL Example 013
• Flip through a long result set - improved version, needs DPL 1.7.9 - DPL Example 020
• Flip through a long result set - BEST PERFORMANCE, needs DPL 1.8.6 - DPL Example 027

Load DPL result set into an ARRAY for further manipulation

• Transfer the complete DPL result to an array using ArrayExtension DPL Example 014

Find parser function calls

• Find out which parser functions are used by the pages in your wiki DPL Example 026

Create a permuted index of template calls

• List articles ordered by the values they use to call a certain template DPL Example 017

EXPERIMENTAL FEATURE: DPL cache

• Cache the result of a DPL query for a specified time in the filesystem on the server DPL Example 021
• A demo of caching in combnation with scrolling DPL Example 022