Example 1

Our demo web site contains some articles on fictitious countries (this is also the name of their common category).

Extension:DynamicPageList (DPL), version 3.2.1: Warning: Unknown parameter 'inline' was ignored. Help: available parameters: addauthor, addcategories, addcontribution, addeditdate, addexternallink, addfirstcategorydate, addlasteditor, addpagecounter, addpagesize, addpagetoucheddate, adduser, allowcachedresults, allrevisionsbefore, allrevisionssince, articlecategory, cacheperiod, categoriesminmax, category, categorymatch, categoryregexp, columns, count, createdby, debug, distinct, dominantsection, eliminate, escapelinks, execandexit, firstrevisionsince, fixcategory, format, headingcount, headingmode, hiddencategories, hitemattr, hlistattr, ignorecase, imagecontainer, imageused, include, includematch, includematchparsed, includemaxlength, includenotmatch, includenotmatchparsed, includepage, includesubpages, includetrim, inlinetext, itemattr, lastmodifiedby, lastrevisionbefore, linksfrom, linksto, linkstoexternal, listattr, listseparators, maxrevisions, minoredits, minrevisions, mode, modifiedby, multisecseparators, namespace, noresultsfooter, noresultsheader, notcategory, notcategorymatch, notcategoryregexp, notcreatedby, notlastmodifiedby, notlinksfrom, notlinksto, notmodifiedby, notnamespace, nottitlematch, nottitleregexp, notuses, offset, oneresultfooter, oneresultheader, openreferences, order, ordercollation, ordermethod, qualitypages, randomcount, redirects, replaceintitle, reset, resultsfooter, resultsheader, rowcolformat, rows, rowsize, scroll, secseparators, showcurid, shownamespace, skipthispage, stablepages, suppresserrors, table, tablerow, tablesortcol, title, titlegt, titlelt, titlematch, titlemaxlength, titleregexp, usedby, userdateformat, uses.

