WordPress.org

Ready to get started?Download WordPress

Plugin Directory

3pagination

Navigate to any page between 1 and 999 with no more than 3 clicks - no need to modify theme files.

Installation

  1. Upload 3pagination.php to the /wp-content/plugins/ directory OR choose Plugins->Add New and type "3pagination".
  2. Activate the plugin through the Plugins menu in WordPress
  3. Go to Settings->3pagination to set labels, placement and CSS.
  4. Done!

How to use

All options can be set in an options page, the pagination container can be injected or appended to the existing DOM. If you are unsure about the HTML structure of your Website, you can do the following (in Firefox):

  1. Right click the spot where you wish the pagination to appear and choose `Inspect Element (Q)` from the menu list
  2. Copy the id of the container, i.e. #wrapper.someclass
  3. To append or prepend the pagination to this container, paste it's id into the appropriate field of the Placement section under `Settings->3pagination`
  4. Choose on which pages (archives, search etc.) the pagination should appear. Done!

How to use - old school

You can, if you want (or to have your website degrade gracefully), call the class methods in your theme files.

draw() : Display the pagination

draw ( $pretty = TRUE, $max_num_pages = FALSE, $labels = TRUE, $css = 'classic', $wp_query = FALSE )
  • $pretty (optional) | Are you using pretty permalinks?
  • $max_num_pages (optional) | Limit to a maximum number of pages
  • $labels (optional) | Display or not the navigation arrows
  • $css (optional) | CSS class name that will be appended to the main div container
  • $wp_query (optional) | custom WP query object

get() : Return the pagination as a HTML string

get ( $pretty = TRUE, $num_items = FALSE, $per_page = FALSE, $labels = TRUE, $css = 'classic', $wp_query = FALSE )

Example usages

threepagination::draw ( TRUE, FALSE, FALSE, 'my_custom_class', FALSE )

Displays the pagination on a website that uses pretty urls, takes the standard page count, hides the navigation arrows, attributes a CSS class 'my_custom_class' to the pagination container and uses the global query object.

$string = threepagination::get ()

Save the pagination in the $string var.

Requires: 3.3.2 or higher
Compatible up to: 3.6.1
Last Updated: 2013-8-10
Downloads: 2,214

Ratings

5 stars
5 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.

0,1,0
100,1,1