get_post_status_object

The timeline below displays how wordpress function get_post_status_object has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Retrieves a post status object by name.
 *
 * @since 3.0.0
 *
 * @global stdClass[] $wp_post_statuses List of post statuses.
 *
 * @see register_post_status()
 *
 * @param string $post_status The name of a registered post status.
 * @return stdClass|null A post status object.
 */
function get_post_status_object($post_status)
{
    global $wp_post_statuses;
    if (empty($wp_post_statuses[$post_status])) {
        return null;
    }
    return $wp_post_statuses[$post_status];
}

WordPress Version: 5.9

/**
 * Retrieve a post status object by name.
 *
 * @since 3.0.0
 *
 * @global stdClass[] $wp_post_statuses List of post statuses.
 *
 * @see register_post_status()
 *
 * @param string $post_status The name of a registered post status.
 * @return stdClass|null A post status object.
 */
function get_post_status_object($post_status)
{
    global $wp_post_statuses;
    if (empty($wp_post_statuses[$post_status])) {
        return null;
    }
    return $wp_post_statuses[$post_status];
}

WordPress Version: 4.3

/**
 * Retrieve a post status object by name.
 *
 * @since 3.0.0
 *
 * @global array $wp_post_statuses List of post statuses.
 *
 * @see register_post_status()
 *
 * @param string $post_status The name of a registered post status.
 * @return object|null A post status object.
 */
function get_post_status_object($post_status)
{
    global $wp_post_statuses;
    if (empty($wp_post_statuses[$post_status])) {
        return null;
    }
    return $wp_post_statuses[$post_status];
}

WordPress Version: 4.0

/**
 * Retrieve a post status object by name.
 *
 * @since 3.0.0
 *
 * @global array $wp_post_statuses List of post statuses.
 *
 * @see register_post_status()
 *
 * @param string $post_status The name of a registered post status.
 * @return object A post status object.
 */
function get_post_status_object($post_status)
{
    global $wp_post_statuses;
    if (empty($wp_post_statuses[$post_status])) {
        return null;
    }
    return $wp_post_statuses[$post_status];
}

WordPress Version: 3.9

/**
 * Retrieve a post status object by name
 *
 * @since 3.0.0
 * @uses $wp_post_statuses
 * @see register_post_status
 * @see get_post_statuses
 *
 * @param string $post_status The name of a registered post status
 * @return object A post status object
 */
function get_post_status_object($post_status)
{
    global $wp_post_statuses;
    if (empty($wp_post_statuses[$post_status])) {
        return null;
    }
    return $wp_post_statuses[$post_status];
}

WordPress Version: 3.7

/**
 * Retrieve a post status object by name
 *
 * @package WordPress
 * @subpackage Post
 * @since 3.0.0
 * @uses $wp_post_statuses
 * @see register_post_status
 * @see get_post_statuses
 *
 * @param string $post_status The name of a registered post status
 * @return object A post status object
 */
function get_post_status_object($post_status)
{
    global $wp_post_statuses;
    if (empty($wp_post_statuses[$post_status])) {
        return null;
    }
    return $wp_post_statuses[$post_status];
}