get_approved_comments() — описание функции WordPress на русском

Сигнатура

get_approved_comments( int $post_id, array $args = array() ): WP_Comment[]|int[]|int

Описание

Получает одобренные комментарии для записи.

Параметры

$post_id int обязательный

ID записи.

$args array необязательный = array()

See WP_Comment_Query::__construct() for information on accepted arguments.

status intComment status to limit results by. Defaults to approved comments.
post_id intLimit results to those affiliated with a given post ID.
order stringHow to order retrieved comments. Default 'ASC'.

Возвращаемое значение

WP_Comment[]|int[]|int

$count

Исходный код

wp-includes/comment.php:188

function get_approved_comments( $post_id, $args = array() ) {
	if ( ! $post_id ) {
		return array();
	}

	$defaults    = array(
		'status'  => 1,
		'post_id' => $post_id,
		'order'   => 'ASC',
	);
	$parsed_args = wp_parse_args( $args, $defaults );

	$query = new WP_Comment_Query();
	return $query->query( $parsed_args );
}

История изменений

Версия	Описание
4.1.0	Refactored to leverage WP_Comment_Query over a direct query.
2.0.0	Introduced.