注册帖子类型。

原型

register_post_type( string $post_type, array|string $args = array() )

描述

注意:在“init”操作之前,不应挂接帖子类型注册。此外,任何分类连接都应通过$ taxonomies参数进行注册,以确保在使用诸如’parse_query’或’pre_get_posts’之类的钩子时保持一致性。

参数

$post_type (string) (Required) 邮政类型密钥。不得超过20个字符,并且只能包含小写字母数字字符,短划线和下划线。请参阅sanitize_key()。

$args (array|string) (Optional) 用于注册帖子类型的数组或参数字符串。 ‘label’(字符串)菜单中显示的帖子类型的名称。通常是复数。默认值为$ labels [‘name’]。 ‘labels’(array)此帖子类型的标签数组。如果未设置,则为非分层类型继承后期标签,为分层类型继承页面标签。有关支持的标签的完整列表,请参阅get_post_type_labels()。 ‘description’(字符串)帖子类型的简短描述性摘要。 ‘public’(bool)是否可以通过管理界面或前端用户公开使用帖子类型。虽然$ exclude_from_search,$ public_queryable,$ show_ui和$ show_in_nav_menus的默认设置是从公共继承的,但每个设置都不依赖于此关系并控制非常具体的意图。默认为false。 ‘hierarchical’(bool)帖子类型是否是分层的(例如页面)。默认为false。 ‘exclude_from_search’(bool)是否从前端搜索结果中排除具有此帖子类型的帖子。默认值是$ public的相反值。 ‘public_queryable’(bool)作为parse_request()的一部分,是否可以在post类型的前端执行查询。端点包括:*?post_type = {post_type_key} *?{post_type_key} = {single_post_slug} ?{post_type_query_var} = {single_post_slug}如果未设置,则默认值从$ public继承。 ‘show_ui’(bool)是否在admin中生成并允许用于管理此帖子类型的UI。默认值为$ public。 ‘show_in_menu’(bool)在管理菜单中显示帖子类型的位置。要工作,$ show_ui必须为true。如果为true,则帖子类型显示在其自己的顶级菜单中。如果为false,则不显示菜单。如果是现有顶级菜单的字符串(例如’tools.php’或’edit.php?post_type = page’),帖子类型将被放置为该子菜单。默认值为$ show_ui。 ‘show_in_nav_menus’(bool)使此帖子类型可供导航菜单中的选择。默认值为$ public。 ‘show_in_admin_bar’(bool)通过管理栏提供此帖子类型。默认值为$ show_in_menu。 ‘show_in_rest’(bool)是否在REST API’wp / v2’命名空间中添加post类型路由。 ‘rest_base’(字符串)更改REST API路由的基本URL。默认为$ post_type。 ‘rest_controller_class’(字符串)REST API控制器类名。默认为’WP_REST_Posts_Controller’。 ‘menu_position’(int)菜单顺序中应显示帖子类型的位置。要工作,$ show_in_menu必须为true。默认为null(在底部)。 ‘menu_icon’(字符串)用于此菜单的图标的URL。使用数据URI传递base64编码的SVG,数据URI将被着色以匹配颜色方案 – 这应该以’data:image / svg xml; base64’‘开头。传递Dashicons助手类的名称以使用字体图标,例如’dashicons-图表馅饼’。通过’none’将div.wp-menu-image留空,以便可以通过CSS添加图标。默认使用帖子图标。 ‘capability_type’(字符串)用于构建读取,编辑和删除功能的字符串。当使用该参数作为构造能力的基础时,可以作为数组传递以允许替代复数。数组(‘故事’,‘故事’)。默认’发布’。 ‘capabilities’(array)此帖子类型的功能数组。默认情况下,$ capability_type用作构建功能的基础。请参阅get_post_type_capabilities()。 ‘map_meta_cap’(bool)是否使用内部默认元功能处理。默认为false。 ‘supports’(数组)帖子类型支持的核心功能。用作直接调用add_post_type_support()的别名。核心功能包括“标题”,“编辑”,“评论”,“修订”,“引用”,“作者”,“摘录”,“页面属性”,“缩略图”,“自定义字段”和“帖子” – 格式。此外,“修订”功能决定了帖子类型是否会存储修订版,而“评论”功能则指示评论计数是否会显示在编辑屏幕上。 Defaults是一个包含’title’和’editor’的数组。 ‘register_meta_box_cb’(可调用)提供一个回调函数,用于设置编辑表单的元框。在回调中执行remove_meta_box()和add_meta_box()调用。默认为null。 ‘taxonomies’(array)将为post类型注册的分类标识符数组。稍后可以使用register_taxonomy()或register_taxonomy_for_object_type()注册分类。 ‘has_archive’(bool | string)是否应该有post类型的归档,或者如果是字符串,要使用的归档slug。如果启用了$ rewrite,将生成正确的重写规则。默认为false。 ‘rewrite’(bool | array)触发此post类型的重写处理。要防止重写,请设置为false。默认为true,使用$ post_type作为slug。要指定重写规则,可以使用以下任意键传递数组: ‘slug’(字符串)自定义permastruct slug。默认为$ post_type键。 ‘with_front’(bool)permastruct是否应该加上WP_Rewrite :: $ front。默认为true。 ‘feeds’(bool)是否应为此帖子类型构建feed permastruct。默认值为$ has_archive。 ‘pages’(bool)permastruct是否应该提供分页。默认为true。 ‘ep_mask’(const)要分配的端点掩码。如果未指定且设置了permalink_epmask,则继承自$ permalink_epmask。如果未指定且未设置permalink_epmask,则默认为EP_PERMALINK。 ‘query_var’(string | bool)为此帖子类型设置query_var键。默认为$ post_type键。如果为false,则无法在?{query_var} = {post_slug}加载帖子类型。如果指定为字符串,则查询?{query_var_string} = {post_slug}将有效。 ‘can_export’(bool)是否允许导出此帖子类型。默认为true。 ‘delete_with_user’(bool)删除用户时是否删除此类型的帖子。如果为true,则在删除用户时,属于该用户的此类帖子将被移至废纸篓。如果为false,则属于该用户的此类帖子将被删除或删除。如果未设置(默认值),则post_type_supports(‘author’)将删除帖子。否则,帖子不会被删除或删除。默认为null。 ‘_builtin’(bool)仅供内部使用!如果此帖子类型是本机或“内置”post_type,则为True。默认为false。 ‘_edit_link’(字符串)仅供内部使用!用于此帖子类型的编辑链接的网址段。默认’post.php?post =%d’。

源文件

路径:“

<?php
...
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/register_post_type/