Skip to content

boonebgorges/boones-pagination

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

=== 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

About

A handy pagination class for WordPress custom post types

Resources

Stars

Watchers

Forks

Packages

 
 
 

Languages