掌握 WP_Comment_Query

在WordPress开发中，我们经常需要查询和操作评论数据，为了实现这一目标，WordPress提供了WP_Comment_Query类，本文将详细介绍如何使用WP_Comment_Query类来查询和操作评论数据。

1、WP_Comment_Query简介

WP_Comment_Query类是WordPress核心代码中的一个类，它位于wp-includes/comment-query.php文件中，这个类的主要作用是帮助我们查询和操作评论数据，通过使用这个类，我们可以方便地获取指定文章的评论、筛选评论、排序评论等。

2、使用WP_Comment_Query查询评论

要使用WP_Comment_Query类查询评论，首先需要创建一个WP_Comment_Query对象，然后设置相关参数，最后调用对象的get_comments()方法获取评论数据，以下是一个简单的示例：

// 创建一个新的WP_Comment_Query对象
$comments = new WP_Comment_Query();
// 设置查询参数
$comments->query(array(
    'post_id' => 123, // 指定文章ID
    'status' => 'approve', // 筛选已批准的评论
    'number' => 10, // 获取前10条评论
));
// 获取评论数据
$comments = $comments->get_comments();

在这个示例中，我们首先创建了一个新的WP_Comment_Query对象，然后设置了查询参数，包括指定文章ID、筛选已批准的评论和获取前10条评论，我们调用get_comments()方法获取评论数据。

3、使用WP_Comment_Query筛选评论

除了基本的查询参数外，WP_Comment_Query还提供了一些筛选参数，以便我们根据不同的条件筛选评论，以下是一些常用的筛选参数：

author：按作者筛选评论，可以是用户名、用户ID或用户对象。

parent：按父评论ID筛选评论。

meta_key和meta_value：按元数据筛选评论，例如按评论时间、评论等级等。

type：按评论类型筛选评论，例如普通评论、垃圾评论等。

orderby和order：按指定的字段和顺序对评论进行排序。

以下是一个使用筛选参数的示例：

// 创建一个新的WP_Comment_Query对象
$comments = new WP_Comment_Query();
// 设置查询参数和筛选参数
$comments->query(array(
    'post_id' => 123, // 指定文章ID
    'status' => 'approve', // 筛选已批准的评论
    'number' => 10, // 获取前10条评论
    'author' => 'admin', // 按作者筛选评论
    'parent' => 0, // 按父评论ID筛选评论
    'meta_key' => 'rating', // 按元数据筛选评论
    'meta_value' => '5', // 按元数据值筛选评论
    'type' => 'comment', // 按评论类型筛选评论
    'orderby' => 'date', // 按日期排序评论
    'order' => 'DESC', // 降序排序评论
));
// 获取评论数据
$comments = $comments->get_comments();

4、使用WP_Comment_Query排序评论

除了筛选参数外，WP_Comment_Query还提供了一些排序参数，以便我们根据不同的条件对评论进行排序，以下是一些常用的排序参数：

orderby：按指定的字段对评论进行排序，例如按日期、按ID等。

order：按指定的顺序对评论进行排序，例如升序、降序等。

以下是一个使用排序参数的示例：

// 创建一个新的WP_Comment_Query对象
$comments = new WP_Comment_Query();
// 设置查询参数、筛选参数和排序参数
$comments->query(array(
    'post_id' => 123, // 指定文章ID
    'status' => 'approve', // 筛选已批准的评论
    'number' => 10, // 获取前10条评论
    'author' => 'admin', // 按作者筛选评论
    'parent' => 0, // 按父评论ID筛选评论
    'meta_key' => 'rating', // 按元数据筛选评论
    'meta_value' => '5', // 按元数据值筛选评论
    'type' => 'comment', // 按评论类型筛选评论
    'orderby' => 'date', // 按日期排序评论
    'order' => 'DESC', // 降序排序评论
));
// 获取评论数据并按照指定格式输出
foreach ($comments as $comment) { ?>
    <div class="comment">
        <p><?php echo get_avatar($comment->comment_author_email, 64); ?><?php echo $comment->comment_author; ?></p>
        <p><?php echo $comment->comment_content; ?></p>
        <p><?php echo $comment->comment_date; ?></p>
    </div><!-/.comment --><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php } ?><?php endwhile; ?>