# count_many_users_posts()

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

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

## Сигнатура

```php
count_many_users_posts( int[] $users, string|string[] $post_type = 'post', bool $public_only = false ): array<int,
```

## Описание

Возвращает количество записей, написанных списком пользователей.

## Параметры

- `$users` `int[]` — обязательный. Массив ID пользователей.
- `$post_type` `string|string[]` — необязательный, по умолчанию `'post'`. Один тип записи или массив типов записей для проверки. Значение по умолчанию 'post'.
- `$public_only` `bool` — необязательный, по умолчанию `false`. Возвращать количество только для публичных записей. Значение по умолчанию false.

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

`array<int,`

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

Файл: `wp-includes/user.php:661`

```php
function count_many_users_posts( $users, $post_type = 'post', $public_only = false ) {
	global $wpdb;

	if ( empty( $users ) || ! is_array( $users ) ) {
		return array();
	}

	/**
	 * Filters whether to short-circuit performing the post counts.
	 *
	 * When filtering, return an array of posts counts as strings, keyed
	 * by the user ID.
	 *
	 * @since 6.8.0
	 *
	 * @param string[]|null   $count       The post counts. Return a non-null value to short-circuit.
	 * @param int[]           $users       Array of user IDs.
	 * @param string|string[] $post_type   Single post type or array of post types to check.
	 * @param bool            $public_only Whether to only return counts for public posts.
	 */
	$pre = apply_filters( 'pre_count_many_users_posts', null, $users, $post_type, $public_only );
	if ( null !== $pre ) {
		return $pre;
	}

	// Cleanup the users array. Remove duplicates and sort for consistent ordering.
	$users = array_unique( array_filter( array_map( 'intval', $users ) ) );
	sort( $users );

	// Cleanup the post type argument. Remove duplicates and sort for consistent ordering.
	$post_type = array_unique( (array) $post_type );
	sort( $post_type );

	$userlist    = implode( ',', $users );
	$where       = get_posts_by_author_sql( $post_type, true, null, $public_only );
	$query       = "SELECT post_author, COUNT(*) FROM $wpdb->posts $where AND post_author IN ($userlist) GROUP BY post_author";
	$cache_key   = 'count_many_users_posts:' . md5( $query );
	$cache_salts = array( wp_cache_get_last_changed( 'posts' ), wp_cache_get_last_changed( 'users' ) );
	$count       = wp_cache_get_salted( $cache_key, 'post-queries', $cache_salts );

	if ( false === $count ) {
		$result = $wpdb->get_results( $query, ARRAY_N );

		$count = array_fill_keys( $users, 0 );
		foreach ( $result as $row ) {
			$count[ $row[0] ] = $row[1];
		}

		wp_cache_set_salted( $cache_key, $count, 'post-queries', $cache_salts, HOUR_IN_SECONDS );
	}

	return $count;
}
```

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

- 6.9.0 — The results are now cached.
- 3.0.0 — Introduced.

## Связанные

Использует: [`wp_cache_get_salted`](https://chugunov.pro/api-wordpress/functions/wp_cache_get_salted/), [`wp_cache_set_salted`](https://chugunov.pro/api-wordpress/functions/wp_cache_set_salted/), [`wp_cache_get_last_changed`](https://chugunov.pro/api-wordpress/functions/wp_cache_get_last_changed/), [`get_posts_by_author_sql`](https://chugunov.pro/api-wordpress/functions/get_posts_by_author_sql/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), `wpdb::get_results`.
Используется в: `WP_Users_List_Table::display_rows`.

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