WP_Customize_Manager::update_stashed_theme_mod_settings() │ protected │ WP 4.7.0

Updates stashed theme mod settings.

Method of the class: WP_Customize_Manager{}

No Hooks.

Return

Array|false. Returns array of updated stashed theme mods or false if the update failed or there were no changes.

Usage

// protected - for code of main (parent) or child class
$result = $this->update_stashed_theme_mod_settings( $inactive_theme_mod_settings );

$inactive_theme_mod_settings(array) (required)

Mapping of stylesheet to arrays of theme mod settings.

Changelog

WP_Customize_Manager::update_stashed_theme_mod_settings() WP Customize Manager::update stashed theme mod settings code ^{WP 6.5.2}

protected function update_stashed_theme_mod_settings( $inactive_theme_mod_settings ) {
	$stashed_theme_mod_settings = get_option( 'customize_stashed_theme_mods' );
	if ( empty( $stashed_theme_mod_settings ) ) {
		$stashed_theme_mod_settings = array();
	}

	// Delete any stashed theme mods for the active theme since they would have been loaded and saved upon activation.
	unset( $stashed_theme_mod_settings[ $this->get_stylesheet() ] );

	// Merge inactive theme mods with the stashed theme mod settings.
	foreach ( $inactive_theme_mod_settings as $stylesheet => $theme_mod_settings ) {
		if ( ! isset( $stashed_theme_mod_settings[ $stylesheet ] ) ) {
			$stashed_theme_mod_settings[ $stylesheet ] = array();
		}

		$stashed_theme_mod_settings[ $stylesheet ] = array_merge(
			$stashed_theme_mod_settings[ $stylesheet ],
			$theme_mod_settings
		);
	}

	$autoload = false;
	$result   = update_option( 'customize_stashed_theme_mods', $stashed_theme_mod_settings, $autoload );
	if ( ! $result ) {
		return false;
	}
	return $stashed_theme_mod_settings;
}