# get_pending_comments_num()

URL: https://chugunov.pro/api-wordpress/functions/get_pending_comments_num/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.3.0.

## Сигнатура

```php
get_pending_comments_num( int|int[] $post_id ): int|int[]
```

## Описание

Получает количество ожидающих проверки комментариев для записи или записей.

## Параметры

- `$post_id` `int|int[]` — обязательный. Одиночный идентификатор записи или массив идентификаторов записей.

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

`int|int[]`

## Исходный код

Файл: `wp-admin/includes/comment.php:148`

```php
function get_pending_comments_num( $post_id ) {
	global $wpdb;

	$single = false;
	if ( ! is_array( $post_id ) ) {
		$post_id_array = (array) $post_id;
		$single        = true;
	} else {
		$post_id_array = $post_id;
	}
	$post_id_array = array_map( 'intval', $post_id_array );
	$post_id_in    = "'" . implode( "', '", $post_id_array ) . "'";

	$pending = $wpdb->get_results( "SELECT comment_post_ID, COUNT(comment_ID) as num_comments FROM $wpdb->comments WHERE comment_post_ID IN ( $post_id_in ) AND comment_approved = '0' AND comment_type != 'note' GROUP BY comment_post_ID", ARRAY_A );

	if ( $single ) {
		if ( empty( $pending ) ) {
			return 0;
		} else {
			return absint( $pending[0]['num_comments'] );
		}
	}

	$pending_keyed = array();

	// Default to zero pending for all posts in request.
	foreach ( $post_id_array as $id ) {
		$pending_keyed[ $id ] = 0;
	}

	if ( ! empty( $pending ) ) {
		foreach ( $pending as $pend ) {
			$pending_keyed[ $pend['comment_post_ID'] ] = absint( $pend['num_comments'] );
		}
	}

	return $pending_keyed;
}
```

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

- 6.9.0 — Exclude the 'note' comment type from the count.
- 2.3.0 — Introduced.

## Связанные

Использует: [`absint`](https://chugunov.pro/api-wordpress/functions/absint/), `wpdb::get_results`.
Используется в: `WP_Media_List_Table::column_comments`, `WP_Media_List_Table::display_rows`, `WP_Comments_List_Table::column_response`, `WP_Comments_List_Table::prepare_items`, `WP_Posts_List_Table::_display_rows`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_pending_comments_num/