Test55542008-02-16 best time everNowa kategoriaTest 001Test 002Test 003Test 004Test 005Test 006Test 007Test 008Tmp22008/08/23 SD testEvent template zh-twEvent intro zh-twA12008-04-24 nnnYyyFordProperty:AgeStudentSemantic MediaWiki with Property Clusters (print version)Task actTask thinkTest what links here with categories pageAbc/defMusicPage in Test-1PhysicsPage in Test 1My very special event (2007/03/01)DPLMATRIXMechanicsPhilosophyBruxelles cityTown ATown BTask prepare mealTask buy foodA ECP-00055 test pagePseudo Namespace:Dummy2007-08-24 jehhuTest DummyTestpageTest transclusion bug 2Stachoo testThe Colour of MagicThe Smell of FutureBug ApoArticle with underscoreThe Light FantasticPage APage HTodotest3Page DPage EActivity Page 1Activity Page 2FrChessCezanneURLA2TromboneAaPageTextDateTaiwanEmailTest calendar May 2007Test calendar June 2007Test calendar July 2007Test calendar August 2007Test calendar September 2007Test calendar October 2007Test calendar November 2007NumberStringBooleanGlossaryZTemperatureTodotest12009-06-26 asdfPage BPage CAnnotation URIPage FSignacVolkoV Test A Cat BVolkoV Test B Cat CBug Apo 3Bug'Apo 4'Bug Apo 52007-06-01 Test EventGeographic coordinateDistinct test1007/05/26 Nice Calendar :)2007/08/02 Holiday starts00001Van GoghTodotest2Xxx2007/05/11 Calender CheckMuro di Berlino2007-06-21 boo waz here2007-10-31 Holiday!YYYY-12-24 Christmas EveYYYY/mm/dd my event name2007/06/12 some other event2007-07-18 EPAFDPL Example 007 main page 2Test Amp/22007/05/29 TEST EVENT2007/06/15 Test2 eventDPL Example 007 sub page 11DPL Example 007 sub page 12DPL Example 007 sub page 21DPL Example 007 sub page 22DPL Example 007 sub page 23DPL Example 007 sub page 24DPL Example 007 sub page 25DPL Example 007 sub page 262007/06/24 DesparateMunich2007-08-29 Workshop2007-08-13 testingBerlin207/05/10 Bolwing2007/07/31 !!!!!!!!!!!!!!!!!2007/07/25 St Jaume!ParisPage GGallery 32007/04/22 test12007/06/09 Test by tao.liPage size test page 1Test Amp2Bob Jones Out Sick2009-01-24 test22007/05/19 Update2007-06-09 My Vacation DayTable Bug 42007-11-27 Test number 12345Some Article 6HeidelbergTable Bug 3VolkoV Test C Cat A2008-04-24 xml2009-01-01 iyo test2007-04-19 test 19th april2007/12/252007-09-05 Out of officeVienna2008-04-01 testUNTITLEDCC2008-02-28 party2008-08-31 SRM recovery test19/04/2007 stpeterkomet2008-01-29 Test2Test 1.13 issueCity B2007-02-15 My very special event2007-04-19 Test Florian2007-06-03 Project AlphaTest Simple Forms 22007/06/13 ok2007-08-31 19:00 Vorstandssitzung2007/06/05 Evenement maintenance2007/06/30 Month name not displaying2007/05/25 TESTPloticus Demodata2007/06/16 Paul's Event2007/06/22 hahaW:de:Benutzer:Unendlich2007/10/31 HalloweenTable Bug 22007-08-30 Installation Calendar in personal wikiEqual Rites2007-04-05 Some Event2007/07/25 craig birthday2007/04/06 my event2007/06/30 gave up to install this calendar2007/07/072007/04/03 vacantion2007/08/28 today is the day2007-09-15 my evers2007/04/03 Daniels verjaardagPiano2009-06-28 butt dayGallery 3 sub2007/07/17 Mom's B-day2007/06/29 FS ToDoDPL Example 007 main page 12007/04/30 Mon événement2007-08-23 testingBug SQL 10642007/06/07 Gaudium in Poing2007/08/05 notisoFluteAn article which is only referenced by a DPL query2007-08-05 shit happensTest5555Muha TestTest uses2007/07/30 Я ухожу в отпуск2008-10-31 Project1 Kick-off2009-07-02 vacaciones2007/07/04 Jeremy BDay2007/05/17 test eventMtiTrans1MtiTrans2MtiTrans3Berliner Mauer2007-03-30 My very special event2007/03/05 third test event2010-02-14 San Valentín2007/04/28 my event name2007/05/03 my event name2008/11/12 Test2007/05/25 algo2007-08-10 birthdaytest2007/05/09 WooHoo2007/05/26 pvp2007/05/31 Bladadadmam2007/06/04 en la fing2007/06/06 Test2007/06/22 test2007/6/11 try out calendaring in mediawiki2007/06/15 Kevin out today2007/06/22 helloYYYY/mm/dd FSTest2007/07/10 A new wiki is born2007-07-13 Friday 13th2007-05-19 DIMON2008-04-24 wwww2008-08-28 vtest testing2010-05-05 testowy eventTemplates in Redirection2007-04-25 March for rights2007/06/03 June event2007/06/01 some event2007/04/26 some event05/04/2007 Chris2007/04/30 Un autre événement2007/05/03 hghg2007/05/05 hackeln2008-09-28 I think I have it working2007/04/16 my test event/mm/dd my event name2007-07-15 Baiardi2007/07/31 my bday2007-03-05 test event two2007-08-10 iso8601test2007/03/06 prova2007-09-01 ABC BirthdayYYYY-mm-dd my event nameNitin2007-09-06me me me2007-09-21 Day after tomorrow2007/07/02 Boulot2007/06/24 just another testSome Article 42007-07-22 Jocs especials a la Trinitat2007/04/25 DougTest2007/05/02 Sat Test2007/03/05 Test Event2007 04 03 daniels verjaardag2007/04/05 my event name2007-09-22 test2007/05/07 take wife out for movie -- Spiderman?2007/04/18 this events is still upcomng2007-01-01 Tims Test2007/07/07 testing cool2007/02/05 test test testTest debug2009-07-02 implantación2007-08-02 mewBerlin Wall2007/05/03 Training Basketball Team2007/06/13 Wiki meeting at 12 PMOktoberfestDatetestBassoonTest unescaped SQLManet2007/08/15 my event nameCity A2007/06/14 Practice Cal Entry2007-12-25 Xmas Day2007/06/21 milestone 4MissingTocMain2AbCTest linksfrom 22007/06/13 Sat and Russ Event2008-01-30 today by kdRandom Chapter Content 1Random Chapter Content 2Random Chapter Content 32007/07/27 FooBar's event5/3/07 8PM new eventDPL Example 029/DummyPageSandboxTablesort and columns2007/06/22 sprawdzanie kalendarzaSome Article 5Renoir2007/07/05 Post 4th Party2008-May-23 deliver assortment to Maple Ave2010-11-25 Anniversary2007/07/25 finally2007-10-17 milestone - tests completedNig1Nig2Test inx NutsShamim's Note2007/07/26 Greg's EventMissingTocMainNig32007/08/22 this is just a test2007/03/29 Something is happeningBTest Amp/1Test inx Fruit2007-09-29 Viajó Ana Feli a USAECP-00001Test inputboxTest matches2007/09/15 better not forget anniversary!!2007-09-28 Cours2007-11-05 Scary Monsters!2007/05/01 launch blogzapfel!2007-09-30 Just a checkHolzmadenNig42007-09-30 Another quick test2007-12-01 MeetingSome other tripsDPL Example 019Republic of Cape VerdeTest onlyinclude - included pageLucie2007-06-06 Meeting in ParisClass carTonyRepublic of BurundiMapDemo2007/04/27 iloveEventsSome Article 32007/04/28 中文Republic of Cameroon2007-12-20 BlablablaI3:Matrix1YYYY-MM-27 Test calendarClass testClass GameClass vehicleClass SubjectCache Demo 2ECP-00000ECP (Form)EventsTest reset categoriesArticle connected by DPL category keywordTest matrix2HenryFranceEricSome Article 2ItalyYYYY-MM-25 prepare plan for next monthClass Location2007-08-22 The Birthday PartyDPL Example 024Test subcategoriesClass PersonClass FreshmanPeople 2GermanyRepublic of Madagascar2007-09-28 my birthday; send me many gifts!New Issue (Form)2007-08-01 Masterplan: World dominationYYYY-10-03 National Holiday in GermanyTest linkstoClass Musical InstrumentAbcSpainTranslation listYTest2Test what links here with categoriesMtiMainMtiMain2Example 3a防DDOS模块mod evasive的使用说明出自开源百科2007-09-20 Tsotha-Lanti meets Britney SpearsHarry PotterHermione Jean GrangerUnited Republic of TanzaniaPeople 1Muha Test 2Test regexpExample 4Test Sort orderLisaTest2008-06-30 something cleverActivity 1Activity 2Activity 3Turnier Gruppe2DPL Example 011New Issue (Intro)TomTest columns测试内容我来测试wikiTest what links hereClass StudentSMWpc Documentation API CategoryTest what links here 2DPL Example 010 page 1DPL Example 010Test transclusion bug dataDPL Example 021Test ignorecaseNigunda TestTable with template inclusionsTest calendar previous monthCurrent eventsResultsheaderwithcolumnsBug sortkeyTest goalExecandexit not setting dplvarsSome Article 1Test category cloud subDPL Example 002DPL Example 012DPL Example 103Test redirectsBulomaSome tripsDPL Example 025Test offset&countTest cat listingDPL Example 009Grube MesselTest imagecontainerSMWpc Documentation API ObjectFormTest escapelinksCurrent events zh-twExtension PloticusEvent introTable bugTest revisionsInputbox extensionTest shownamespaceSomangoDPL Example 028Test titleTmpTest onlyincludeDPL Example 018Patch to LinkHoldersArrayTest Simple FormsTest exportSMWpc Documentation API TypeTest article structureDPL Example 001ADPL Example 102Examples of including a templateTatiana NahasDPL Example 101Page size test page 2SMWpc Documentation API ModelTest category listingSMWpc Documentation API InstancesTest section inclusionInterface listApache服务器架设的简单，由小P发布Test date formattingDPL Example 005DocTypes ExampleTurnier GruppePeterTest calendar February 2007DPL Example 004DPL Example 0262007-06-06 London Wiki WednesdayTest calendar April 2007Test calendar March 2007Test adduserTest category cloudTest linksfromListing Redirects and LocationStripMarkup extension

