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.

Parameters

$args

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

Default value: ''

Return

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

Source

File: wp-includes/comment.php 

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

Used By

Used By Description
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::comment_type_dropdown()

Displays a comment type drop-down for filtering on the Comments list table.
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-comment.php: WP_Comment::get_children()

Get the children of a comment.
wp-includes/class-wp-comment-query.php: WP_Comment_Query::fill_descendants()

Fetch descendants for located comments.
wp-admin/includes/dashboard.php: wp_dashboard_recent_comments()

Show Comments section.
wp-admin/includes/meta-boxes.php: post_comment_meta_box()

Display comments for post.
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::get_views()
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::prepare_items()
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-xmlrpc-server.php: wp_xmlrpc_server::wp_getComments()

Retrieve comments.
wp-includes/comment-template.php: wp_list_comments()

Displays a list of comments.

Changelog

Version Description
2.7.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_comments