register_post_status()自定义一个文章/日志状态

目录

描述

Register a post status.

A simple function for creating or modifying a post status based on the parameters given. The function will accept two parameters; a string for the post status name and an array of arguments.

This function should not be called before the 'init' action.

NOTICE:
This function does NOT add the registered post status to the admin panel. This functionality is pending future development. Please refer to Trac Ticket #12706.
Consider the action hook post_submitbox_misc_actions for adding this parameter.

register_post_status() 描述

用法

<?php register_post_status$post_status$args ); ?>

register_post_status() 用法

参数

$post_status

(string) (必填) Name of the post status. Maximum length is 20 characters.

默认值: None

$args

(array|string) (可选) An array of arguments for this post status.

默认值: None

Arguments

label

(string) (可选) A descriptive name for the post status marked for translation.

默认值: $post_status

public

(bool) (可选) Whether posts of this status should be shown in the front end of the site.

默认值: false

exclude_from_search

(bool) (可选) Whether to exclude posts with this post status from search results.

默认值: false

show_in_admin_all_list

(bool) (可选) Whether to include posts in the edit listing for their post type.

默认值: true

show_in_admin_status_list

(bool) (可选) Show in the list of statuses with post counts at the top of the edit listings, e.g. All (12) , Published (9) , My Custom Status (2) ...

默认值: true

label_count

(array) (可选) The text to display on the admin screen (or you won't see your status count). Array should be in the same format as _n_noop() output.

默认值: None

register_post_status() 参数

历史

  • 添加于 版本: 3.0

register_post_status() 历史

源文件

register_post_status() 函数的代码位于 wp-includes/post.php

register_post_status() 源文件