They all use a template named "Country" which has parameters like capital. The template produces a small table and a link to the country list we want to generate. There are chapters on religion and history in most of the articles. We show how to create a sortable wikitable list of those articles which gives some excerpts of the contents. <javascript src="sorttable"/>

DPL can be used as a mediawiki parser extension, which means that a special DPL tag is used:

parser extension syntax

<DPL>
  category=Fictitious country
  includepage={Country} dpl,#History,#Religion[20]
  addpagecounter=true
  mode=userformat
  listseparators=\n{|class=sortablewikitable id=123 \n!Country \n!Official Name \n!Capital \n!Dial Code \n!History \n!Religion \n|-,\n|-\n|[[%PAGE%]] (%COUNT%)\n,\n,\n|}
  secseparators=,\n|,,
</DPL>

We select articles by category ("Fictitious Country") and explain that we want to see contents from the template "Country" and from two chapters. We truncate the text on religion to a maximum of 10 characters. We create a sortable table which contains the article name (as a link) and its access frequency in the first column and the content pieces in the other columns. Note that at the end of truncated contents you will find a small arrow which links directly to the chapter from where the contents was taken. The formatting for the template variables is done in a special template which is by convention named after the original tenmplate plus a suffix (Template:Country dpl in our case). This template is very simple; it only presents the values for name, capital and dial code as columns of a table.

