首页>建站相关>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 2025-03-31

wordpress 重新生成缩略图

测试wp缩略图功能的时候不小心把所有的缩略图都删掉了,但保留了原图,不想一个个重新上传以生成缩略图,就使用了这段代码,注意生成成功之后,这段代码就可以删掉了。忽然想起之前钉钉宣传的某个功能,阅后即焚~~function regener...

建站相关 wordpress

wordpress 2025-03-29

WordPress的主循环与WP_Query

WordPress的主循环和WP_Query是主题开发中最重要的两个概念,它们负责从数据库获取内容并显示在页面上。主循环 (The Loop)主循环是WordPress用来显示文章的核心机制。它是一个PHP代码结构,用于遍历当前页面请...

建站相关 wordpress

wordpress 2025-03-22

在phpstudy中为wordpress开启伪静态

原文修改主题都是在服务器上一边在线修改一边调试,用上了phpstudy后才发现自己之前的方式有多没有效率。但测试设置固定链接的时候遇到了一个问题,就是设置前也无风雨也无晴,设置后统一返回404。这个问题之前尝试搭建站点的时候也遇到过,...

建站相关 wordpress

wordpress 2025-03-17

WordPress分页中遇到404错误:posts_per_page

这个问题可能更多为主题开发者所遇见,一款推向市场的主题一般都会几经测试,应该不容易到客户手中才发现这个问题。所以网络上的相关讨论不多,博主也是调试了几天才大致有了一些思路:后台的默认参数在wordpress的后台设置里,是可以设置归档...

建站相关 wordpress

wordpress 2025-03-14

WORDPRESS HEADER模块常用函数

在 WordPress 开发中,header.php 文件是主题的重要组成部分,用于定义网站的头部内容。以下是一些在 header.php 中常用的 WordPress 函数及其用途,如果嫌部分函数生成的默认模板不需要的元素过多,也可...

建站相关 wordpress

wordpress 2025-03-12

wordpress的前后台数据交换ajax

ajax是个耳熟能详的词儿,但因为有点儿复杂,博主一直是规避学习的,今天刚好碰到一个前台jquery向wp后台申请数据的问题。躲不过,那就慢慢调试吧。钩子wp的ajax还区分了用户,对于不同的用户(登录与否)采用不同的钩子,不过这里只...

建站相关 wordpress

wordpress 2025-03-07

WordPress中add_meta_box函数参数详解

add_meta_box 是 WordPress 中用于在后台编辑页面添加自定义元框(Meta Box)的函数。它允许开发者在文章、页面、自定义文章类型等编辑页面中添加自定义字段或内容。以下是 add_meta_box 函数的参数及其...

建站相关 wordpress

wordpress 2025-03-07

wordpress 手动添加自定义字段

自定义字段可以扩展文章的信息,也有很多相关的成熟的插件,比如Advanced Custom Fields (ACF) 插件,如果希望添加的字段不多,也不愿意为此安装过多的插件,我们也可以考虑手动来添加它。为post文章添加字段// 添...

建站相关 wordpress

wordpress 2025-03-07

wordpress 自定义文章类型

在 WordPress 中,Post Type(文章类型)是指不同类型的内容,例如文章(Post)、页面(Page)、自定义文章类型等。每种文章类型可以使用不同的模板来显示其内容。以下是关于 WordPress 文章类型模板的基本信息...

建站相关 wordpress