WordPress.org

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.