WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Boone's Pagination

A handy, extensible class for paginating your custom post type lists.

Here's how I recommend using the class.

  1. Either activate this plugin, or include the class in your own plugin file.
  2. When you start to render the page with the post list, instantiate the pagination class, using an argument array if you'd like:
$pargs = array(
  'get_per_page_key' => 'perpage',
  'get_paged_key'    => 'current_page',
  'per_page'         => 15
);
$pagination = new BBG_CPT_Pag( $args );
  1. When constructing your query arguments (for query_posts() or WP_Query), you can use the class to get your pagination arguments out of the $_GET parameters. For instance:
$args = array(
  ...
  'posts_per_page' => $pagination->get_per_page,
  'paged' => $pagination->get_paged
  ...
);
query_posts( $args );
  1. After firing the query, use the setup_query() method to populate the rest of the class. If you used query_posts(), you don't need an argument:
$pagination->setup_query();

If you use new WP_Query, you'll have to pass the query object:

$my_query = new WP_Query;
$pagination->setup_query( $my_query );
  1. Then you can use all sorts of fun methods, like
$pagination->paginate_links();
$pagination->currently_viewing_text();

Requires: WordPress 3.1 or higher
Compatible up to: WordPress 3.3.2
Last Updated: 2012-5-2
Downloads: 619

Ratings

3 stars
3 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.