wp_set_sidebars_widgets( array $sidebars_widgets )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Set the sidebar widget option to update sidebars.

Parameters

$sidebars_widgets

(array) (Required) Sidebar widgets and their settings.

Source

File: wp-includes/widgets.php 

function wp_set_sidebars_widgets( $sidebars_widgets ) {
	global $_wp_sidebars_widgets;

	// Clear cached value used in wp_get_sidebars_widgets().
	$_wp_sidebars_widgets = null;

	if ( ! isset( $sidebars_widgets['array_version'] ) ) {
		$sidebars_widgets['array_version'] = 3;
	}

	update_option( 'sidebars_widgets', $sidebars_widgets );
}

Uses

Uses Description
wp-includes/option.php: update_option()

Updates the value of an option that was already added.

Used By

Used By Description
wp-includes/rest-api/endpoints/class-wp-rest-sidebars-controller.php: WP_REST_Sidebars_Controller::update_item()

Updates a sidebar.
wp-includes/widgets.php: wp_assign_widget_to_sidebar()

Assigns a widget to the given sidebar.
wp-admin/includes/ajax-actions.php: wp_ajax_delete_inactive_widgets()

Ajax handler for removing inactive widgets.
wp-admin/includes/ajax-actions.php: wp_ajax_save_widget()

Ajax handler for saving a widget.
wp-admin/includes/ajax-actions.php: wp_ajax_widgets_order()

Ajax handler for saving the widgets order.
wp-includes/widgets.php: retrieve_widgets()

Look for “lost” widgets, this has to run at least on each theme change.

Changelog

Version Description
2.2.0 Introduced.

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