wp_find_widgets_sidebar( string $widget_id ): string|null

Parameters

$widget_idstring

The widget ID to look for.

Return

string|null

The found sidebar's ID, or null if it was not found.

Uses · 1

• wp_get_sidebars_widgets()Retrieves the full list of sidebars and their widget instance IDs.

Used by · 5

• WP_REST_Widgets_Controller::delete_item()Deletes a widget.
• WP_REST_Widgets_Controller::get_item()Gets an individual widget.
• WP_REST_Widgets_Controller::get_item_permissions_check()Checks if a given request has access to get a widget.
• WP_REST_Widgets_Controller::update_item()Updates an existing widget.
• render_block_core_legacy_widget()Renders the 'core/legacy-widget' block.

Source

View on Trac ↗View on GitHub ↗

1954function wp_find_widgets_sidebar( $widget_id ) {1955	foreach ( wp_get_sidebars_widgets() as $sidebar_id => $widget_ids ) {1956		foreach ( $widget_ids as $maybe_widget_id ) {1957			if ( $maybe_widget_id === $widget_id ) {1958				return (string) $sidebar_id;1959			}1960		}1961	}1962 1963	return null;1964}

History

Introduced in 5.8.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/widgets.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.