WordPress 评论查询类 WP Comment Query 参考文档和使用示例

文 / @WordPress主题

WPCommentQuery简介

WP_Comment_Query 是用来查询WordPress评论数据的PHP类,源文件位于wp-includes/comment.php文件,我们可以使用该类查询 WordPress 数据库中 wp_comments 和 wp_commentmeta 数据表中的数据,该类从 WordPress 3.1 开始引入,只要 WordPress 的版本号大于等于 3.1,都可以直接使用 WPCommentQuery 类查询数据。

WPCommentQuery使用简介

<?php
$args=array(
//类参数
);

//新建查询
$comments_query=newWP_Comment_Query;
$comments=$comments_query->query($args);

//循环输入评论数据
if($comments){
	foreach($commentsas$comment){
		echo'<p>'.$comment->comment_content.'</p>';
	}
}else{
	echo'没有查询到数据。';
}
?>

参数说明

$status
(字符串)(可选)值返回指定状态的评论
  • 'hold'–未通过审核的评论
  • 'approve'–已审核的评论
  • 'spam'–被标记未垃圾的评论
  • 'trash'–回收站中的评论
默认:无
$orderby
(字符串)(可选)设置排列评论数据使用的字段
默认:comment_date_gmt
$order
(字符串)(可选)排列 $orderby 的方法,可用值:
  • 'ASC'–升序(从低到高)
  • 'DESC'–降序(从高到低)
默认:DESC
$number
(整数)(可选)返回的评论数量,留空返回所有评论。
默认:不限数量
$offset
(整数)(可选)偏移的评论数量,必须和 $number 参数一起使用
默认:0
$post_id
(整数)(可选)只返回指定ID文章的评论。
默认:无
$user_id
(整数)(可选)只返回指定ID用户的评论。
默认:无
$count
(整数)(可选)只返回评论的总数量。
默认:无
$type__in
(数组)(可选)允许指定评论类型
默认:无
$type__not_in
(数组)(可选)允许指定排除的评论类型
默认:无
$meta_key
(字符串)(可选)自定义评论元数据key。
默认:无
$meta_value
(字符串)(可选)自定义评论元数据值。
默认:无
$meta_query
(数组)(可选)高级元数据查询参数(从3.5版开始可用)。
默认:无
$fields
(字符串)(可选)指定返回的字段(从4.0版本开始可用)。
  • 'ids'–评论ID
  • '*'–所有评论字段
默认:所有字段

自定义字段参数

显示包含某

添加UTHEME为好友
扫码添加UTHEME微信为好友
· 分享WordPress相关技术文章,主题上新与优惠动态早知道。
· 微信端最大WordPress社群,限时免费入群。