首页>建站相关>WP自定义组件Customizer中的add_panel

WP自定义组件Customizer中的add_panel

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',
) );

标签: wordpress

移动端可扫我直达哦~

推荐阅读

wordpress 2024-04-01

Wordpress的过滤器add_filter与apply_filters

对Wordpress的这个filters的概念一直是一知半解(其实半解也算不上,只能算知道有这么个函数),最近遇到了Wordpress的头像问题,无可避免的又遇到过滤器。刚好在CSDN上看到某篇文章写得比较清楚,摘录顺便自己动手尝试一...

建站相关 wordpress

wordpress 2024-03-28

Wordpress中Gravatar头像不显示的解决方案

Wordpress是个老牌的博客软件,版本迭代至今,几乎已经是市占率最高的一款建站工具。一直觉得一款软件,它的用户越多,使用就会越人性化,因为用户的使用水平不同,会遇到不同层次的问题,通过收集与筛选用户反馈,更可以有的放矢的去完善软件...

建站相关 wordpress

wordpress 2023-09-05

关于get_the_post_thumbnail函数

与the_post_thumbnail直接输出不同,get开头的函数,包括但不限于get_the_post_thumbnail,往往会返回一些值。在需要对这些值进行操作,比如转存或修改时,我们需要使用get系的函数。<?php ...

建站相关 wordpress

wordpress 2023-06-19

save_post的可接受参数与add_action语法

想在主页的文章列表中,为每一篇文章配置一张缩略图,之前修改twentyten主题的时候尝试过类似的实现,只是某天一个不小心“rm -rf wordpress”,连主题带所有图片都被删得一干二净。只记得是一个较为复杂的判断语句,先判断有...

建站相关 wordpress

wordpress 2023-06-10

customize自定义项目被保存后的后续处理

在自定义项目中设置了一组幻灯片的数据,本来准备直接在输入完成后对数据进行重组,利用换行符号分割数据,利用“||”符号区分连接与图片地址,在保存设置项时将输入数据直接组装为html语句。实际测试过程中极其不方便,一有更改就需要重新输入源...

建站相关 wordpress

wordpress 2023-05-07

Wordpress添加设置项目后如何修改项目值

使用add_option添加了一部分自定义设置,采用了数组的形式。希望其中部分设置能在保存或者修改文章之后自动获取新数据并更新,所以准备在“save_post”(编辑或发布后)执行一个更新数据的操作。Wordpress的函数命名很规范...

建站相关 wordpress

wordpress 2023-05-07

Wordpress生成标签云的函数wp_tag_cloud

很多站点上都会展现彩色的标签云,从个人浏览经验来看,相对于分类目录,文章标签反而更适合用户快速定位到意向查看的文章。一方面目录分类范围较大,一方面目录一般位于页眉,而标签云往往会被布局于页面底部,下意识的就近原则,也会让标签得到更多的...

建站相关 wordpress

wordpress 2023-04-30

wordpress自定义组件add_setting的回调测试

在后台设置了一个站点logo图片地址的参数,考虑到后期可能更换,有手动输入的需求,所以准备设计成仅输入文件名称,指定文件的文件夹,当用户输入后由系统组装文件夹地址与图片名称,从而得到完整的图片地址。虽然知道add_setting支持回...

建站相关 wordpress