get_post_statuses()
Retrieve all of the WordPress supported post statuses.
Contents
Description
Posts have a limited set of valid status values, this provides the post_status values and descriptions.
Return
(string[]) Array of post status labels keyed by their status.
More Information
Usage:
$post_statuses = get_post_statuses();
output:
Array
(
[draft] => Draft
[pending] => Pending Review
[private] => Private
[publish] => Published
)
Note:
To get an array of all post statuses, including those created with register_post_type(), see get_post_stati.
Source
File: wp-includes/post.php
function get_post_statuses() {
$status = array(
'draft' => __( 'Draft' ),
'pending' => __( 'Pending Review' ),
'private' => __( 'Private' ),
'publish' => __( 'Published' ),
);
return $status;
}
Expand full source code Collapse full source code View on Trac View on GitHub
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Note that
get_post_statusesreturns a hard-coded list of statuses as indicated by the code sample. This list is missing core statuses such as ‘future’.To actually see the list of all post statuses available in your WordPress instance, use
get_post_stati(https://developer.wordpress.org/reference/functions/get_post_stati/).Get all statuses including custom statuses.
add_action('init', function () { global $wp_post_statuses; var_dump( $wp_post_statuses ); // result... with 'custom_status' /* array( "publish", "future", "draft", "pending", "private", "trash", "auto-draft", "inherit", "custom_status" // <-- here we go ) */ }, PHP_INT_MAX); // <-- high priorityExpand full source codeCollapse full source code
Referenced from: https://wordpress.stackexchange.com/a/331154