get_private_posts_cap_sql( string|array $post_type ): string

Retrieves the private post SQL based on capability.


This function provides a standardized way to appropriately select on the post_status of a post type. The function will return a piece of SQL code that can be added to a WHERE clause; this SQL is constructed to allow all published posts, and all private posts to which the user has access.

Top ↑


$post_type string|array Required
Single post type or an array of post types. Currently only supports 'post' or 'page'.

Top ↑


string SQL code that can be added to a where clause.

Top ↑


File: wp-includes/post.php. View all references

function get_private_posts_cap_sql( $post_type ) {
	return get_posts_by_author_sql( $post_type, false );

Top ↑


Version Description
4.3.0 Added the ability to pass an array to $post_type.
2.2.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.