wp_map_sidebars_widgets( array $existing_sidebars_widgets ): array

1393function wp_map_sidebars_widgets( $existing_sidebars_widgets ) {1394	global $wp_registered_sidebars;1395 1396	$new_sidebars_widgets = array(1397		'wp_inactive_widgets' => array(),1398	);1399 1400	// Short-circuit if there are no sidebars to map.1401	if ( ! is_array( $existing_sidebars_widgets ) || empty( $existing_sidebars_widgets ) ) {1402		return $new_sidebars_widgets;1403	}1404 1405	foreach ( $existing_sidebars_widgets as $sidebar => $widgets ) {1406		if ( 'wp_inactive_widgets' === $sidebar || str_starts_with( $sidebar, 'orphaned_widgets' ) ) {1407			$new_sidebars_widgets['wp_inactive_widgets'] = array_merge( $new_sidebars_widgets['wp_inactive_widgets'], (array) $widgets );1408			unset( $existing_sidebars_widgets[ $sidebar ] );1409		}1410	}1411 1412	// If old and new theme have just one sidebar, map it and we're done.1413	if ( 1 === count( $existing_sidebars_widgets ) && 1 === count( $wp_registered_sidebars ) ) {1414		$new_sidebars_widgets[ key( $wp_registered_sidebars ) ] = array_pop( $existing_sidebars_widgets );1415 1416		return $new_sidebars_widgets;1417	}1418 1419	// Map locations with the same slug.1420	$existing_sidebars = array_keys( $existing_sidebars_widgets );1421 1422	foreach ( $wp_registered_sidebars as $sidebar => $name ) {1423		if ( in_array( $sidebar, $existing_sidebars, true ) ) {1424			$new_sidebars_widgets[ $sidebar ] = $existing_sidebars_widgets[ $sidebar ];1425			unset( $existing_sidebars_widgets[ $sidebar ] );1426		} elseif ( ! array_key_exists( $sidebar, $new_sidebars_widgets ) ) {1427			$new_sidebars_widgets[ $sidebar ] = array();1428		}1429	}1430 1431	// If there are more sidebars, try to map them.1432	if ( ! empty( $existing_sidebars_widgets ) ) {1433 1434		/*1435		 * If old and new theme both have sidebars that contain phrases1436		 * from within the same group, make an educated guess and map it.1437		 */1438		$common_slug_groups = array(1439			array( 'sidebar', 'primary', 'main', 'right' ),1440			array( 'second', 'left' ),1441			array( 'sidebar-2', 'footer', 'bottom' ),1442			array( 'header', 'top' ),1443		);1444 1445		// Go through each group...1446		foreach ( $common_slug_groups as $slug_group ) {1447 1448			// ...and see if any of these slugs...1449			foreach ( $slug_group as $slug ) {1450 1451				// ...and any of the new sidebars...1452				foreach ( $wp_registered_sidebars as $new_sidebar => $args ) {1453 1454					// ...actually match!1455					if ( false === stripos( $new_sidebar, $slug ) && false === stripos( $slug, $new_sidebar ) ) {1456						continue;1457					}1458 1459					// Then see if any of the existing sidebars...1460					foreach ( $existing_sidebars_widgets as $sidebar => $widgets ) {1461 1462						// ...and any slug in the same group...1463						foreach ( $slug_group as $slug ) {1464 1465							// ... have a match as well.1466							if ( false === stripos( $sidebar, $slug ) && false === stripos( $slug, $sidebar ) ) {1467								continue;1468							}1469 1470							// Make sure this sidebar wasn't mapped and removed previously.1471							if ( ! empty( $existing_sidebars_widgets[ $sidebar ] ) ) {1472