在上一章中,我们register_post_type()函数,创建了一个wordpress主题自定义文章类型,可见,自定义文章类型可以适应各种相对复杂或需求自定义程度比较高的用户。register_post_type()函数参数是非常多,上一章的案例中,我们只使用了一部分。本章就来详细介绍register_post_type()函数参数。
register_post_type()函数参数说明:
1、label 是自定义新类型的别名标记。
2、$labels = array(
- ‘name’ => ‘商城’,
- ‘singular_name’ => ‘书本singularname’,
- ‘add_new’ => ‘发表产品’,
- ‘add_new_item’ => ‘发表一个新产品’,
- ‘edit_item’ => ‘编辑产品’,
- ‘new_item’ => ‘新产品’,
- ‘all_items’ => ‘所有产品’,
- ‘view_item’ => ‘查看产品’,
- ‘search_items’ => ‘搜索产品’,
- ‘not_found’ => ‘没有找到相关产品’,
- ‘not_found_in_trash’ => ‘回收间中没有相关产品’,
- ‘parent_item_colon’ => ”,
- ‘menu_name’ => ‘商城’
3、description 自定义新类型简短的介绍文字;
4、public (布尔值),用于定义publicly_queriable, show_ui, show_in_nav_menus and exclude_from_search的值
5、publicly_queryable (布尔值)可以从前台获取的变量(从url中,比如url重写)
6、exclude_from_search – (布尔值),是否能够被搜索到
7、show_ui (布尔值)是否生成一个默认的管理页面,也就是是否在后台有管理页面。
8、show_in_menu 是否在后台菜单项中显示,如果为ture,那么show_ui的值也必须设置为true,将会有一个顶级菜单项。
9、menu_position 在后台菜单中的位置。5 文章后面;10多媒体后面;15链接后;20页面后;25评论后;65插件后;70用户后;75工具后;80设置后;
10、menu_icon 菜单的icon图标(一个url)。默认null,就是跟文章图标一样。
11、capability_type 查看、编辑、删除的能力类型(capability),默认为post。
12、capabilities (数组,一般人用不到)
13、map_meta_cap (布尔值),只有设置了capabilities才用的上
14、hierarchical (布尔值),文章是否有层级关系,也就是是否允许有父级文章。
15、supports //(数组),对文章类型的一些功能支持
- ‘title’-标题
- ‘editor’ (content) – 内容编辑器
- ‘author’ – 作者
- ‘thumbnail’ – 特色图像,主题还得支持特色图像才行
- ‘excerpt’ – 摘要
- ‘trackbacks’
- ‘custom-fields’-自定义字段
- ‘comments’ – 评论
- ‘revisions’ – 修订版
- ‘page-attributes’ – 页面属性,类似page,选择页面模板的那个
16、register_meta_box_cb 当执行remove_meta_box() 和add_meta_box()时调用的函数
17、taxonomies 添加已经注册了的分类法(比如默认的分类、标签)
18、has_archive 文章是否有归档,就是一个所有文章归档页面。
19、rewrite – (布尔值或者数组),是否有url重写,设置为false的话将会防止url重写,关于重写以后教程详细讲解。
- ‘slug’ -默认使用此类型的 name , 自定义使用 array(‘slug’=>$slug)
- ‘with_front’ 添加前缀 如:前缀/blog/, 连接: false-> /news/, true-> /blog/news/)
- ‘feeds’ – 默认是has_archive 的值
- ‘pages’ – 默认值 true
20、query_var – url重写会用到
21、can_export – 是否输出
22、show_in_nav_menus – 是否出现在设置菜单页面的选项中
23、_builtin – wordpress开发人员建议你不要使用这个参数哦。
24、_edit_link – wordpress开发人员建议你不要使用这个参数哦。
本章详细介绍了,register_post_type()函数的参数,在使用中,我们不一定全用到,但是了解一下,对今后我们注册wordpress主题自定义文章类型时会有相当大的帮助。如果不对这些参数有所了解,我们在代码时,可能会碰到不少的问题的。