wp_list_widget_controls

The timeline below displays how wordpress function wp_list_widget_controls has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.3

/**
 * Show the widgets and their settings for a sidebar.
 * Used in the admin widget config screen.
 *
 * @since 2.5.0
 *
 * @param string $sidebar      Sidebar ID.
 * @param string $sidebar_name Optional. Sidebar name. Default empty.
 */
function wp_list_widget_controls($sidebar, $sidebar_name = '')
{
    add_filter('dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar');
    $description = wp_sidebar_description($sidebar);
    echo '<div id="' . esc_attr($sidebar) . '" class="widgets-sortables">';
    if ($sidebar_name) {
        $add_to = sprintf(
            /* translators: %s: Widgets sidebar name. */
            __('Add to: %s'),
            $sidebar_name
        );
        ?>
		<div class="sidebar-name" data-add-to="<?php 
        echo esc_attr($add_to);
        ?>">
			<button type="button" class="handlediv hide-if-no-js" aria-expanded="true">
				<span class="screen-reader-text"><?php 
        echo esc_html($sidebar_name);
        ?></span>
				<span class="toggle-indicator" aria-hidden="true"></span>
			</button>
			<h2><?php 
        echo esc_html($sidebar_name);
        ?> <span class="spinner"></span></h2>
		</div>
		<?php 
    }
    if (!empty($description)) {
        ?>
		<div class="sidebar-description">
			<p class="description"><?php 
        echo $description;
        ?></p>
		</div>
		<?php 
    }
    dynamic_sidebar($sidebar);
    echo '</div>';
}

WordPress Version: 5.1

/**
 * Show the widgets and their settings for a sidebar.
 * Used in the admin widget config screen.
 *
 * @since 2.5.0
 *
 * @param string $sidebar      Sidebar ID.
 * @param string $sidebar_name Optional. Sidebar name. Default empty.
 */
function wp_list_widget_controls($sidebar, $sidebar_name = '')
{
    add_filter('dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar');
    $description = wp_sidebar_description($sidebar);
    echo '<div id="' . esc_attr($sidebar) . '" class="widgets-sortables">';
    if ($sidebar_name) {
        $add_to = sprintf(
            /* translators: %s: widgets sidebar name. */
            __('Add to: %s'),
            $sidebar_name
        );
        ?>
		<div class="sidebar-name" data-add-to="<?php 
        echo esc_attr($add_to);
        ?>">
			<button type="button" class="handlediv hide-if-no-js" aria-expanded="true">
				<span class="screen-reader-text"><?php 
        echo esc_html($sidebar_name);
        ?></span>
				<span class="toggle-indicator" aria-hidden="true"></span>
			</button>
			<h2><?php 
        echo esc_html($sidebar_name);
        ?> <span class="spinner"></span></h2>
		</div>
		<?php 
    }
    if (!empty($description)) {
        ?>
		<div class="sidebar-description">
			<p class="description"><?php 
        echo $description;
        ?></p>
		</div>
		<?php 
    }
    dynamic_sidebar($sidebar);
    echo '</div>';
}

WordPress Version: 4.9

/**
 * Show the widgets and their settings for a sidebar.
 * Used in the admin widget config screen.
 *
 * @since 2.5.0
 *
 * @param string $sidebar      Sidebar ID.
 * @param string $sidebar_name Optional. Sidebar name. Default empty.
 */
function wp_list_widget_controls($sidebar, $sidebar_name = '')
{
    add_filter('dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar');
    $description = wp_sidebar_description($sidebar);
    echo '<div id="' . esc_attr($sidebar) . '" class="widgets-sortables">';
    if ($sidebar_name) {
        ?>
		<div class="sidebar-name">
			<button type="button" class="handlediv hide-if-no-js" aria-expanded="true">
				<span class="screen-reader-text"><?php 
        echo esc_html($sidebar_name);
        ?></span>
				<span class="toggle-indicator" aria-hidden="true"></span>
			</button>
			<h2><?php 
        echo esc_html($sidebar_name);
        ?> <span class="spinner"></span></h2>
		</div>
		<?php 
    }
    if (!empty($description)) {
        ?>
		<div class="sidebar-description">
			<p class="description"><?php 
        echo $description;
        ?></p>
		</div>
		<?php 
    }
    dynamic_sidebar($sidebar);
    echo '</div>';
}

WordPress Version: 4.4

/**
 * Show the widgets and their settings for a sidebar.
 * Used in the admin widget config screen.
 *
 * @since 2.5.0
 *
 * @param string $sidebar      Sidebar ID.
 * @param string $sidebar_name Optional. Sidebar name. Default empty.
 */
function wp_list_widget_controls($sidebar, $sidebar_name = '')
{
    add_filter('dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar');
    $description = wp_sidebar_description($sidebar);
    echo '<div id="' . esc_attr($sidebar) . '" class="widgets-sortables">';
    if ($sidebar_name) {
        ?>
		<div class="sidebar-name">
			<div class="sidebar-name-arrow"><br /></div>
			<h2><?php 
        echo esc_html($sidebar_name);
        ?> <span class="spinner"></span></h2>
		</div>
		<?php 
    }
    if (!empty($description)) {
        ?>
		<div class="sidebar-description">
			<p class="description"><?php 
        echo $description;
        ?></p>
		</div>
		<?php 
    }
    dynamic_sidebar($sidebar);
    echo '</div>';
}

WordPress Version: 3.8

/**
 * Show the widgets and their settings for a sidebar.
 * Used in the admin widget config screen.
 *
 * @since 2.5.0
 *
 * @param string $sidebar id slug of the sidebar
 * @param string optional $sidebar_name Include the HTML for the sidebar name
 */
function wp_list_widget_controls($sidebar, $sidebar_name = '')
{
    add_filter('dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar');
    $description = wp_sidebar_description($sidebar);
    echo '<div id="' . esc_attr($sidebar) . '" class="widgets-sortables">';
    if ($sidebar_name) {
        ?>
		<div class="sidebar-name">
			<div class="sidebar-name-arrow"><br /></div>
			<h3><?php 
        echo esc_html($sidebar_name);
        ?> <span class="spinner"></span></h3>
		</div>
		<?php 
    }
    echo '<div class="sidebar-description">';
    if (!empty($description)) {
        echo '<p class="description">' . $description . '</p>';
    }
    echo '</div>';
    dynamic_sidebar($sidebar);
    echo '</div>';
}

WordPress Version: 3.7

/**
 * Show the widgets and their settings for a sidebar.
 * Used in the admin widget config screen.
 *
 * @since 2.5.0
 *
 * @param string $sidebar id slug of the sidebar
 */
function wp_list_widget_controls($sidebar)
{
    add_filter('dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar');
    echo "<div id='{$sidebar}' class='widgets-sortables'>\n";
    $description = wp_sidebar_description($sidebar);
    if (!empty($description)) {
        echo "<div class='sidebar-description'>\n";
        echo "\t<p class='description'>{$description}</p>";
        echo "</div>\n";
    }
    dynamic_sidebar($sidebar);
    echo "</div>\n";
}