customize_changeset_save_data filter-hookWP 4.7.0

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.

Usage

add_filter( 'customize_changeset_save_data', 'wp_kama_customize_changeset_save_data_filter', 10, 2 );

/**
 * Function for `customize_changeset_save_data` filter-hook.
 * 
 * @param array $data    Updated changeset data, mapping setting IDs to arrays containing a $value item and optionally other metadata.
 * @param array $context Filter context.
 *
 * @return array
 */
function wp_kama_customize_changeset_save_data_filter( $data, $context ){

	// filter...
	return $data;
}
$data(array)
Updated changeset data, mapping setting IDs to arrays containing a $value item and optionally other metadata.
$context(array)

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.

Changelog

Since 4.7.0 Introduced.

Where the hook is called

WP_Customize_Manager::save_changeset_post()
customize_changeset_save_data
wp-includes/class-wp-customize-manager.php 2894
$data = apply_filters( 'customize_changeset_save_data', $data, $filter_context );

Where the hook is used in WordPress

Usage not found.