Examples/Parameter: scroll (example 1)

From DynamicPageList3 Manual
Revision as of 22:25, 17 September 2022 by miraheze:dpl3>CrystalClear
Please do not edit this page unless you're wanting to edit the manual itself, it is an example included in the manual.

Example

This selects pages from Category:Fruit examples. The count displays the first 3 articles using Scroll/URL syntax, and an empty offset also using that syntax; setting both using scroll/url syntax, allows their query values to be overwritten by URL. The scroll parameter fills the scroll/url parameter values. The resultsheader displays header text to show the count and current result start number. Setting allowcachedresults=false prevents caching, so result changes are immediately seen when the URL is changed, without the need to manually purge the MediaWiki cache.


The result is a static display of the first 3 pages, but their display offset (page to start at) and count can be overwritten just by adding two DPL3-specific URL parameters &DPL_count=3&DPL_offset=3 to the end of the (index.php-style) URL. If you copy/paste the URL into your browser's URL bar, you can see the next 3 results are loaded from the URL parameters:

  • https://dpl3.miraheze.org/w/index.php?title=Criteria_for_page_selection/Parameter:_scroll_(example_1)&DPL_count=3&DPL_offset=3
{{#dpl:execandexit=geturlargs}}
{{#dpl:
|category      = Fruit examples
|count         = {%DPL_count:1%}
|offset        = {%DPL_offset:0%}
|scroll        = yes
|resultsheader = Showing {%DPL_count:1%} pages starting from page ²{#expr:{%DPL_offset%} + 1}²:\n
|allowcachedresults = false
}}

Result

{{#dpl:execandexit=geturlargs}} {{#dpl: |category = Fruit examples |count = {%DPL_count:1%} |offset = {%DPL_offset:0%} |scroll = yes |resultsheader = Showing {%DPL_count:1%} pages starting from page ²{#expr:{%DPL_offset%} + 1}²:\n |allowcachedresults = false }}