Weblog Entry and Comment Pagination

The pagination feature for both weblog entries and comments works identically and allows you to display a limited number of entries and then automatically link to the next set. That way you can, for example, show comments 1-10 on the first page and automatically link to pages that display 11-20, 21-30, etc.

You have two choices as to the style of the navigation element. The first method would look something like this:

Page 27 of 344 pages « First < 11 12 13 14 15 > Last »

The second method is a more traditional "next page" / "previous page" output:

Previous Page | Next Page

Pagination will also automatically restrict itself to any category you're currently viewing. So if you have a category specified in your weblog entries tag or you are viewing the entries of a category, then the pagination links will automatically restrict themselves to only entries in that category.

Example Code

Here are two basic code examples, one for each of the methods mentioned above. Information about the variables and parameters are covered later.

{exp:weblog:entries weblog="news" orderby="date" sort="desc" limit="1" paginate="bottom"}

	

<h2>{title}</h2>



{summary}



{body}



{paginate}

<p>Page {current_page} of {total_pages} pages {pagination_links}</p>

{/paginate}



{/exp:weblog:entries}

It is important to note that it does not matter where you put your {paginate} code within the weblog entries tag. The pagination code will be "stripped out" of the regular output and placed in the appropriate location according to what you specify with the paginate= parameter (detailed below).

And for the "next/previous" method:

{exp:comment:entries weblog="news" sort="desc" limit="1" paginate="bottom"}

	

{comment}



<p>By {name} on {comment_date format="%Y %m %d"}</p>



{paginate}



{if previous_page}

<a href="{auto_path}">Previous Page</a> &nbsp;

{/if}



{if next_page}

<a href="{auto_path}">Next Page</a>

{/if}



{/paginate}



{/exp:comment:entries}

Parameters

paginate="bottom"

paginate=

paginate="top" paginate="bottom" paginate="both"

This parameter determines where the pagination code will appear for your weblog entries or comments:

top: The navigation text and links will appear above your list of entries.
bottom: The navigation text and links will appear below your list of entries.
both: The navigation text and links will appear both above and below your list of entries.

If no parameter is specified, the navigation block will default to the "bottom" behaviour.

paginate

{paginate}



{/paginate}

The opening and closing tags for pagination. This can to be used in conjunction with the paginate= parameter to determine where the contents of this tag will appear. See below for the available variables for use inside this tag. This tag is wrapped around either the single variables (see below) or the next/previous variable pairs.

if next_page

{if next_page}



{/if}

This tag will conditionally display the code inside the tag if there is a "next" page. If there is no next page then the content simply will not be displayed.

if previous_page

{if previous_page}



{/if}

This tag will conditionally display the code inside the tag if there is a "previous" page. If there is no previous page then the content simply will not be displayed.

Variables

{auto_path}
{current_page}
{pagination_links}
{total_pages}

These individual variables are for use inside the {paginate} tag pair.

auto_path

{auto_path}

The {auto_path} variable is used inside of the {if next_page} and {if previous_page} variable pairs. It is dynamically replaced with the correct path to the next/previous page. Unlike other "path" variables, this variable does not require the Template_Group/Template to be specified.

current_page

{current_page}

This variable is replaced by the page number of the current page you are viewing.

pagination_links

{pagination_links}

The dynamically created pagination links. These show the current page you are on as well as "surrounding" pages in addition to links for nex/previous pages and first/last pages. The output of the variable looks similar to this:

« First < 11 12 13 14 15 > Last »

total_pages

{total_pages}

The total number of pages of weblog entries or comments you have.

[ Permalink ] Posted by: Eric Barstad on 12 December 2007 1:33pm
	It might be worth noting that the weblog entries parameter “dynamic” shouldn’t be set to “off” if you want pagination to work properly.
[ Permalink ] Posted by: Robin Sowell on 13 November 2007 11:20am
	Just a note- if you are on a single entry page- i.e., a url with an entry id or url title in it, and you want to page from the current entry to the next entry- you need to use Next/Prev tags, which go outside of the weblog entries tag. So- two different types of pagination may be used, depending on whether you are on a true single entry page or not.
[ Permalink ] Posted by: supersusie on 23 August 2007 6:52pm
	If you don’t want pagination to appear when it’s not required by the number of posts (i.e. if you don’t want it to say “Page 1 of 1”)—use this code: `{paginate} {if "{total_pages}" != 1}<p>Page {current_page} of {total_pages} pages {pagination_links}</p>{/if} {/paginate}`

Weblog Entry and Comment Pagination

Example Code

Parameters

Variable Pairs

Variables

User Contributed Notes