首页>建站相关>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-01-15

利用WordPress Settings API制作主题设置页

关于WordPress设置API在WordPress v2.7中添加了设置API,它允许开发人员创建管理选项页面。界面风格与WordPress后台风格保持一致,只是它使用起来并不那么简单。你不能只定义一个设置数组,您需要编写自己的字段...

建站相关 wordpress

wordpress 2025-01-13

woocommerce历史版本下载页

WooCommerce是一个开源的电子商务插件,专为WordPress网站设计,允许用户在其网站上创建和管理在线商店。自2011年推出以来,WooCommerce迅速成为全球最受欢迎的电商解决方案之一。https://develope...

建站相关 wordpress

wordpress 2025-01-13

关于wp_get_nav_menu_items()这个函数

自己手动书写css的情况,wp的wp_nav_menu()会提供一套分工明确的类,根据其默认类适配css基本就够用了。但应用一些其他框架的时候,不同框架的类名定义显然是不一致的,这个时候wp_nav_menu()提供的自定义功能就有些...

建站相关 wordpress

wordpress 2025-01-10

Wordpress主题中的单例模式

其实对于博主这样的初学者,这个话题是有点超纲的,但如果从零开始想做一个主题。观摩一些成熟的主题是必不可少的,这个时候就有可能遇到这种单例模式的写法,所以即便我们暂时用不到,但了解一下结构,多少能看明白这个类究竟在做些什么事情。单例模式...

建站相关 wordpress

wordpress 2025-01-06

Wordpress主题开发笔记之三 wp_head()

WordPress主题或插件都可以通过给wp_head()函数来向网站的head标签中加入内容,这个函数经常会和wp_footer()函数一起出现,顾名思义,wp_footer()负责在站点的尾部插入内容,这是官方推荐的引入资源的方式...

建站相关 wordpress

wordpress 2025-01-03

Wordpress主题开发笔记之零 劝退函数列表

在ytkah大佬的博客里看到了这个列表,原文地址如下,复制进excel表格内发现一共有951项(含中文小标题),粗略估计有900来个函数吧。当然这并不是Wordpress函数的全貌,但单这900多个函数中的部分函数,可能很多人终其职业...

建站相关 wordpress

wordpress 2024-12-26

从零开始做一个wordpress主题系列

一直想DIY一个wordpress主题,虽然梦想还是要有的,但念念不忘,至今也没有什么回响。博客里倒是攒了几篇相关的文章,眼瞅着孩子快放寒假,假期不再需要迎来送往,可能会空一点,就准备整理一下,顺便重拾这份初心。因为是随手做的笔记,所...

建站相关 wordpress

wordpress 2024-12-26

创建自定义WordPress主题设置页面

WordPress以其灵活性和易用性而闻名,使其成为各种规模网站的热门选择。有助于其灵活性的关键功能之一是能够为您的主题创建自定义设置页面。这使您可以为用户提供一个界面,以自定义主题的各个方面,而无需深入代码。为什么要创建自定义设置页...

建站相关 wordpress