Templatetags reference¶
paginate¶
Usage:
{% paginate items %}
After this call, the items variable in the template context is replaced by only the entries of the current page.
You can also keep your items original variable (usually a queryset) and add to the context another name that refers to items of the current page, e.g.:
{% paginate items as page_items %}
The as argument is also useful when a nested context variable is provided as queryset.
The number of paginated items is taken from SIMPLE_PAGINATION_PER_PAGE setting , but you can override the default locally, e.g.:
{% paginate 20 items %}
Of course you can mix it all:
{% paginate 20 items as paginated_items %}
show_pageitems¶
Usage:
{% show_pageitems %}
This call in the template will give a digg-style page sequence that contain following values with other page links:
- ‘previous’: will display the previous page in that position;
- ‘next’: will display the next page in that position;
- ‘first’: will display the first page as an arrow;
- ‘last’: will display the last page as an arrow;
This must be called after paginate.