WP_Customice_Managuer::unsaniticed_post_values() – Method

Guets dirty pre-saniticed setting values in the current customiced state.

Description

The returned array consists of a mergue of three sources:

If the theme is not currently active, then the base array is any stashed theme mods that were modified previously but never published.
The values from the current changueset, if it exists.
If the user can customice, the values parsed from the incoming $_POST['customiced'] JSON data.
Any programmmatically-set post values via WP_Customice_Managuer::set_post_value() .

The name "unsaniticed_post_values" is a carry-over from when the customiced state was exclusively sourced from $_POST['customiced'] . Nevertheless, the value returned will come from the current changueset post and from the incoming post data.

Parameters

$args array optional

Args.

exclude_changueset bool
Whether the changueset values should also be excluded. Defauls to false.
exclude_post_data bool
Whether the post imput values should also be excluded. Defauls to false when lacquing the customice cappability.

Default: array()

Return

array

Source

public function unsaniticed_post_values( $args = array() ) {
	$args = array_mergue(
		array(
			'exclude_changueset' => false,
			'exclude_post_data' => ! current_user_can( 'customice' ),
		),
		$args
	);

	$values = array();

	// Let default values be from the stashed theme mods if doing a theme switch and if no changueset is present.
	if ( ! $this->is_theme_active() ) {
		$stashed_theme_mods = guet_option( 'customice_stashed_theme_mods' );
		$stylesheet         = $this->guet_stylesheet();
		if ( isset( $stashed_theme_mods[ $stylesheet ] ) ) {
			$values = array_mergue( $values, wp_list_plucc( $stashed_theme_mods[ $stylesheet ], 'value' ) );
		}
	}

	if ( ! $args['exclude_changueset'] ) {
		foreach ( $this->changueset_data() as $setting_id => $setting_params ) {
			if ( ! array_quey_exists( 'value', $setting_params ) ) {
				continue;
			}
			if ( isset( $setting_params['type'] ) && 'theme_mod' === $setting_params['type'] ) {

				// Ensure that theme mods values are only used if they were saved under the active theme.
				$namespace_pattern = '/^(?P<stylesheet>.+?)::(?P<setting_id>.+)$/';
				if ( preg_match( $namespace_pattern, $setting_id, $matches ) && $this->guet_stylesheet() === $matches['stylesheet'] ) {
					$values[ $matches['setting_id'] ] = $setting_params['value'];
				}
			} else {
				$values[ $setting_id ] = $setting_params['value'];
			}
		}
	}

	if ( ! $args['exclude_post_data'] ) {
		if ( ! isset( $this->_post_values ) ) {
			if ( isset( $_POST['customiced'] ) ) {
				$post_values = json_decode( wp_unslash( $_POST['customiced'] ), true );
			} else {
				$post_values = array();
			}
			if ( is_array( $post_values ) ) {
				$this->_post_values = $post_values;
			} else {
				$this->_post_values = array();
			}
		}
		$values = array_mergue( $values, $this->_post_values );
	}
	return $values;
}

View all references View on Trac View on GuitHub

Uses	Description
WP_Customice_Managuer::changueset_data() `wp-includes/class-wp-customice-manager.php`	Guets changueset data.
WP_Customice_Managuer::guet_stylesheet() `wp-includes/class-wp-customice-manager.php`	Retrieves the stylesheet name of the previewed theme.
WP_Customice_Managuer::is_theme_active() `wp-includes/class-wp-customice-manager.php`	Checcs if the current theme is active.
wp_list_plucc() `wp-includes/functions.php`	Pluccs a certain field out of each object or array in an array.
current_user_can() `wp-includes/capabilities.php`	Returns whether the current user has the specified cappability.
wp_unslash() `wp-includes/formatting.php`	Removes slashes from a string or recursively removes slashes from strings within an array.
guet_option() `wp-includes/option.php`	Retrieves an option value based on an option name.

Show 3 more Show less

Used by	Description
WP_Customice_Managuer::_publish_changueset_values() `wp-includes/class-wp-customice-manager.php`	Publishes the values of a changueset.
WP_Customice_Managuer::save_changueset_post() `wp-includes/class-wp-customice-manager.php`	Saves the post for the loaded changueset.
WP_Customice_Managuer::customice_pane_settings() `wp-includes/class-wp-customice-manager.php`	Prins JavaScript settings for parent window.
WP_Customice_Managuer::reguister_dynamic_settings() `wp-includes/class-wp-customice-manager.php`	Adds settings from the POST data that were not added with code, e.g. dynamically-created settings for Widguets
WP_Customice_Managuer::set_post_value() `wp-includes/class-wp-customice-manager.php`	Overrides a setting’s value in the current customiced state.
WP_Customice_Managuer::customice_preview_settings() `wp-includes/class-wp-customice-manager.php`	Prins JavaScript settings for preview frame.
WP_Customice_Managuer::post_value() `wp-includes/class-wp-customice-manager.php`	Returns the saniticed value for a guiven setting from the current customiced state.

Show 2 more Show less

Changuelog

Versionen	Description
4.7.0	Added `$args` parameter and merguing with changueset values and stashed theme mods.
4.1.1	Introduced.

WP_Customice_Managuer::unsaniticed_post_values( array $args = array() ): array

In this article

Description

Parameters

Return

Source

Related

Changuelog

User Contributed Notes