# wp_list_widget_controls()

URL: https://chugunov.pro/api-wordpress/functions/wp_list_widget_controls/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.5.0.

## Сигнатура

```php
wp_list_widget_controls( string $sidebar, string $sidebar_name = '' )
```

## Описание

Используется на экране настройки виджетов в административной части сайта.

## Параметры

- `$sidebar` `string` — обязательный. ID боковой панели.
- `$sidebar_name` `string` — необязательный, по умолчанию `''`. Имя боковой панели.

## Исходный код

Файл: `wp-admin/includes/widgets.php:87`

```php
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>';
}
```

## История изменений

- 2.5.0 — Introduced.

## Связанные

Использует: [`dynamic_sidebar`](https://chugunov.pro/api-wordpress/functions/dynamic_sidebar/), [`wp_sidebar_description`](https://chugunov.pro/api-wordpress/functions/wp_sidebar_description/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`esc_html`](https://chugunov.pro/api-wordpress/functions/esc_html/), [`add_filter`](https://chugunov.pro/api-wordpress/functions/add_filter/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_list_widget_controls/