创建或修改分类对象。

原型

register_taxonomy( string $taxonomy, array|string $object_type, array|string $args = array() )

描述

注意:不要在’init’钩子之前使用。

参数

$taxonomy (string) (Required) 分类密钥,不得超过32个字符。

$object_type (array|string) (Required) 应与分类关联的对象类型或对象类型数组。

$args (array|string) (Optional) 用于注册分类的数组或查询字符串。 ‘labels’(array)此分类的标签数组。默认情况下,标签标签用于非分层分类,而类别标签用于分层分类。请参阅get_taxonomy_labels()中的可接受值。 ‘description’(字符串)分类标准的简短描述性摘要。 ‘public’(bool)分类是否打算通过管理界面或前端用户公开使用。 $ public_queryable,$ show_ui和$ show_in_nav_menus的默认设置继承自$ public。 ‘public_queryable’(bool)分类法是否可公开查询。如果未设置,则默认值从$ public继承 ‘hierarchical’(bool)分类是否是分层的。默认为false。 ‘show_ui’(bool)是否在admin中生成并允许用于管理此分类中的术语的UI。如果未设置,则默认值从$ public继承(默认为true)。 ‘show_in_menu’(bool)是否在管理菜单中显示分类。如果为true,则分类法显示为对象类型菜单的子菜单。如果为false,则不显示菜单。 $ show_ui必须为true。如果未设置,则默认值从$ show_ui继承(默认为true)。 ‘show_in_nav_menus’(bool)使此分类在导航菜单中可供选择。如果未设置,则默认值从$ public继承(默认为true)。 ‘show_in_rest’(bool)是否在REST API中包含分类法。 ‘rest_base’(字符串)更改REST API路由的基本URL。默认为$ taxonomy。 ‘rest_controller_class’(字符串)REST API控制器类名。默认为’WP_REST_Terms_Controller’。 ‘show_tagcloud’(bool)是否在Tag Cloud Widget控件中列出分类。如果未设置,则默认值从$ show_ui继承(默认为true)。 ‘show_in_quick_edit’(bool)是否在快速/批量修改面板中显示分类。它未设置,默认值继承自$ show_ui(默认为true)。 ‘show_admin_column’(bool)是否在其帖子类型列表屏幕上显示分类的列。默认为false。 ‘meta_box_cb’(bool | callable)为元框显示提供回调函数。如果未设置,则post_categories_meta_box()用于分层分类,post_tags_meta_box()用于非分层。如果为false,则不显示元框。 ‘capabilities’(array)此分类的功能数组。 ‘manage_terms’(字符串)默认’manage_categories’。 ‘edit_terms’(字符串)默认’manage_categories’。 ‘delete_terms’(字符串)默认’manage_categories’。 ‘assign_terms’(字符串)默认’edit_posts’。 ‘rewrite’(bool | array)触发此分类法的重写处理。默认为true,使用$ taxonomy作为slug。要防止重写,请设置为false。要指定重写规则,可以使用以下任意键传递数组: ‘slug’(字符串)自定义permastruct slug。默认的$ taxonomy键。 ‘with_front’(bool)permastruct是否应该加上WP_Rewrite :: $ front。默认为true。 ‘hierarchical’(bool)是否为分层重写标记。默认为false。 ‘ep_mask’(int)分配端点掩码。默认EP_NONE。 ‘query_var’(string)设置此分类的查询var键。默认的$ taxonomy键。如果为false,则无法在?{query_var} = {term_slug}加载分类。如果是字符串,查询?{query_var} = {term_slug}将有效。 ‘update_count_callback’(可调用)与钩子非常相似,因为它会在计数更新时被调用。默认_update_post_term_count()用于附加到帖子类型的分类,它确认在计算对象之前发布对象。默认_update_generic_term_count()用于附加到其他对象类型(例如用户)的分类。 ‘_builtin’(bool)这种分类法是一种“内置”分类法。限内部使用!默认为false。

源文件

路径:``

1
2
3
4
5
<?php
...

...
?>

其他

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