WP_Customize_Widgets::capture_filter_pre_update_option() WordPress Method

The WP_Customize_Widgets::capture_filter_pre_update_option() method allows you to intercept and modify the value being updated for a particular setting. This can be useful for ensuring that a value is valid before it is saved to the database.

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

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