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 Parameters


(mixed) (Required) The new option value.


(string) (Required) Name of the option.


(mixed) (Required) The old option value.

Top ↑

Return Return

(mixed) Filtered option value.

Top ↑

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

Top ↑

Changelog Changelog

Version Description
3.9.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.