Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A handy pagination class for WordPress custom post types
PHP
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
boones-pagination.php
loader.php
readme.txt

readme.txt

=== Boone's Pagination  ===
Contributors: boonebgorges
Tags: pagination, custom post types
Requires at least: WordPress 3.1
Tested up to: WordPress 3.3.2
Stable tag: 1.1

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

== Description ==

Here's how I recommend using the class.

1. Either activate this plugin, or include the class in your own plugin file.
1. 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();`

== Changelog ==

= 1.1 =
* Adds additional customization arguments. Thanks, r-a-y!

= 1.0.1 =
* Updates plugin structure to keep plugin metadata in a separate loader file

= 1.0 =
* Initial release
Something went wrong with that request. Please try again.