WordPress как на ладони
rgbcode is looking for WordPress developers. Очень Удобный и Быстрый Хостинг для сайтов на WordPress. Пользуюсь сам и вам рекомендую!

wp_count_posts()WP 2.5.0

Получает количество записей любого типа записей и любых статусов (опубликовано, черновик).

Обеспечивает эффективный способ получения количества записей указанного типа (результат кэшируется). Тоже самое можно сделать с помощью запроса get_posts(), но этот подход гораздо менее эффективен. Поэтому при разработке для 2.5+ используйте эту функцию.

Параметр $perm позволяет добавить в подсчет личные записи (private), если пользователь авторизован и может читать приватные посты. Для этого параметр $perm должен равняться readable.

Аналогичная функция, только для комментариев: wp_count_comments()

1 раз — 0.00051 сек (медленно) | 50000 раз — 0.11 сек (очень быстро) | PHP 7.3.12, WP 5.4
Хуки из функции

Возвращает

stdClass. Объект статусов постов. Каждый статут содержит количество записей в нем. Т.е. объект содержит количество опубликованных постов, черновиков и т.д.

stdClass Object
(
	[publish]    => 60
	[future]     => 0
	[draft]      => 9
	[pending]    => 3
	[private]    => 0
	[trash]      => 0
	[auto-draft] => 3
	[inherit]    => 0
)

Использование

$count = wp_count_posts( $type, $perm );
$type(строка)
Название типа записи, количество записей которого нужно посчитать.
По умолчанию: 'post'
$perm(строка)
Чтобы текущему авторизованному пользователю показывались его личные (private) записи ставим этот параметр в readable.
По умолчанию: ''

Примеры

0

#1 Базовое использование

Вернет объект данных о числе записей каждого статуса. Можно использовать функцию var_dump(), чтобы посмотреть что содержится в объекте.

$count_posts = wp_count_posts();

// в итоге получим что-то такое:
/*
stdClass Object
(
	[publish] => 60
	[future] => 0
	[draft] => 9
	[pending] => 3
	[private] => 0
	[trash] => 0
	[auto-draft] => 3
	[inherit] => 0
)
*/
0

#2 Количество опубликованных постов

Чтобы получить количество опубликованных постов используем такой код:

$count_posts = wp_count_posts();
$published_posts = $count_posts->publish;

Если не нужна поддержка PHP4, то можно использовать такую короткую запись верхнего кода:

$published_posts = wp_count_posts()->publish;
0

#3 Считаем черновики

Чтобы посчитать сколько у нас в базе данных черновиков используем такой код (для PHP5):

$draft_posts = wp_count_posts()->draft;
0

#4 Считаем другие типы записей

Чтобы посчитать сколько у нас опубликовано записей произвольного типа, допустим new_post_type, используем такой код:

$published_posts = wp_count_posts('new_post_type')->publish;

Заметки

  • Global. wpdb. $wpdb WordPress database abstraction object.

Список изменений

С версии 2.5.0 Введена.

Код wp_count_posts() WP 6.4.3

function wp_count_posts( $type = 'post', $perm = '' ) {
	global $wpdb;

	if ( ! post_type_exists( $type ) ) {
		return new stdClass();
	}

	$cache_key = _count_posts_cache_key( $type, $perm );

	$counts = wp_cache_get( $cache_key, 'counts' );
	if ( false !== $counts ) {
		// We may have cached this before every status was registered.
		foreach ( get_post_stati() as $status ) {
			if ( ! isset( $counts->{$status} ) ) {
				$counts->{$status} = 0;
			}
		}

		/** This filter is documented in wp-includes/post.php */
		return apply_filters( 'wp_count_posts', $counts, $type, $perm );
	}

	$query = "SELECT post_status, COUNT( * ) AS num_posts FROM {$wpdb->posts} WHERE post_type = %s";

	if ( 'readable' === $perm && is_user_logged_in() ) {
		$post_type_object = get_post_type_object( $type );
		if ( ! current_user_can( $post_type_object->cap->read_private_posts ) ) {
			$query .= $wpdb->prepare(
				" AND (post_status != 'private' OR ( post_author = %d AND post_status = 'private' ))",
				get_current_user_id()
			);
		}
	}

	$query .= ' GROUP BY post_status';

	$results = (array) $wpdb->get_results( $wpdb->prepare( $query, $type ), ARRAY_A );
	$counts  = array_fill_keys( get_post_stati(), 0 );

	foreach ( $results as $row ) {
		$counts[ $row['post_status'] ] = $row['num_posts'];
	}

	$counts = (object) $counts;
	wp_cache_set( $cache_key, $counts, 'counts' );

	/**
	 * Filters the post counts by status for the current post type.
	 *
	 * @since 3.7.0
	 *
	 * @param stdClass $counts An object containing the current post_type's post
	 *                         counts by status.
	 * @param string   $type   Post type.
	 * @param string   $perm   The permission to determine if the posts are 'readable'
	 *                         by the current user.
	 */
	return apply_filters( 'wp_count_posts', $counts, $type, $perm );
}
4 комментария
    Войти