WordPress.org

Languages: English • 日本語 (Add your language)

Description

Displays the total number of comments, Trackbacks, and Pingbacks for the current post. This tag must be within The Loop.

Use get_comments_number() to retrieve the value.

Usage

 <?php comments_number( $zero, $one, $more ); ?> 

Parameters

$zero

(string) (optional) Text to display when there are no comments.

Default: 'No Comments'

$one

(string) (optional) Text to display when there is one comment.

Default: '1 Comment'

$more

(string) (optional) Text to display when there is more than one comment. % is replaced by the number of comments, so '% so far' is displayed as "5 so far" when there are five comments.

Default: '% Comments'

Examples

Text Response to Number of Comments

Displays text based upon number of comments: Comment count zero - no responses; comment count one - one response; more than one comment (total 42) displays 42 responses.

<p>
  This post currently has
  <?php comments_number( 'no responses', 'one response', '% responses' ); ?>.
</p>

Title For Comments Section

You might want to have a title above your comments section that includes the number of comments. This example shows how to do that and have all the strings also be translatable.

<h3>
printf( _nx( 'One Comment', '%1$s Comments', get_comments_number(), 'comments title', 'textdomain' ), number_format_i18n( get_comments_number() ) );
</h3>

Notes

Change Log

Since: 0.71

Source File

comments_number() is located in wp-includes/comment-template.php

Related

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()