函数wp_count_comments用于计算并返回指定文章或页面的评论数量。

函数定义:
wp_count_comments( $post_id, $approved_only = false )

参数:
- $post_id (int) (必需) 文章或页面的ID。
- $approved_only (bool) (可选) 是否只计算已审核的评论。默认值为false。

返回值:
一个对象,包含已审核、待审核和垃圾评论的数量。

示例用法:

1. 计算指定文章的评论数量:

$count = wp_count_comments( $post_id );
echo $count->total_comments; // 输出评论总数
echo $count->approved; // 输出已审核评论数
echo $count->awaiting_moderation; // 输出待审核评论数
echo $count->spam; // 输出垃圾评论数

2. 计算指定文章的已审核评论数量:

$count = wp_count_comments( $post_id, true );
echo $count->approved; // 输出已审核评论数

注意事项:
- 如果未指定$post_id参数,则函数将返回当前文章或页面的评论数量。
- 如果指定的文章或页面不存在,则函数将返回空对象。
- 如果$approved_only参数设置为true,则计算的评论数量将只包括已审核的评论,否则将包括待审核和垃圾评论。
- 该函数可以用于主题文件和插件中,以获取指定文章或页面的评论数量。