钩子文档

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 on wp.customize.
$managerWP_Customize_Manager

Source

$response = apply_filters( 'customize_save_response', $response, $this );

Changelog

Version Description
4.2.0 Introduced.