Proper Pagination
A flexible framework for creating semantic pagination controls for a listings page based on established usability patterns.
Ratings
Last updated
January 4, 2010
Version
1.3
Active installations
200
This plugin is primarily aimed at theme developers, and intends to ease the creation of semantic, usable pagination controls for WordPress listings pages, such as arhive, author, category, search, tag listings etc.
Inspired by The Loop and WP_Query, this plugin stays out of the theme developer’s way, allowing her to create the markup needed by providing the following template tags:
pp_has_pagination– determines whether the current ‘view’ has any pagination to display, i.e. whether the content being browsed spans more than 1 pagepp_the_pagination– initiates the pagination context, should be called at the beginning of each loop iterationpp_rewind_pagination– resets the pagination context, so that the pagination loop can be iterated over multiple timespp_is_current_page– for use in the pagination loop, returns a boolean indicating whether the current loop iteration is for the current pagepp_has_previous_page– for use in the pagination loop, returns a boolean indicating whether there is a previous page, e.g. when at page 1, there is no previous pagepp_has_next_page– for use in the pagination loop, returns a boolean indicating whether there is a next page, e.g. when at page N of N, there is no next pagepp_the_page_permalink– for use in the pagination loop, echos the permalink for the current pagepp_the_previous_page_permalink– for use in the pagination loop, echos the permalink for the previous pagepp_the_next_page_permalink– for use in the pagination loop, echos the permalink for the next pagepp_the_first_page_permalink– for use in the pagination loop, echos the permalink for the first pagepp_the_last_page_permalink– for use in the pagination loop, echos the permalink for the last pagepp_the_page_num– for use in the pagination loop, echos the page number of the current page being iterated over
For example, the following arrangement of template tags would provide a rudimentary pagination control:
<?php if (pp_has_pagination()) : ?>
<div class="pagination">
<!-- the previous page -->
<?php pp_the_pagination(); if (pp_has_previous_page()) : ?>
<a href="<?php pp_the_previous_page_permalink(); ?>" class="prev">newer stories</a>
<?php else : ?>
<span class="current prev">newer stories</span>
<?php endif; pp_rewind_pagination(); ?>
<!-- the page links -->
<?php while(pp_has_pagination()) : pp_the_pagination(); ?>
<?php if (pp_is_current_page()) : ?>
<span class="current"><?php pp_the_page_num(); ?></span>
<?php else : ?>
<a href="<?php pp_the_page_permalink(); ?>"><?php pp_the_page_num(); ?></a>
<?php endif; ?>
<?php endwhile; pp_rewind_pagination(); ?>
<!-- the next page -->
<?php pp_the_pagination(); if (pp_has_next_page()) : ?>
<a href="<?php pp_the_next_page_permalink(); ?>" class="next">older stories</a>
<?php else : ?>
<span class="current next">older stories</span>
<?php endif; pp_rewind_pagination(); ?>
</div>
<?php endif; ?>
The template tags on offer by this plugin provide the theme developer with an unlimited array of possibilities for marking up the pagination control in a semantic manner.
For more information, see the original blog post.
This plugin is available for download to be used on your WordPress self-hosted installation.