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.

Parameters

$originalmixedrequired
Old value.

Return

mixed New or old value.

Source

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

Changelog

VersionDescription
3.4.0Introduced.

User Contributed Notes

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