WP_Customize_Widgets::capture_filter_pre_update_option() │ public │ WP 3.9.0

Pre-filters captured option values before updating.

Method of the class: WP_Customize_Widgets{}

No Hooks.

Return

Mixed. Filtered option value.

Usage

$WP_Customize_Widgets = new WP_Customize_Widgets();
$WP_Customize_Widgets->capture_filter_pre_update_option( $new_value, $option_name, $old_value );
$new_value(mixed) (required)
The new option value.
$option_name(string) (required)
Name of the option.
$old_value(mixed) (required)
The old option value.

Changelog

Since 3.9.0 Introduced.

WP_Customize_Widgets::capture_filter_pre_update_option() code WP 6.5.2

wp-includes/class-wp-customize-widgets.php 
public function capture_filter_pre_update_option( $new_value, $option_name, $old_value ) {
	if ( $this->is_option_capture_ignored( $option_name ) ) {
		return $new_value;
	}

	if ( ! isset( $this->_captured_options[ $option_name ] ) ) {
		add_filter( "pre_option_{$option_name}", array( $this, 'capture_filter_pre_get_option' ) );
	}

	$this->_captured_options[ $option_name ] = $new_value;

	return $old_value;
}