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