customize_changeset_save_data

💡 云策文档标注

概述

customize_changeset_save_data 是一个 WordPress 过滤器，用于在保存定制器更改集时过滤设置数据。它允许插件修改或添加额外数据到更改集中。

过滤器名称：customize_changeset_save_data
主要用途：过滤即将持久化到更改集中的设置数据，支持插件添加元数据等额外信息
参数：$data（更新的更改集数据数组，映射设置ID到包含$value和其他元数据的数组），$context（过滤上下文数组）
上下文参数包括：uuid（更改集UUID）、title（请求的标题）、status（请求的状态）、date_gmt（GMT时间戳）、post_id（更改集文章ID）、previous_data（先前数据）、manager（WP_Customize_Manager实例）
引入版本：WordPress 4.7.0
相关函数：在 WP_Customize_Manager::save_changeset_post() 中使用

$data = apply_filters( 'customize_changeset_save_data', $data, $filter_context );

📄 原文内容

Filters the settings’ data that will be persisted into the changeset.

Plugins may amend additional data (such as additional meta for settings) into the changeset with this filter.

$dataarray

Updated changeset data, mapping setting IDs to arrays containing a $value item and optionally other metadata.

$contextarray

Filter context.

uuid string
Changeset UUID.
title string
Requested title for the changeset post.
status string
Requested status for the changeset post.
date_gmt string
Requested date for the changeset post in MySQL format and GMT timezone.
post_id int|false
Post ID for the changeset, or false if it doesn’t exist yet.
previous_data array
Previous data contained in the changeset.
manager WP_Customize_Manager
Manager instance.

$data = apply_filters( 'customize_changeset_save_data', $data, $filter_context );

Used by	Description
WP_Customize_Manager::save_changeset_post()`wp-includes/class-wp-customize-manager.php`	Saves the post for the loaded changeset.

Version	Description
4.7.0	Introduced.