country list

Country	Official Name	Capital	Dial Code	History	Religion
DPL Example 007 main page 1 (%COUNT%)
Nigunda (%COUNT%)	Republic of Nigunda	Bamitogoo	237	some facts about ..→
Nigunda Test (%COUNT%)	Republic of Nigunda Test	Bamitogoo Test	237	Nigunda Test History - Chapter Sequence in the article doesn´t matter for DPL .. some facts about ..→
Somango (%COUNT%)	Somango Island	Aaaabququque	224	a text on the history of Somango; a text on the history of Somango; a text on the history of Somango; some facts about ..→

country list (2)

DPL can also be used as a mediawiki parser function, which is more powerful as it allows DPL to be used within templates, parameters being template calls or variable expansions. The disadvantage is that syntax looks less nice as the pipe character must be hidden in macros if used as a parameter contents. So the same example could also have been written as:

parser function syntax

{{#dpl:category=Fictitious country
  |includepage={Country} dpl,#History[50],#Religion
  |addpagecounter=true
  |mode=userformat
  |listseparators=\n{{(!}} class=sortablewikitable id=123
    \n!Country
    \n!Official Name
    \n!Capital
    \n!Dial Code
    \n!History
    \n!Religion
    \n{{!}}-,\n{{!-}}\n{{!}}[[%PAGE%]] (%COUNT%)\n,\n,\n{{!)}}
  |secseparators=,\n{{!}},,
}}

The result:

Country	Official Name	Capital	Dial Code	History	Religion
DPL Example 007 main page 1 (%COUNT%)
Nigunda (%COUNT%)	Republic of Nigunda	Bamitogoo	237	some facts about religious groups in Nigunda; some other facts about religious groups in Nigunda;
Nigunda Test (%COUNT%)	Republic of Nigunda Test	Bamitogoo Test	237	Nigunda Test History - Chapter Sequence in the ..→ some facts about religious groups in Nigunda; some other facts about religious groups in Nigunda Test;
Somango (%COUNT%)	Somango Island	Aaaabququque	224	a text on the history of Somango; a text on the ..→ some facts about religion in Somango

Have a look at a more realistic example ...