WordPress.org

Languages: English • 日本語 中文(简体) • zh-cn:paginate_comments_links (Add your language)

Description

Generate a new way to list the paged comments in the comment template. Instead of using Previous or Next Comments links, it displays a full list of comment pages using numeric indexes.

This is probably the most efficient way to paginate comments in WordPress 2.7 since it allows the users to select wich comment page wants to visit instead of clicking trough every single page using the next/prev links.

Example:

 1 2 3 ... 10 Next >> 

Usage

 <?php paginate_comments_links(); ?> 

Parameters

Needs Further Completion

'base' => add_query_arg( 'cpage', '%#%' ),
'format' => ,
'total' => $max_page,
'current' => $page,
'echo' => true,
'add_fragment' => '#comments'

See Function_Reference/paginate_comments_links for further information and some usage examples.

Styling

The function prints several css classes for further CSS styling:

.page-numbers 
.current
.next
.prev

Example Source Code

<span class='page-numbers current'>1</span>
 <a class='page-numbers' href='http://www.site.com/post-slug/comment-page-2/#comments'>2</a>
 <a class='next page-numbers' href='http://www.site.com/post-slug/comment-page-2/#comments'>Next »</a>

Working Example

http://www.lagzero.net/2008/12/descarga-el-parche-de-gta-iv-para-pc-gta-iv-pc-v1010/#comments

Uses in the Default Theme

The following code uses this function to create the Comments Pages index in the Default Theme's comments.php:

 <div class="navigation">
  <?php paginate_comments_links(); ?> 
 </div>
 
 <ol class="commentlist">
  <?php wp_list_comments(); ?>
 </ol>
 
 <div class="navigation">
  <?php paginate_comments_links(); ?> 
 </div>
 

Changelog

Since: 2.7.0

Related

• Migrating Plugins and Themes to 2.7/Enhanced Comment Display - Comments Paging Links
• Administration Panels > Settings > Discussion - Other comment settings

Comments Functions

• Function: cancel_comment_reply_link()
• Function: comment_author()
• Function: comment_author_email()
• Function: comment_author_email_link()
• Function: comment_author_IP()
• Function: comment_author_link()
• Function: comment_author_rss()
• Function: comment_author_url()
• Function: comment_author_url_link()
• Function: comment_class()
• Function: comment_date()
• Function: comment_excerpt()
• Function: comment_form_title()
• Function: comment_form(),
• Function: comment_ID()
• Function: comment_id_fields()
• Function: comment_reply_link()
• Function: comment_text()
• Function: comment_text_rss()
• Function: comment_time()
• Function: comment_type()
• Function: comments_link
• Function: comments_number()
• Function: comments_open(),
• Function: comments_popup_link()
• Function: comments_popup_script()
• Function: comments_rss_link()
• Function: get_avatar()
• Function: next_comments_link()
• Function: paginate_comments_links()
• Function: permalink_comments_rss()
• Function: previous_comments_link()
• Function: wp_list_comments()