WP_Customize_Setting::_preview_filter( mixed $original ): mixed

Callback function to filter non-multidimensional theme mods and options.


Description

If switch_to_blog() was called after the preview() method, and the current site is now not the same site, then this method does a no-op and returns the original value.


Top ↑

Parameters

$original mixed Required
Old value.

Top ↑

Return

mixed New or old value.


Top ↑

Source

File: wp-includes/class-wp-customize-setting.php. View all references

public function _preview_filter( $original ) {
	if ( ! $this->is_current_blog_previewed() ) {
		return $original;
	}

	$undefined  = new stdClass(); // Symbol hack.
	$post_value = $this->post_value( $undefined );
	if ( $undefined !== $post_value ) {
		$value = $post_value;
	} else {
		/*
		 * Note that we don't use $original here because preview() will
		 * not add the filter in the first place if it has an initial value
		 * and there is no post value.
		 */
		$value = $this->default;
	}
	return $value;
}


Top ↑

Changelog

Changelog
Version Description
3.4.0 Introduced.

Top ↑

User Contributed Notes

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