get_comments()是可以在主循环外获取最新评论列表的WordPress函数，通过get_comments()函数可以获取整站的最新评论，通过设置相关参数还可以实现获取指定文章、指定用户、指定ID或指定邮箱的评论，get_comments()函数可以返回评论ID、评论的文章ID、评论用户、评论邮箱、评论内容等信息。比如要在首页调用文章ID为1的评论，通过该函数就可以轻易实现。

函数代码

1

<?php get_comments( $args ); ?>

默认用法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

<?php 
	$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' => '', // ignored (use post_id instead)
		'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, // See WP_Date_Query
	);
	get_comments( $args ); 
?>

参数说明

• $author_email – （字符串）评论用户的邮件地址，默认为空。
• $author__in – （数组）包含指定用户ID的评论，默认为空。
• $author__not_in – （数组）排除指定用户ID的评论，默认为空。
• $comment__in – （数组）获取指定ID的评论，默认为空。
• $comment__not_in – （数组）排除指定ID的评论，默认为空。
• $count – （布尔型）返回评论的数量值，默认为false。
• $date_query – （数组）返回限制时间段的评论，或参考WP_Date_Query，默认为空。
• $fields – （字符串）返回评论的字段，仅限注释ID的“ids”或空，默认为空。
• $ID – （整型）暂未被使用？（官网注释Currently unused.），默认为空。
• $include_unapproved – （数组）包含未被审核的评论ID或邮箱地址，默认为空。
• $karma – （整型）用于检索匹配注释的KARMA得分，默认为空。
• $meta_key – （字符串）包含的评论自定义字段，默认为空。
• $meta_value – （字符串）包含的评论自定义字段值，必须和$meta_key一起使用，默认为空。
• $meta_query – （数组）自定义字段查询条件，参考WP_Meta_Query函数，默认为空。
• $number – （整型）返回的评论条数，不设置则不限量数量，默认为空。
• $offset – （整型）从第几条开始的评论，默认为空。
• $orderby – （字符串数组）返回的评论排序方式，如果根据“meta_value”或“meta_value_num”排列，那么必须设置$meta_key参数；如果使用meta_query查询，那么必须使用它的数组值。支持的排序方式：comment_agent、comment_approved、comment_author、comment_author_email、comment_author_IP、comment_author_url、comment_content、comment_date、comment_date_gmt、comment_ID、comment_karma、comment_parent、comment_post_ID、comment_type、user_id、meta_value、meta_value_num、the value of $meta_key、and the array keys of $meta_query、Also accepts false, an empty array, or ‘none’ to disable ORDER BY clause，默认为comment_date_gmt。
• $order – （字符串）排序顺序，可选ASC或DESC，默认DESC。
• $parent – （整型）指定ID的子评论，默认为空。
• $post_author__in – （数组）获取指定文章作者ID的评论，默认为空。
• $post_author__not_in – （数组）排除指定文章作者ID的评论，默认为空。
• $post_ID – （整型）（官网注释Currently unused），默认为空。
• $post_id – （整型）指定单篇文章ID，默认为空。
• $post__in – （数组）指定多篇文章ID的评论，默认为空。
• $post__not_in – （数组）排除指定文章ID的评论，默认为空。
• $post_author – （整型）指定文章作者ID的评论，默认为空。
• $post_status – （字符串）文章的状态，草稿、待审或者已发布，默认为空。
• $post_type – （字符串）文章类型，如post、page或自定义文章类型，默认为空。
• $post_name – （字符串）文章名称，默认为空。
• $post_parent – （整形）指定父ID的评论，默认为空。
• $search – （字符串）搜索匹配，默认为空。
• $status – （字符串）评论的状态，支持“hold”、“approve”、“all”或自定义的评论状态，默认为all。
• $type – （字符串数组）评论的类型，可选“comment”、“pings”（包含“pingback”和“trackback”），或自定义类型，默认为空。
• $type__in – （数组）评论的类型，多个类型使用，默认为空。
• $type__not_in – （数组）要排除的评论类型，默认为空。
• $user_id – （整型）指定会员ID的评论。

函数返回值

注：函数的返回值是数组，数组包含以下字段。

• comment_ID – 评论ID
• comment_post_ID – 评论父ID
• comment_author – 评论用户名
• comment_author_email – 评论用户邮箱
• comment_author_url – 评论用户网址
• 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 – 评论的karma
• comment_approved – 评论状态（0，1或“spam”）
• comment_agent – 评论用户的工具（浏览器、操作系统等信息）
• comment_type – 评论的类型（pingback或trackback），空的话表示常规评论
• comment_parent – 嵌套评论的父评论（0为顶层）
• user_id – 用户ID（如果评论的用户是网站注册用户则返回）

示例

一、调用文章ID为15的所有评论

1
2
3
4
5
6

<?php 
	$comments = get_comments('post_id=15');
	foreach($comments as $comment) :
		echo($comment->comment_author);
	endforeach;
?>

二、调用文章ID为1的5条未审核的评论

1
2
3
4
5
6
7
8
9
10
11

<?php
	$args = array(
		'status' => 'hold',
		'number' => '5',
		'post_id' => 1, // use post_id, not post_ID
	);
	$comments = get_comments($args);
	foreach($comments as $comment) :
		echo($comment->comment_author . '<br />' . $comment->comment_content);
	endforeach;
?>

三、显示文章ID为1的评论的数量

1
2
3
4
5
6
7
8

<?php
	$args = array(
		'post_id' => 1, // use post_id, not post_ID
		'count' => true //return only the count
	);
	$comments = get_comments($args);
	echo $comments
?>

四、调用注册ID为1的用户评论的数量

1
2
3
4
5
6
7
8

<?php
	$args = array(
		'user_id' => 1, // use user_id
			'count' => true //return only the count
	);
	$comments = get_comments($args);
	echo $comments
?>

五、调用注册ID为1的用户的评论

1
2
3
4
5
6
7
8
9
10

<?php
	$args = array(
		'user_id' => 1, // use user_id
 
	);
	$comments = get_comments($args);
	foreach($comments as $comment) :
		echo($comment->comment_author . '<br />' . $comment->comment_content);
	endforeach;
?>

六、调用最近四周的评论

1
2
3
4
5
6
7
8
9
10
11
12
13

<?php 
	$args = array(
		'date_query' => array(
			'after' => '4 week ago',
			'before' => 'tomorrow',
			'inclusive' => true,
		),    
	);
	$posts = get_comments($args);
	foreach ($posts as $post) {
		// Output comments etc here
	}
?>

七、删除同一篇文章同一个人的重复评论

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

<?php
	// get all approved comments with empty number arg
	$all_comments=get_comments( array('status' => 'approve', 'number'=>'') );
 
	// array to hold comment ids that are dupes
	$comment_ids_to_delete=array();
 
	foreach($all_comments as $k=>$c)
	{
		$kk=($k-1); // the previous comments index in all_comments array
		$pc=$all_comments[$kk]; // the previous comment object
 
		// if comment authors the same, and comment_content the same add to deletions array
		if($pc->comment_author == $c->comment_author && $pc->comment_content == $c->comment_content) {
			$comment_ids_to_delete[]=$pc->comment_ID; // previous comment id
		}
	}
 
	// delete the comment by id
	foreach($comment_ids_to_delete as $k=>$v):
		wp_delete_comment($v);
	endforeach;
?>

函数位置

wp-includes/comment.php

官方文档：https://codex.wordpress.org/Function_Reference/get_comments