Widgets: Rename and soft deprecate `retrieve_widgets()`.

mirror of https://github.com/gosticks/wordpress-develop.git synced 2026-08-11 20:30:23 +00:00

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.

git-svn-id: https://develop.svn.wordpress.org/trunk@51705 602fd350-edb4-49c9-b593-d223f7449a82

This commit is contained in:

Tonya Mork

2021-08-31 19:57:20 +00:00

parent 1bbc5a4737

commit b7a495d337

8 changed files with 53 additions and 36 deletions

									
										src/wp-admin/widgets-form.php
									
		+1
		-1
	
												View File
												
				@@ -118,7 +118,7 @@ register_sidebar(

					)

				);

				retrieve_widgets();

				sync_registered_widgets();

				// We're saving a widget without JS.

				if ( isset( $_POST['savewidget'] ) || isset( $_POST['removewidget'] ) ) {

Widgets: Rename and soft deprecate retrieve_widgets().

Widgets: Rename and soft deprecate `retrieve_widgets()`.