Docs: Document the $wp_registered_sidebars global in wp_map_sidebars_widgets().

SergeyBiryukov · SergeyBiryukov · commit f759a365a6e3 · 2023-12-31T13:32:50.000Z
Follow-up to [41555]. Props shailu25. See #60021. git-svn-id: https://develop.svn.wordpress.org/trunk@57234 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-includes/widgets.php b/src/wp-includes/widgets.php
@@ -1370,6 +1370,8 @@ function retrieve_widgets( $theme_changed = false ) {
  * @since 4.9.0
  * @since 4.9.2 Always tries to restore widget assignments from previous data, not just if sidebars needed mapping.
  *
+ * @global array $wp_registered_sidebars The registered sidebars.
+ *
  * @param array $existing_sidebars_widgets List of sidebars and their widget instance IDs.
  * @return array Mapped sidebars widgets.
  */

Original file line number	Diff line number	Diff line change
`@@ -1370,6 +1370,8 @@ function retrieve_widgets( $theme_changed = false ) {`
`1370`	`1370`	`* @since 4.9.0`
`1371`	`1371`	`* @since 4.9.2 Always tries to restore widget assignments from previous data, not just if sidebars needed mapping.`
`1372`	`1372`	`*`
	`1373`	`+ * @global array $wp_registered_sidebars The registered sidebars.`
	`1374`	`+ *`
`1373`	`1375`	`* @param array $existing_sidebars_widgets List of sidebars and their widget instance IDs.`
`1374`	`1376`	`* @return array Mapped sidebars widgets.`
`1375`	`1377`	`*/`