WordPress.org

Ready to get started?Download WordPress

Plugin Directory

WP-Paginate

WP-Paginate is a simple and flexible pagination plugin which provides users with better navigation on your WordPress site.

How can I override the default pagination settings?

The wp_paginate() and wp_paginate_comments() functions each takes one optional argument, in query string format, which allows you to override the global settings. The available options are:

  • title - The text/HTML to display before the pagination links
  • nextpage - The text/HTML to use for the next page link
  • previouspage - The text/HTML to use for the previous page link
  • before - The text/HTML to add before the pagination links
  • after - The text/HTML to add after the pagination links
  • empty - Display before markup and after markup code even when the page list is empty
  • range - The number of page links to show before and after the current page
  • anchor - The number of links to always show at beginning and end of pagination
  • gap - The minimum number of pages before a gap is replaced with an ellipsis (...)

You can even control the current page and number of pages with:

  • page - The current page. This function will automatically determine the value
  • pages - The total number of pages. This function will automatically determine the value

Example (also applies to wp_paginate_comments()):

<?php if(function_exists('wp_paginate')) {
    wp_paginate('range=4&anchor=2&nextpage=Next&previouspage=Previous');
} ?>

How can I style the comments pagination differently than the posts pagination?

When calling wp_paginate_comments(), WP-Paginate adds an extra class to the ol element, wp-paginate-comments.

This allows you to use the .wp-paginate-comments styles, already in wp-paginate.css, to override the default styles.

Requires: 2.6.0 (2.7.0 for comments pagination) or higher
Compatible up to: 3.9.1
Last Updated: 2014-7-3
Downloads: 235,329

Ratings

4 stars
4.4 out of 5 stars

Support

0 of 2 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

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

100,1,1
100,4,4
50,4,2 100,1,1
100,3,3 100,1,1
86,7,6 100,2,2
100,4,4 100,7,7
100,6,6 100,1,1 100,1,1
64,11,7 100,1,1 100,7,7 100,5,5
100,2,2
100,7,7
100,3,3 100,1,1
100,2,2 100,1,1
100,12,12 100,9,9
83,6,5
100,8,8
78,9,7
100,1,1
100,5,5
87,15,13 100,4,4
100,6,6
85,20,17
50,10,5
75,4,3
83,6,5
86,7,6
80,5,4
100,7,7
33,3,1
100,1,1
100,1,1
100,1,1
0,1,0
100,1,1
100,1,1
100,2,2