WordPress函数wp_count_comments详细用法教程解析

函数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，则计算的评论数量将只包括已审核的评论，否则将包括待审核和垃圾评论。
- 该函数可以用于主题文件和插件中，以获取指定文章或页面的评论数量。