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;
}
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 |
---|---|
WP-3.9.0 | Introduced. |