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

WP自定义组件Customizer中的add_setting

WP自定义组件Customizer api利用add_setting来生成设置项,这个东西并不会显性显示,它负责数据的处理,一个Control对应一个设置项setting,setting管理控件数据的预览、保存和清理。控件就像流水线上的产品,造型一致,功能统一,从流水线下来以后,我们取出一个产品打包(section),又给他贴了张快递面单(setting),这个时候这个产品就具有了唯一性,他有了对应的数据,客户修改了订单,要求产品上另行写上一行祝福语(修改控件值),那么最终客户会收到一个含有祝福语的产品(提交数据)。

节点管理控件的组织布局,而setting则负责包办控件的数据,控件生成时会绑定节点以确定显示位置,也需要绑定setting以定向提交数据。

用法与参数

设置项命令用法

add_setting( $id, $args );

add_setting参数

  • $id (字符串)(必须)一个唯一的id,默认:None
  • $args (数组)(必须)

$args 的参数

  • default (可选) 相关联Controller的默认值
  • transport (可选) 更新预览的方式,默认:refresh
  • type (可选)保存的方式,默认:theme_mod
  • capability (可选)根据用户的权限控制是否显示,默认:edit_theme_options
  • theme_supports (可选)根据主题的设置是否显示,用到方法add_theme_support
  • validate_callback (可选)设置值的服务器端验证回调
  • sanitize_callback (可选)定义一个函数以检验或过滤控件传回的原始值
  • sanitize_js_callback(可选)回调将Customize PHP设置值转换为JSON可序列化的值
  • dirty(可选)很少用,创建时不管是否有脏数据,默认:false

示例

$wp_customize->add_setting( 'setting_id', array(
  'type' => 'theme_mod', // or 'option'
  'capability' => 'edit_theme_options',
  'theme_supports' => '', // Rarely needed.
  'default' => '',
  'transport' => 'refresh', // or postMessage
  'sanitize_callback' => '',
  'sanitize_js_callback' => '', // Basically to_json.
) );

id的命名方式

请不要用诸如widget_,sidebars_widgets[],nav_menu[],或是nav_menu_item[]这样的条目来命名设置项,这些设置id分别为widget实例、边栏、导航菜单和导航菜单项保留。如果您需要在设置项id中使用"widget",请将其用作后缀而不是前缀,例如"homepage_widget"。

标签: 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