get_post_status_object()

💡 云策文档标注

概述

get_post_status_object() 函数用于通过名称检索已注册的文章状态对象。它检查全局变量 $wp_post_statuses 中是否存在指定状态，并返回对应的对象或 null。

关键要点

函数接受一个字符串参数 $post_status，表示注册的文章状态名称。
返回值为 stdClass 对象或 null，如果状态未注册或参数无效则返回 null。
内部实现基于全局数组 $wp_post_statuses，可直接访问但推荐使用此函数以确保安全。
与 register_post_status() 相关，用于管理自定义文章状态。

代码示例

$obj = get_post_status_object( 'publish' );
echo esc_html( $obj->label );

global $wp_post_statuses;
$obj = $wp_post_statuses['publish'];
echo esc_html( $obj->label );

注意事项

函数自 WordPress 3.0.0 版本引入，兼容性良好。
在 REST API、权限检查、查询处理等多个核心功能中被广泛使用。
输出对象包含 label、public、name 等属性，可用于动态显示状态信息。

📄 原文内容

Retrieves a post status object by name.

Description

Parameters

$post_statusstringrequired: The name of a registered post status.

Return

stdClass|null A post status object.

Source

function get_post_status_object( $post_status ) {
	global $wp_post_statuses;

	if ( ! is_string( $post_status ) || empty( $wp_post_statuses[ $post_status ] ) ) {
		return null;
	}

	return $wp_post_statuses[ $post_status ];
}

View all references View on Trac View on GitHub

Used by	Description
wp_force_plain_post_permalink()`wp-includes/link-template.php`	Determine whether post should always use a plain permalink structure.
is_post_status_viewable()`wp-includes/post.php`	Determines whether a post status is considered “viewable”.
WP_Privacy_Requests_Table::column_status()`wp-admin/includes/class-wp-privacy-requests-table.php`	Status column.
WP_Privacy_Requests_Table::get_views()`wp-admin/includes/class-wp-privacy-requests-table.php`	Gets an associative array ( id => link ) with the list of views available on this table.
WP_REST_Post_Statuses_Controller::get_items()`wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php`	Retrieves all post statuses, depending on user context.
WP_REST_Post_Statuses_Controller::get_item_permissions_check()`wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php`	Checks if a given request has access to read a post status.
WP_REST_Post_Statuses_Controller::get_item()`wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php`	Retrieves a specific post status.
WP_REST_Posts_Controller::check_read_permission()`wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`	Checks if a post can be read.
WP_REST_Posts_Controller::handle_status_param()`wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`	Determines validity and normalizes the given status parameter.
wp_handle_comment_submission()`wp-includes/comment.php`	Handles the submission of a comment, usually posted to wp-comments-post.php via a comment form.
_wp_translate_postdata()`wp-admin/includes/post.php`	Renames `$_POST` data from form names to DB post columns.
map_meta_cap()`wp-includes/capabilities.php`	Maps a capability to the primitive capabilities required of the given user to satisfy the capability being checked.
WP_Customize_Manager::save()`wp-includes/class-wp-customize-manager.php`	Handles customize_save WP Ajax request to save/update a changeset.
WP::parse_request()`wp-includes/class-wp.php`	Parses the request to find the correct WordPress query.
WP_Query::get_posts()`wp-includes/class-wp-query.php`	Retrieves an array of posts based on query variables.
url_to_postid()`wp-includes/rewrite.php`	Examines a URL and try to determine the post ID it represents.
redirect_canonical()`wp-includes/canonical.php`	Redirects incoming links to the proper URL based on the site url.
wp_xmlrpc_server::_insert_post()`wp-includes/class-wp-xmlrpc-server.php`	Helper method for wp_newPost() and wp_editPost(), containing shared logic.

Show 13 more Show less

Changelog

Version	Description
3.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

Pixelbart

4 years ago

Examples

$obj = get_post_status_object( 'publish' );
echo esc_html( $obj->label );

Alternatively, it also works like this:

global $wp_post_statuses;
$obj = $wp_post_statuses['publish'];
echo esc_html( $obj->label );

print_r( $obj ) looks like this:

stdClass Object
(
    [label] => Published
    [label_count] => Array
        (
            [0] => Published (%s)
            [1] => Published (%s)
            [singular] => Published (%s)
            [plural] => Published (%s)
            [context] => 
            [domain] => 
        )

    [exclude_from_search] => 
    [_builtin] => 1
    [public] => 1
    [internal] => 
    [protected] => 
    [private] => 
    [publicly_queryable] => 1
    [show_in_admin_status_list] => 1
    [show_in_admin_all_list] => 1
    [date_floating] => 
    [name] => publish
)

云策 WordPress 开发者社区

函数文档