WordPress函数详解——register_post_type($post_type,$args)

register_post_type($post_type,$args)是用于自定义文章类型的函数,在之前有讲过其主要参数,在此,我将该函数的所有参加以及其具体含义进行了归纳,以供大家了解:

* $post_type - 自定义文章类型** $args - 详细设置:* label - 选填 默认和$post_type一样* labels: 该数组主要是设置wordpress中该文章类型页各种按钮和消息的内容* name - 文章类型的名称(复数)* singular_name - 单篇文章类型的名称* add_new - 对应“添加新的文本”* add_new_item - “添加新帖/新页面”* edit_item - “编辑帖子/页面”* new_item - “新贴/新页”* view_item - “查看帖子/页面”* view_items - 用于查看帖子类型归档的标签。默认是'查看帖子'/'查看页面'* search_item - 默认是搜索帖子/搜索页面* not_found - 默认是没有发现帖子/找不到页面。* not_found_in_trash - 默认是在垃圾桶中找不到帖子/在垃圾桶中找不到页面。* parent_item_colon - 此字符串不用于非分层类型。在层次结构中,默认为“父页面:”。* all_items - 子菜单的字符串。默认是所有帖子/所有页面。* archives - 与导航菜单中的档案一起使用的字符串。默认是Post Archives / Page Archives。* attributes - 属性元框的标签。默认为“发布属性”/“页面属性”。* insert_into_item - 媒体帧按钮的字符串。默认为插入/插入页面。* uploaded_to_this_item - 媒体帧过滤器的字符串。默认是上传到这个帖子/上传到这个页面。* featured_image - 默认是精选图像。* set_featured_image - 默认设置功能图像。* remove_featured_image' - 默认是删除功能图像。* use_featured_image' - 默认用作特色图像。* menu_name' - 默认与`name`相同。* filter_items_list' - 表视图隐藏标题的字符串。* items_list_navigation' - 用于表分页隐藏标题的字符串。* items_list' - 表隐藏标题的字符串。* name_admin_bar' - 用于管理员菜单栏中新建的字符串。默认值与“singular_name”相同。* description - 文章类型的简要描述,可以通过以下代码读取:* $ obj = get_post_type_object('your_post_type_name');* echo esc_html($ obj-> description);* public- 控制类型对authors(show_in_nav_menus,show_ui)* 和reader(exclude_from_search,publicly_queryable)可见的方式。* 默认是false* exclude_from_search -是否从前端搜索结果排除此帖子类型的帖子。* 默认值:与public参数相反的值* publicly_queryable -是否可以在前端执行查询作为parse_request()的一部分。* 默认值:public参数的值* show_ui - 是否在管理员中生成用于管理此帖子类型的默认UI。* 默认值:public参数的值* show_in_nav_menus -是否可以在导航菜单中选择post_type。* 默认值:public参数的值* show_in_menu- 在管理菜单中显示帖子类型的位置。show_ui必须是真的。* 默认值:show_ui参数的值* false - 不要在管理菜单中显示* true - 显示为顶级菜单* some string' - 如果现有的顶级页面,如“tools.php”或“edit.php?post_type = page”,那么这个帖子类型将被放置为子菜单。* show_in_admin_bar - 是否在WordPress管理栏中使此帖子类型可用。* 默认值:show_in_menu参数的值* menu_position - 菜单中的位置将显示帖子类型。show_in_menu必须为true。* 默认值:null - 默认为以下注释* 5 - below Posts* 10 - below Media* 15 - below Links* 20 - below Pages* 25 - below comments* 60 - below first separator* 65 - below Plugins* 70 - below Users* 75 - below Tools* 80 - below Settings* 100 - below second separator* menu_icon-用于此菜单的图标的URL或iconfont中图标的名称* 默认值:null - 默认为帖子图标* capability_type - 用于构建读取,编辑和删除功能的字符串。可以作为一个数组传递,* 以便使用这个参数作为基础来构建功能时可以使用替代复数,例如array('story','stories'),* 第一个数组元素将被用于单数形式的能力,第二个数组元素对于复数功能,* 这不是自动生成的版本,如果没有给出数组将是“故事”。* 'capability_type'参数用作构建能力的基础,除非它们使用'capabilities'参数显式设置。* 似乎`map_meta_cap`需要设置为false或者为null,以使其工作* 默认:“post”* capabilities - 这个帖子类型的功能的数组。* 默认值:capability_type用于构造* map_meta_cap - 是否使用内部默认元功能处理。* 默认值:null* 如果将其设置为false,则标准管理角色无法编辑帖子类型。然后必须将edit_post功能添加到所有角色以添加或编辑帖子类型。* hierarchical - Post类型是否是分层的(例如页面)。允许指定父项。'supports'参数应该包含'page-attributes'来显示编辑器页面上的父选择框。* 默认值:false* supports - 用于直接调用add_post_type_support()的别名。从3.5开始,布尔值false可以作为值而不是数组传递,以防止缺省(标题和编辑器)行为。* Default: title and editor* 'title' 标题* 'editor' (content) 编辑器* 'author' 作者* 'thumbnail' 特色图片* 'excerpt' 摘抄* 'trackbacks' 引用通过* 'custom-fields' 自定义字段* 'comments' 评论* 'revisions' 修订-将修改存储* 'page-attributes' 菜单顺序* 'post-formats' 添加帖子格式* 注意:当您使用使用缩略图的自定义帖子类型时,请记住,该主题还支持缩略图或使用add_theme_support功能。* register_meta_box_cb - 提供在设置编辑表单的元框时调用的回调函数。回调函数使用一个参数$ post,其中包含当前编辑的帖子的WP_Post对象。* 在回调中执行remove_meta_box()和add_meta_box()调用。* 默认值:无* taxonomies - 一个category或多个post_tag已使用此类型的注册分类法的数组。这可以直接用于调用register_taxonomy_for_object_type()。* 自定义分类法仍然需要注册register_taxonomy()。* 默认值:没有分类* has_archive- 启用帖子类型归档。默认情况下,将使用$ post_type作为存档段。默认值:false* rewrite - 触发此帖子类型的重写操作。为了防止重写,设置为false。* 默认值:true,并使用$ post_type作为slug* $ args数组* 'slug'=> string自定义永久链接结构块。默认为$ post_type值。应该是可翻译的* 'with_front'=> bool应该使用前置基座添加永久链接结构。(例如:如果你的永久链接结构是/ blog /,那么你的链接将是:false - > / news /,true - > / blog / news /)。默认为true* 'feed'=> bool应该为此帖子类型构建一个feed permalink结构。默认为has_archive值。* 'pages'=> bool应该是永久链接结构提供分页。默认为true* 'ep_mask'=> const 从3.4开始为这个帖子类型分配端点掩码。有关更多信息,请参阅Rewrite API / add_rewrite_endpoint,并创建端点的WordPress插件摘要。* 如果没有指定,那么它继承自permalink_epmask(如果permalink_epmask被设置),否则默认为EP_PERMALINK。* 注意:如果在插件中注册一个帖子类型,请在激活和停用挂钩中调用flush_rewrite_rules()。* 如果未使用flush_rewrite_rules(),则必须手动进入“设置”>“固定链接”,并刷新您的固定链接结构,然后您的自定义帖子类型将显示正确的结构。* permalink_epmask - 默认的重写端点位掩码。* 默认值:EP_PERMALINK* query_var - 设置此帖子类型的query_var键。 默认值:true - 设置为$ post_type false则表示禁用query_var* can_export - 可以导出此post_type。* 默认值:true* delete_with_user - 删除用户时是否删除此类型的帖子。如果为true,则当用户被删除时,* 属于该用户的此类型的帖子将被移动到垃圾桶。如果为false,* 属于该用户的此类型的帖子将不会被删除或删除。* 如果没有设置(默认),如果post_type_supports('author'),帖子将被删除。* 否则帖子不会被删除或删除。* 默认值:null* show_in_rest - 是否在REST API中公开此帖子类型。默认值:false* rest_base - 当使用REST API访问时,此帖子类型将使用的基本段。默认值:$ post_type* rest_controller_class - 使用可选的自定义控件来代替WP_REST_Posts_Controller。必须是WP_REST_Controller的子类。* 默认值:WP_REST_Posts_Controller
发表评论
加载中...

相关文章