Examples/Parameter: scroll (example 1): Difference between revisions
imported>FrozenPlum (Refine now that the section itself is written.) |
imported>FrozenPlum m (Update categories and example text slightly) |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 6: | Line 6: | ||
==Example== |
==Example== |
||
This selects pages from [[:Category:Fruit examples]]. The <code>{{DPL|count}}</code> displays the first |
This selects pages from [[:Category:Fruit examples]]. The <code>{{DPL|count}}</code> displays the first article using {{DPL|URL parameters}}, and an empty <code>{{DPL|offset}}</code> also using that syntax; setting both using scroll/url syntax, allows their query values to be overwritten by URL. The <code>{{DPL|scroll}}</code> parameter fills the scroll/url parameter values. The <code>{{DPL|resultsheader}}</code> displays header text to show the count and current result start number. Setting <code>{{DPL|allowcachedresults}}=''false''</code> 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 <code>&DPL_count= |
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 <code>&DPL_count=1&DPL_offset=1</code> to the end of the ([[mw:Manual:Parameters_to_index.php|index.php]]-style) URL. If you '''copy/paste the URL into your browser's URL bar''', you can see the next result is loaded from the URL parameters: |
||
* <code><nowiki>https://dpl3.miraheze.org/w/index.php?title=Criteria_for_page_selection/Parameter:_scroll_(example_1)&DPL_count= |
* <code><nowiki>https://dpl3.miraheze.org/w/index.php?title=Criteria_for_page_selection/Parameter:_scroll_(example_1)&DPL_count=1&DPL_offset=1</nowiki></code> |
||
<pre> |
<pre> |
||
Line 17: | Line 17: | ||
{{#dpl: |
{{#dpl: |
||
|category = Fruit examples |
|category = Fruit examples |
||
|count = {%DPL_count: |
|count = {%DPL_count:1%} |
||
|offset = {%DPL_offset:0%} |
|offset = {%DPL_offset:0%} |
||
|scroll = yes |
|scroll = yes |
||
|resultsheader = Showing {%DPL_count: |
|resultsheader = Showing {%DPL_count:1%} pages starting from page ²{#expr:{%DPL_offset%} + 1}²:\n |
||
|allowcachedresults = false |
|allowcachedresults = false |
||
}} |
}} |
||
Line 29: | Line 29: | ||
{{#dpl: |
{{#dpl: |
||
|category = Fruit examples |
|category = Fruit examples |
||
|count = {%DPL_count: |
|count = {%DPL_count:1%} |
||
|offset = {%DPL_offset:0%} |
|offset = {%DPL_offset:0%} |
||
|scroll = yes |
|scroll = yes |
||
|resultsheader = Showing {%DPL_count: |
|resultsheader = Showing {%DPL_count:1%} pages starting from page ²{#expr:{%DPL_offset%} + 1}²:\n |
||
|allowcachedresults = false |
|allowcachedresults = false |
||
}} |
}} |
||
<noinclude> |
<noinclude> |
||
[[Category:Select by category-related criteria]] |
[[Category:Select by category-related criteria]] |
||
[[Category:Uses execandexit parameter]] |
|||
[[Category:Uses category parameter]] |
[[Category:Uses category parameter]] |
||
[[Category:Uses count |
[[Category:Uses count parameter]] |
||
[[Category:Uses offset |
[[Category:Uses offset parameter]] |
||
[[Category:Uses scroll parameter]] |
[[Category:Uses scroll parameter]] |
||
[[Category:Uses resultsheader parameter]] |
[[Category:Uses resultsheader parameter]] |
||
[[Category:Uses URL parameter]] |
|||
[[Category:Uses resultsfooter parameter]] |
|||
[[Category:Uses allowcachedresults parameter]] |
[[Category:Uses allowcachedresults parameter]] |
||
</noinclude> |
</noinclude> |
Latest revision as of 07:24, 21 April 2023
Example
This selects pages from Category:Fruit examples. The count
displays the first article using URL parameters, 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=1&DPL_offset=1
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 result is loaded from the URL parameters:
https://dpl3.miraheze.org/w/index.php?title=Criteria_for_page_selection/Parameter:_scroll_(example_1)&DPL_count=1&DPL_offset=1
{{#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 }}