retrieve_widgets( string|bool $theme_changed = false ): array

1325function retrieve_widgets( $theme_changed = false ) {1326	global $wp_registered_sidebars, $sidebars_widgets, $wp_registered_widgets;1327 1328	$registered_sidebars_keys = array_keys( $wp_registered_sidebars );1329	$registered_widgets_ids   = array_keys( $wp_registered_widgets );1330 1331	if ( ! is_array( get_theme_mod( 'sidebars_widgets' ) ) ) {1332		if ( empty( $sidebars_widgets ) ) {1333			return array();1334		}1335 1336		unset( $sidebars_widgets['array_version'] );1337 1338		$sidebars_widgets_keys = array_keys( $sidebars_widgets );1339		sort( $sidebars_widgets_keys );1340		sort( $registered_sidebars_keys );1341 1342		if ( $sidebars_widgets_keys === $registered_sidebars_keys ) {1343			$sidebars_widgets = _wp_remove_unregistered_widgets( $sidebars_widgets, $registered_widgets_ids );1344 1345			return $sidebars_widgets;1346		}1347	}1348 1349	// Discard invalid, theme-specific widgets from sidebars.1350	$sidebars_widgets = _wp_remove_unregistered_widgets( $sidebars_widgets, $registered_widgets_ids );1351	$sidebars_widgets = wp_map_sidebars_widgets( $sidebars_widgets );1352 1353	// Replace non-array values inside the array with an empty array.1354	foreach ( $sidebars_widgets as $key => $value ) {1355		if ( ! is_array( $value ) ) {1356			$sidebars_widgets[ $key ] = array();1357		}1358	}1359 1360	// Find hidden/lost multi-widget instances.1361	$shown_widgets = array_merge( ...array_values( $sidebars_widgets ) );1362	$lost_widgets  = array_diff( $registered_widgets_ids, $shown_widgets );1363 1364	foreach ( $lost_widgets as $key => $widget_id ) {1365		$number = preg_replace( '/.+?-([0-9]+)$/', '$1', $widget_id );1366 1367		// Only keep active and default widgets.1368		if ( is_numeric( $number ) && (int) $number < 2 ) {1369			unset( $lost_widgets[ $key ] );1370		}1371	}1372	$sidebars_widgets['wp_inactive_widgets'] = array_merge( $lost_widgets, (array) $sidebars_widgets['wp_inactive_widgets'] );1373 1374	if ( 'customize' !== $theme_changed ) {1375		// Update the widgets settings in the database.1376		wp_set_sidebars_widgets( $sidebars_widgets );1377	}1378 1379	return $sidebars_widgets;1380}