Templatetags reference



{% 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 %}

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.