W3cubDocs

/WordPress

WP_Customize_Widgets::capture_filter_pre_update_option( mixed $new_value, string $option_name, mixed $old_value )

Pre-filters captured option values before updating.

Parameters

$new_value

(mixed) (Required) The new option value.

$option_name

(string) (Required) Name of the option.

$old_value

(mixed) (Required) The old option value.

Return

(mixed) Filtered option value.

Source

File: 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;
	}

Changelog

Version Description
3.9.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_widgets/capture_filter_pre_update_option