get_post_stati( array|string $args = array(), string $output = 'names', string $operator = 'and' )

Get a list of post statuses.

Description

See also

Parameters

$args

(array|string) (Optional) Array or string of post status arguments to compare against properties of the global $wp_post_statuses objects.

Default value: array()

$output

(string) (Optional) The type of output to return, either 'names' or 'objects'.

Default value: 'names'

$operator

(string) (Optional) The logical operation to perform. 'or' means only one element from the array needs to match; 'and' means all elements must match.

Default value: 'and'

Return

(array) A list of post status names or objects.

Source

File: wp-includes/post.php 

function get_post_stati( $args = array(), $output = 'names', $operator = 'and' ) {
	global $wp_post_statuses;

	$field = ( 'names' === $output ) ? 'name' : false;

	return wp_filter_object_list( $wp_post_statuses, $args, $operator, $field );
}

Uses

Uses Description
wp-includes/functions.php: wp_filter_object_list()

Filters a list of objects, based on a set of key => value arguments.

Used By

Used By Description
wp-admin/includes/meta-boxes.php: register_and_do_post_meta_boxes()

Registers the default post meta boxes, and runs the do_meta_boxes actions.
wp-admin/includes/class-wp-privacy-requests-table.php: WP_Privacy_Requests_Table::get_request_counts()

Count number of requests for each status.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::establish_loaded_changeset()

Establish the loaded changeset.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::import_theme_starter_content()

Import theme starter content into the customized state.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::find_changeset_post_id()

Find the changeset post ID for a given changeset UUID.
wp-includes/theme.php: wp_get_custom_css_post()

Fetches the custom_css post for a given theme.
wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php: WP_REST_Post_Statuses_Controller::get_items()

Retrieves all post statuses, depending on user context.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::get_item_schema()

Retrieves the post’s schema, conforming to JSON Schema.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::get_collection_params()

Retrieves the query params for the posts collection.
wp-admin/includes/post.php: wp_edit_posts_query()

Run the wp query to fetch the posts for listing on the edit posts page
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::get_views()
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::__construct()

Constructor.
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::prepare_items()
wp-includes/class-wp-query.php: WP_Query::get_posts()

Retrieves an array of posts based on query variables.
wp-includes/link-template.php: get_adjacent_post()

Retrieves the adjacent post.
wp-includes/post.php: get_pages()

Retrieve an array of pages (or hierarchical post type items).
wp-includes/post.php: wp_insert_post()

Insert or update a post.
wp-includes/post.php: wp_count_posts()

Count number of posts of a post type and if user has permissions to view.

Changelog

Version Description
3.0.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_post_stati