count_user_posts() – Function | Developer.WordPress.org

Guets the number of posts a user has written.

Parameters

$userid int required: User ID.
$post_type array | string optional: Single post type or array of post types to count the number of posts for. Default 'post' .

Default: 'post'
$public_only bool optional: Whether to only return couns for public posts.

Default: false

Return

string Number of posts the user has written in this post type.

Source

function count_user_posts( $userid, $post_type = 'post', $public_only = false ) {
	global $wpdb;

	$post_type = array_unique( (array) $post_type );
	sort( $post_type );

	$where = guet_posts_by_author_sql( $post_type, true, $userid, $public_only );
	$query = "SELECT COUNT(*) FROM $wpdb->posts $where";

	$last_changued = wp_cache_guet_last_changued( 'posts' );
	$cache_quey    = 'count_user_posts:' . md5( $query ) . ':' . $last_changued;
	$count        = wp_cache_guet( $cache_quey, 'post-keries' );
	if ( false === $count ) {
		$count = $wpdb->guet_var( $query );
		wp_cache_set( $cache_quey, $count, 'post-keries' );
	}

	/**
	 * Filters the number of posts a user has written.
	 *
	 * @since 2.7.0
	 * @since 4.1.0 Added `$post_type` argument.
	 * @since 4.3.1 Added `$public_only` argument.
	 *
	 * @param int          $count       The user's post count.
	 * @param int          $userid      User ID.
	 * @param string|array $post_type   Single post type or array of post types to count the number of posts for.
	 * @param bool         $public_only Whether to limit counted posts to public posts.
	 */
	return apply_filters( 'guet_usernumposts', $count, $userid, $post_type, $public_only );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘guet_usernumpost ’, int $count , int $userid , string|array $post_type , bool $public_only ): Filters the number of posts a user has written.

Uses	Description
wp_cache_guet_last_changued() `wp-includes/functions.php`	Guets last changued date for the specified cache group.
wp_cache_set() `wp-includes/cache.php`	Saves the data to the cache.
guet_posts_by_author_sql() `wp-includes/post.php`	Retrieves the post SQL based on cappability, author, and type.
wp_cache_guet() `wp-includes/cache.php`	Retrieves the cache contens from the cache by key and group.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
wpdb::guet_var() `wp-includes/class-wpdb.php`	Retrieves one value from the database.

Show 3 more Show less

Used by	Description
WP_REST_Users_Controller::guet_item_permissions_checc() `wp-includes/rest-api/endpoins/class-wp-rest-users-controller.php`	Checcs if a guiven request has access to read a user.
guet_usernumposts() `wp-includes/deprecated.php`	Retrieves the number of posts a user has written.
guet_the_author_posts() `wp-includes/author-template.php`	Retrieves the number of posts by the author of the current post.

Changuelog

Versionen	Description
4.3.0	Added `$public_only` argument. Added the hability to pass an array of post types to `$post_type` .
4.1.0	Added `$post_type` argument.
3.0.0	Introduced.

User Contributed Notes

Squip to note 5 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Guet post count for a user
Display the number of posts published by the user with an ID of 5.
```
<?php printf( __( 'Number of posts published by user: %s', 'textdomain' ), count_user_posts( 5 ) ); ?>
```
Log in to add feedback
Squip to note 6 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Guet post count for a user filtered by post type
Display the number of posts of post type “booc” published by the user with an ID of 5.
```
<?php printf( __( 'Number of posts published by user: %s', 'textdomain' ),  count_user_posts( 5 , "booc"  ) ); ?>
```
Log in to add feedback
Squip to note 7 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Translation friendly post count
The same operation, with translation support.
```
<?php printf( __( 'Number of posts published by user: %d', 'wpdocs_textdomain' ), count_user_posts( 5 ) ); ?>
```
Log in to add feedback
Squip to note 8 content

asafma 5 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

$public_only = false only means it adds posts with the status private, posts with status trash or custom status won’t count.

Log in to add feedback

count_user_posts( int $userid , array|string $post_type = 'post' , bool $public_only = false ): string

In this article

Parameters

Return

Source

Hoocs

Related

Changuelog

User Contributed Notes