WP_Customize_Widgets::filter_option_sidebars_widgets_for_theme_switch( array $sidebars_widgets )

Filters sidebars_widgets option for theme switch.

Description

When switching themes, the retrieve_widgets() function is run when the Customizer initializes, and then the new sidebars_widgets here get supplied as the default value for the sidebars_widgets option.

See also

Parameters

$sidebars_widgets

(array) (Required)

Return

(array)

Source

File: wp-includes/class-wp-customize-widgets.php 

public function filter_option_sidebars_widgets_for_theme_switch( $sidebars_widgets ) {
		$sidebars_widgets                  = $GLOBALS['sidebars_widgets'];
		$sidebars_widgets['array_version'] = 3;
		return $sidebars_widgets;
	}

Changelog

Version Description
3.9.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_widgets/filter_option_sidebars_widgets_for_theme_switch