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

Get a list of post statuses.

Description Description

See also See also

Top ↑

Parameters Parameters


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

Default value: array()


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

Default value: 'names'


(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'

Top ↑

Return Return

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

Top ↑

Source 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 );

Top ↑

Changelog Changelog

Version Description
3.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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