Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-12-22 17:18:32 +01:00
Code Issues Projects Releases Wiki Activity

Update and enhance the docs for retrieve_widgets().

Browse Source 
Props zieladam, hellofromtonya.
Fixes #53811.
Built from https://develop.svn.wordpress.org/trunk@51842


git-svn-id: http://core.svn.wordpress.org/trunk@51447 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Andrew Ozz 2021-09-21 22:13:57 +00:00
parent 01ff7448d2
commit 25daf03a8e
2 changed files with 11 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
$wp_version = '5.9-alpha-51841';
$wp_version = '5.9-alpha-51842';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.

11
wp-includes/widgets.php
View File

@ -1255,7 +1255,15 @@ function _wp_sidebars_changed() {
}
/**
* Look for "lost" widgets, this has to run at least on each theme change.
* Validates and remaps any "orphaned" widgets to wp_inactive_sidgets sidebar, and saves the widget settings.
* This has to run at least on each theme change.
*
* For example, let's say theme A has a "footer" sidebar, and theme B doesn't have one.
* After switching from theme A to theme B, all the widgets previously assigned to the footer would be inaccessible.
* This function detects this scenario, and moves all the widgets previously assigned to the footer under wp_inactive_widgets.
*
* Despite the word "retrieve" in the name, this function actually updates the database and the global $sidebars_widgets.
* For that reason it should not be run from the front end unless the param value is 'customize' (to bypass the database write).
*
* @since 2.8.0
*
@ -1310,6 +1318,7 @@ function retrieve_widgets( $theme_changed = false ) {
$sidebars_widgets['wp_inactive_widgets'] = array_merge( $lost_widgets, (array) $sidebars_widgets['wp_inactive_widgets'] );
if ( 'customize' !== $theme_changed ) {
// Update the widgets settings in the database.
wp_set_sidebars_widgets( $sidebars_widgets );
}