wordpress提供了一套自定义组件,让用户可以轻松实现一些后台参数设置,自定义组件Customizer是面向对象的。它提供了四种基本类型的对象:面板Panels、节点Sections、参数项Settings和控件Controls。参数项将控件与保存在数据库中的设置相关联。节点是控件的容器,用于控件的分类组织。而面板是节点的容器,允许将多个节组合在一起。
四类基础控件
Panels: 包含Sections,允许把多个Sections组合在一起
Sections: 包含Controls, 每个Section可以包含多个Controls
Settings: 将Controls于数据库中保存的设置相关联
Controls: UI控件,通常控件包括输入框、选择框、下拉框、图片选择、日期选择等等,还可以自行扩展其他控件
面板不是必须的
自定义面板API是在WordPress 4.0中引入的,它允许开发者在控件和节之外创建一个额外的层次结构层。面板不仅仅是简单地对控件的节进行分组,它被设计来为自定义器提供不同的上下文,比如自定义小部件、菜单,或者将来编辑帖子。节和面板对象之间有一个重要的技术区别。
大多数情况下,主题不需要注册自己的面板,节点也无需嵌套在面板之内,并且每个节点通常应该包含多个控件。如果你一定要使用面板,你会发现它的API和节点对象的API几乎是一样的。面板必须至少包含一个要显示的区段,而区段必须至少包含一个控件。如以上范例所示,节点可以新增至面板,与控件新增至节点的方式类似。不过,与控件不同的是,如果注册节点时,则节点会显示在顶层自订器内容中。
用法与参数
添加面板的命令
add_panel( $id, $args );
面板命令支持参数
- $id (字符串)(必须)一个唯一的id,默认:None
- $args (数组)(必须)
$args 的参数
- title 显示的名称
- description (可选)描述
- priority(可选)排序
- capability (可选)根据用户的权限控制是否显示,默认:edit_theme_options
- theme_supports (可选)根据主题的设置是否显示,用到方法add_theme_support
- active_callback (可选)根据当前页面是否显示,例如’active_callback’ => ‘is_front_page’
面板的示例代码
$wp_customize->add_panel( 'menus', array(
'title' => __( 'Menus' ),
'description' => $description, // Include html tags such as <p>.
'priority' => 160, // Mixed with top-level-section hierarchy.
) );
$wp_customize->add_section( $section_id , array(
'title' => $menu->name,
'panel' => 'menus',
) );