wp_count_posts( string $type = 'post', string $perm = '' ): stdClass

Description

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Parameters

$typestringoptional

Post type to retrieve count. Default 'post'.Default: 'post'

$permstringoptional

'readable' or empty. Default empty.Default: ''

Return value

stdClass

An object containing the number of posts for each status, or an empty object if the post type does not exist.

Performance profile

How much work a call to wp_count_posts() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Heavy

Reaches the database via ->get_results().

Scaling

Scales with input

The body loops, so the work grows with what you pass in.

Instructions

10–84

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 114.

Plugin surface

1 hook

Third-party callbacks on 'wp_count_posts' run inside this call, and their cost is not bounded by anything here.

Called by

4

4 places in core call this, so the cost is paid more often than your own code shows.

What it touches

• cacheobject cachewp_cache_get()called directly
• hookthird-party callbacksapply_filters()called directly
• sqldatabase query->get_results()called directly

Further down the call graph this can also reach query. That is the worst case, several calls deep and usually down an error path, not what a normal call pays.

What one call costs · 6 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost wp_count_posts() can have, taken from its control-flow graph on PHP 8.5.

Hooks and filters fired · 2

2 hooks fire while wp_count_posts() runs, in this order:

1. 1
   apply_filters( wp_count_posts )filterline 3483 (+19 into the body)

   Filters the post counts by status for the current post type.

2. 2
   apply_filters( wp_count_posts )filterline 3540 (+76 into the body)

   Filters the post counts by status for the current post type.

Uses · 11

• post_type_exists()Determines whether a post type is registered.
• _count_posts_cache_key()Returns the cache key for wp_count_posts() based on the passed arguments.
• wp_cache_get()Retrieves the cache contents from the cache by key and group.
• get_post_stati()Gets a list of post statuses.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• is_user_logged_in()Determines whether the current visitor is a logged in user.
• current_user_can()Returns whether the current user has the specified capability.
• get_post_type_object()Retrieves a post type object by name.
• get_current_user_id()Gets the current user's ID.
• wp_cache_set()Saves the data to the cache.
• stdClass::__construct()

Used by · 4

• WP_Posts_List_Table::get_views()
• WP_Posts_List_Table::prepare_items()
• get_available_post_statuses()Returns all the possible statuses for a post type.
• wp_dashboard_right_now()Dashboard widget that displays some basic stats about the site.

Source code

View on Trac ↗View on GitHub ↗

3464function wp_count_posts( $type = 'post', $perm = '' ) {3465	global $wpdb;3466 3467	if ( ! post_type_exists( $type ) ) {3468		return new stdClass();3469	}3470 3471	$cache_key = _count_posts_cache_key( $type, $perm );3472 3473	$counts = wp_cache_get( $cache_key, 'counts' );3474	if ( false !== $counts ) {3475		// We may have cached this before every status was registered.3476		foreach ( get_post_stati() as $status ) {3477			if ( ! isset( $counts->{$status} ) ) {3478				$counts->{$status} = 0;3479			}3480		}3481 3482		/** This filter is documented in wp-includes/post.php */3483		return apply_filters( 'wp_count_posts', $counts, $type, $perm );3484	}3485 3486	if (3487		'readable' === $perm &&3488		is_user_logged_in() &&3489		! current_user_can( get_post_type_object( $type )->cap->read_private_posts )3490	) {3491		// Optimized query uses subqueries which can leverage DB indexes for better performance. See #61097.3492		$query = "3493			SELECT post_status, COUNT(*) AS num_posts3494			FROM (3495				SELECT post_status3496				FROM {$wpdb->posts}3497				WHERE post_type = %s AND post_status != 'private'3498				UNION ALL3499				SELECT post_status3500				FROM {$wpdb->posts}3501				WHERE post_type = %s AND post_status = 'private' AND post_author = %d3502			) AS filtered_posts3503		";3504		$args  = array( $type, $type, get_current_user_id() );3505	} else {3506		$query = "3507			SELECT post_status, COUNT(*) AS num_posts3508			FROM {$wpdb->posts}3509			WHERE post_type = %s3510		";3511		$args  = array( $type );3512	}3513 3514	$query .= ' GROUP BY post_status';3515 3516	$results = (array) $wpdb->get_results(3517		$wpdb->prepare( $query, ...$args ), // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- Placeholders are used in the string contained in the variable.3518		ARRAY_A3519	);3520	$counts  = array_fill_keys( get_post_stati(), 0 );3521 3522	foreach ( $results as $row ) {3523		$counts[ $row['post_status'] ] = $row['num_posts'];3524	}3525 3526	$counts = (object) $counts;3527	wp_cache_set( $cache_key, $counts, 'counts' );3528 3529	/**3530	 * Filters the post counts by status for the current post type.3531	 *3532	 * @since 3.7.03533	 *3534	 * @param stdClass $counts An object containing the current post_type's post3535	 *                         counts by status.3536	 * @param string   $type   Post type.3537	 * @param string   $perm   The permission to determine if the posts are 'readable'3538	 *                         by the current user.3539	 */3540	return apply_filters( 'wp_count_posts', $counts, $type, $perm );3541}

Changelog

Introduced in 2.5.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/post.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.