WP_Comment_Query 是用來查詢 WordPress 評論數(shù)據(jù)的 PHP 類，源文件位于 wp-includes/comment.php 文件，我們可以使用該類查詢 WordPress 數(shù)據(jù)庫中 wp_comments 和 wp_commentmeta 數(shù)據(jù)表中的數(shù)據(jù)，該類從 WordPress 3.1 開始引入，只要 WordPress 的版本號大于等于 3.1，都可以直接使用 WP Comment Query 類查詢數(shù)據(jù)。

WP Comment Query 使用簡介

$args = array(
   // 類參數(shù)
);

// 新建查詢
$comments_query = new WP_Comment_Query;
$comments = $comments_query->query( $args );

// 循環(huán)輸入評論數(shù)據(jù)
if ( $comments ) {
	foreach ( $comments as $comment ) {
		echo '<p>' . $comment->comment_content . '</p>';
	}
} else {
	echo 'No comments found.';
}

默認使用方法

$args = array(
   'author_email' => '',
   'author__in' => '',
   'author__not_in' => '',
   'include_unapproved' => '',
   'fields' => '',
   'ID' => '',
   'comment__in' => '',
   'comment__not_in' => '',
   'karma' => '',
   'number' => '',
   'offset' => '',
   'orderby' => '',
   'order' => 'DESC',
   'parent' => '',
   'post_author__in' => '',
   'post_author__not_in' => '',
   'post_id' => 0,
   'post__in' => '',
   'post__not_in' => '',
   'post_author' => '',
   'post_name' => '',
   'post_parent' => '',
   'post_status' => '',
   'post_type' => '',
   'status' => 'all',
   'type' => '',
   'type__in' => '',
   'type__not_in' => '',
   'user_id' => '',
   'search' => '',
   'count' => false,
   'meta_key' => '',
   'meta_value' => '',
   'meta_query' => '',
   'date_query' => null, // 查看 WP_Date_Query
);

參數(shù)說明

自定義字段參數(shù)

顯示包含某個自定義字段的評論

• meta_key (字符串) – 自定義字段key
• meta_value ( 字符串) – 自定義字段值
• meta_query (數(shù)組) – 自定義字段參數(shù) (從 3.5 版開始可用)
  • key (字符串) -自定義字段key
  • value (字符|數(shù)組) – 自定義字段值 (注意: 數(shù)組支持只限在以下對比方法中使用： ‘IN’, ‘NOT IN’, ‘BETWEEN’, ‘NOT BETWEEN’, ‘EXISTS’ 或 ‘NOT EXISTS’)
  • compare (字符) – 數(shù)據(jù)對比方法 ‘=’, ‘!=’, ‘>’, ‘>=’, ‘<‘, ‘<=’, ‘LIKE’, ‘NOT LIKE’, ‘IN’, ‘NOT IN’, ‘BETWEEN’, ‘NOT BETWEEN’, ‘EXISTS’, 和 ‘NOT EXISTS’。 默認為 ‘=’。
  • type (字符) – 自定義字段類型，可用的值有 ‘NUMERIC’, ‘BINARY’, ‘CHAR’, ‘DATE’, ‘DATETIME’, ‘DECIMAL’, ‘SIGNED’, ‘TIME’, ‘UNSIGNED’。 默認值為 ‘CHAR’。

顯示特色評論

$comment_query = new WP_Comment_Query( array( 'meta_key' => 'featured', 'meta_value' => '1' ) );

多個元數(shù)據(jù)查詢處理方法

$args = array(
	'meta_query' => array(
		'relation' => 'AND',
		array(
			'key' => 'featured',
			'value' => '1'
		),
		array(
			'key' => 'buried',
			'value' => '1',
			'type' => 'numeric',
			'compare' => '!='
		)
	)
 );
$comment_query = new WP_Comment_Query( $args );

返回值

返回的數(shù)據(jù)為一個數(shù)組，包含以下索引鍵的評論字段（如果沒有評論，返回空數(shù)組）：

• comment_ID（整數(shù)）：評論 ID
• comment_post_ID（整數(shù)）：評論所屬的文章/頁面 ID
• comment_author（字符串）：評論者的名稱
• comment_author_email（字符串）：評論者的電子郵件地址
• comment_author_url（字符串）：評論者提供的網(wǎng)址鏈接
• comment_author_IP（字符串）：評論者的 IP 地址
• comment_date（字符串）：評論本地時間，格式 YYYY-MM-DD HH:MM:SS
• comment_date_gmt（字符串）：評論的 GMT 時間，格式 YYYY-MM-DD HH:MM:SS
• comment_content（字符串）：評論的實際內容
• comment_karma（整數(shù)）：評論評分（一般為 0，已廢棄字段）
• comment_approved（字符串）：評論審核狀態(tài)（可為 0、1 或 "spam"）
• comment_agent（字符串）：評論者的客戶端信息（如瀏覽器、操作系統(tǒng)等）
• comment_type（字符串）：評論類型（例如：pingback、trackback，普通評論為空）
• comment_parent（字符串）：父評論的 ID，頂級評論為 0
• user_id（整數(shù)）：如果評論者是已注冊用戶，則為其用戶 ID