当前浏览:首页 / WordPress函数 / comments_number()

comments_number( string|false $zero = false, string|false $one = false, string|false $more = false, int|WP_Post $post_id )

显示当前文章评论数的语言字符串

comment 评论more...


参数

$zero

(string|false)(可选) 无评论文本。

默认值: false

$one

(string|false)(可选) 一条评论的文本。

默认值: false

$more

(string|false)(可选) 多条评论的文本。

默认值: false

$post_id

(int|WP_Post)(可选) 文章ID或WP_Post对象。默认值为全局$post



源码

查看源码 官方文档


更新日志

版本描述
5.4.0$deprecated参数更改为$post_id
0.71开始引入

使用示例

  • 示例1

    对评论数量的文本响应

    根据评论数量显示文本:评论计数为0:无回复;评论数1:1回复;多条评论(共42条)显示42条回复。

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

    评论部分标题

    您可能希望在您的评论部分上方有一个标题,其中包括评论的数量。这个例子展示了如何做到这一点,并使所有字符串也可以翻译。

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

    ‘comments_number’过滤器的使用

    add_filter( 'comments_number', 'wporg_com_num', 10, 2 );
    function wporg_com_num ( $out, $num ) { // Two parameter as in filter described
        if ( 0 === $num ) { 
            $out = '0 Comments'; // If No comments
        } elseif ( 1 === $num ) {
            $out = '1 Comment'; // If 1 comment
        } else {
            $out = $num . ' Comments'; // More than 1 comment
        }
    
        return $out;
    }