get_comments( string|array $args = '' )

Retrieve a list of comments.

Description

The comment list can be for the blog as a whole or for an individual post.

$args

(string|array) (Optional) Array or string of arguments. See WP_Comment_Query::__construct() for information on accepted arguments.

Default value: ''

(int|array) List of comments or number of found comments if $count argument is true.

function get_comments( $args = '' ) {
	$query = new WP_Comment_Query;
	return $query->query( $args );
}

Uses
Uses	Description
wp-includes/class-wp-comment-query.php: WP_Comment_Query::__construct()	Constructor.

Used By
Used By	Description
wp-includes/widgets/class-wp-widget-recent-comments.php: WP_Widget_Recent_Comments::widget()	Outputs the content for the current Recent Comments widget instance.
wp-includes/class-wp-comment.php: WP_Comment::get_children()	Get the children of a comment.
wp-includes/comment.php: wp_comments_personal_data_exporter()	Finds and exports personal data associated with an email address from the comments table.
wp-includes/comment.php: wp_comments_personal_data_eraser()	Erases personal data associated with an email address from the comments table.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getComments()	Retrieve comments.
wp-includes/class-wp-comment-query.php: WP_Comment_Query::fill_descendants()	Fetch descendants for located comments.
wp-includes/comment-template.php: wp_list_comments()	List comments.
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::prepare_items()
wp-admin/includes/meta-boxes.php: post_comment_meta_box()	Display comments for post.
wp-admin/includes/dashboard.php: wp_dashboard_recent_comments()	Show Comments section.

Changelog
Version	Description
WP-2.7.0	Introduced.