customize_save_response
云策文档标注
概述
customize_save_response 过滤器用于在成功的 customize_save Ajax 请求中过滤响应数据,适用于 WordPress 定制器保存操作。
关键要点
- 此过滤器仅在成功请求时应用,不适用于 nonce 或认证失败的情况。
- 参数包括 $response(数组,传递给 wp.customize 的 'saved' 事件)和 $this(WP_Customize_Manager 实例)。
- 在 WP_Customize_Manager::save() 方法中使用,处理保存/更新变更集的 Ajax 请求。
- 自 WordPress 4.2.0 版本引入。
原文内容
Filters response data for a successful customize_save Ajax request.
Description
This filter does not apply if there was a nonce or authentication failure.
Parameters
$responsearray-
Additional information passed back to the
'saved'event onwp.customize. $managerWP_Customize_Manager-
WP_Customize_Manager instance.
Source
$response = apply_filters( 'customize_save_response', $response, $this );
Changelog
| Version | Description |
|---|---|
| 4.2.0 | Introduced. |