WP_Customize_Setting::_preview_filter( mixed $original ): mixed

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


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 ↑


$original mixed Required
Old value.

Top ↑


mixed New or old value.

Top ↑


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 ↑


Version Description
3.4.0 Introduced.

Top ↑

User Contributed Notes

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