Changeset 51705 for trunk/src/wp-admin/includes/upgrade.php

Timestamp:

08/31/2021 07:57:20 PM (3 years ago)

Author:

hellofromTonya

Message:

Widgets: Rename and soft deprecate retrieve_widgets().

The original name retrieve_widgets() was unclear as it suggested it was a getter, i.e. getting the widgets. This function does more than get: finds orphaned widgets, assigns them to the inactive sidebar, and updates the database.

The new name is sync_registered_widgets() which better represents what happens when this function is invoked.

The original retrieve_widgets() function is soft deprecated to avoid unnecessary code churn downstream for developers that support more than the latest version of WordPress.

Follow-up to [18630].

Props zieladam, timothyblynjacobs, andraganescu, hellofromTonya.
See #53811.

File:

• trunk/src/wp-admin/includes/upgrade.php (modified) (1 diff)

trunk/src/wp-admin/includes/upgrade.php

@@ -1774 +1774 @@
             // Intentional fall-through to upgrade to the next version.
         case 2:
-            $sidebars_widgets                  = retrieve_widgets();
+            $sidebars_widgets                  = sync_registered_widgets();
             $sidebars_widgets['array_version'] = 3;
             update_option( 'sidebars_widgets', $sidebars_widgets );