Creates a new pagelist object. The current pagelist will be replaced. A foreach loop can be used to iterate over the pagelist object. This method does not have any output. To only update the configuration of the current pagelist, without resetting all other parameters, the pagelist method can be used instead.
<@ newPagelist { options } @>
breadcrumbs or children. In case this parameter is false, within a loop the context always changes dynamically to the current page.'{"url": "/(work|blog)/"}' or even '{"url": "@{ regex }"}'.limit parameter.sort: "date desc, title asc" will first sort all pages by date in descending order and then by title in ascending order. Setting this parameter to false will sort the pages by :basename asc.| operator, like template: "page|home".To get all pages of the first level and iterate over them, like a simple top navigation, you can use the following snippet:
<@ newPagelist {
type: 'children',
parent: '/'
} @>
<@ foreach in pagelist @>
<a href="@{ url }">@{ title }</a>
<@ end @>
A more complex example could be a search results page with filters and pagination.
Note that it is possible to use query string parameters in the option array for dynamic filtering, searching and pagination (lines 3, 4 and 8).
<@ newPagelist {
excludeHidden: false,
filter: @{ ?filter },
search: @{ ?search },
sort: ':basename asc',
template: 'documentation',
limit: 10,
page: @{ ?page | def (1) }
} @>
Filtering a pagelist by using the match option can be done as follows. Note that the JSON string is wrapped in single quotes.
<@ newPagelist {
match: '{"url": "@{ regex }"}'
} @>
It is also possible to match pages by passing multiple regex patterns.
<@ newPagelist {
match: '{"url": "@{ regex }", ":level": "/2/"}'
} @>