WP_Customize_Widgets::sanitize_sidebar_widgets_js_instance( array $widget_ids )

Strips out widget IDs for widgets which are no longer registered.

Description

One example where this might happen is when a plugin orphans a widget in a sidebar upon deactivation.

Parameters

$widget_ids

(array) (Required) List of widget IDs.

Return

(array) Parsed list of widget IDs.

Source

File: wp-includes/class-wp-customize-widgets.php

public function sanitize_sidebar_widgets_js_instance( $widget_ids ) {
		global $wp_registered_widgets;
		$widget_ids = array_values( array_intersect( $widget_ids, array_keys( $wp_registered_widgets ) ) );
		return $widget_ids;
	}

Changelog

Version Description
3.9.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_customize_widgets/sanitize_sidebar_widgets_js_instance