Splitting output into pages

The Ditto &paginate parameter splits the output into pages each containing &display items. &paginate=`1` switches pagination on. The Ditto call must be uncached, [!Ditto? ... !], unless you are using the PHx plugin. In that case, the call is cached, [[Ditto? ... ]], but the page containing it must be set to "not cacheable" in the Page Settings.

Ditto generates several placeholders for paginated output. Place these on the page containing the Ditto call. To generate dividers between the numbers produced by [+pages+], use the &tplPaginatePage and &tplPaginateCurrentPage parameters linked to chunks. You can also apply styles to CSS classes "ditto_page" and "ditto_currentpage". Suitable text for "Next" and "Previous" in several languages is generated by setting the &language parameter, e.g. &language=`russian-UTF8`.

Unless &paginateAlwaysShowLinks is set to `1`, the Previous and Next links are suppressed on the first and last items.


The header line below is produced with these placeholders:
[+previous+] | [+pages+] [+next+] Page [+currentPage+] of [+totalPages+] showing items [+start+]-[+stop+] of [+total+]

and these template chunks:
pageSplitter: <a href="[+url+]">[+page+]</a> |
currentPageSplitter: [+page+] |


< Previous | 1 | 2 | 3 | Next > Page 1 of 3 showing items 1-3 of 9

[!Ditto? &parents=`455` &orderBy=`pagetitle ASC` &paginate=`1` &display=`3` &tplPaginatePage=`pageSplitter` &tplPaginateCurrentPage=`currentPageSplitter` &paginateAlwaysShowLinks=`1` !]

Cras velit. ITEM 467 Integer luctus. In nec

by Anon on 06-Dec-03 06:03
Integer luctus. In nec nisl adipiscing erat tincidunt fringilla

Duis tristique ITEM 463 urna id metus. Maecenas

by Anon on 28-Mar-03 14:02
Maecenas volutpat. In vitae arcu at quam congue dictum

In eu ITEM 466 purus eu mi sollicitudin

by Anon on 06-Sep-03 20:22
Quisque lacinia nisi eu ipsum. Integer ut elit