customize_changeset_save_data │ filter-hook │ WP 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

Where the hook is called

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

Where the hook is used in WordPress