customize_save_validation_before
云策文档标注
概述
customize_save_validation_before 是一个 WordPress 动作钩子，在保存验证之前触发，允许插件动态添加针对特定设置的验证过滤器。
关键要点
- 触发时机：在保存验证发生之前执行。
- 主要用途：插件可以利用此钩子添加 'customize_validate_{$this->ID}' 过滤器，以捕获在 customize_register 之后注册的设置。
- 动态钩子名称：钩子名称中的动态部分 $this->ID 指代设置 ID。
- 参数：接受一个 WP_Customize_Manager 实例作为参数。
- 相关函数：在 WP_Customize_Manager::save_changeset_post() 方法中使用，用于保存加载的变更集。
- 版本历史：自 WordPress 4.6.0 版本引入。
原文内容
Fires before save validation happens.
Description
Plugins can add just-in-time ‘customize_validate_{$this->ID’} filters at this point to catch any settings registered after customize_register.
The dynamic portion of the hook name, $this->ID refers to the setting ID.
Parameters
$managerWP_Customize_Manager-
WP_Customize_Manager instance.
Source
do_action( 'customize_save_validation_before', $this );
Changelog
| Version | Description |
|---|---|
| 4.6.0 | Introduced. |