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