Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.


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


  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: 3 years ago
Active Installs: 60+


0 out of 5 stars


Got something to say? Need help?


Not enough data

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