Displays the language string for the number of comments the current post has.
Parameters
$zero
string
Optional
Text for no comments.
Default: false
$one
string
Optional
Text for one comment.
Default: false
$more
string
Optional
Text for more than one comment.
Default: false
$post
int|WP_Post
Optional
Post ID or WP_Post object. Default is the global $post.
Return
string Language string for the number of comments a post has.
Source
File: wp-includes/comment-template.php.
View all references
function get_comments_number_text( $zero = false, $one = false, $more = false, $post = 0 ) {
$number = get_comments_number( $post );
if ( $number > 1 ) {
if ( false === $more ) {
/* translators: %s: Number of comments. */
$output = sprintf( _n( "%s Comment", "%s Comments", $number ), number_format_i18n( $number ) );
} else {
// % Comments
/*
* translators: If comment number in your language requires declension,
* translate this to "on". Do not translate into your own language.
*/
if ( "on" === _x( "off", "Comment number declension: on or off" ) ) {
$text = preg_replace( "#<span class="screen-reader-text">.+?</span>#", "", $more );
$text = preg_replace( "/&.+?;/", "", $text ); // Remove HTML entities.
$text = trim( strip_tags( $text ), "% " );
// Replace "% Comments" with a proper plural form.
if ( $text && ! preg_match( "/[0-9]+/", $text ) && false !== strpos( $more, "%" ) ) {
/* translators: %s: Number of comments. */
$new_text = _n( "%s Comment", "%s Comments", $number );
$new_text = trim( sprintf( $new_text, "" ) );
$more = str_replace( $text, $new_text, $more );
if ( false === strpos( $more, "%" ) ) {
$more = "% " . $more;
}
}
}
$output = str_replace( "%", number_format_i18n( $number ), $more );
}
} elseif ( 0 == $number ) {
$output = ( false === $zero ) ? __( "No Comments" ) : $zero;
} else { // Must be one.
$output = ( false === $one ) ? __( "1 Comment" ) : $one;
}
/**
* Filters the comments count for display.
*
* @since 1.5.0
*
* @see _n()
*
* @param string $output A translatable string formatted based on whether the count
* is equal to 0, 1, or 1+.
* @param int $number The number of post comments.
*/
return apply_filters( "comments_number", $output, $number );
}