# register_widget_control()

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

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

> Устаревший элемент. Помечен устаревшим с версии 2.8.0.

## Сигнатура

```php
register_widget_control( int|string $name, callable $control_callback, int $width = '', int $height = '', mixed $params )
```

## Описание

Позволяет $name быть массивом, который принимает либо три элемента — тогда для имени берутся первый и третий элементы, — либо использует для имени только первый элемент массива.
Передаёт управление в wp_register_widget_control() после того, как список аргументов сформирован.
См. alsowp_register_widget_control()

## Параметры

- `$name` `int|string` — обязательный. ID боковой панели.
- `$control_callback` `callable` — обязательный. Функция обратного вызова для управления виджетом, отображающая и обрабатывающая форму.
- `$width` `int` — необязательный, по умолчанию `''`. Ширина виджета.
- `$height` `int` — необязательный, по умолчанию `''`. Высота виджета.
- `$params` `mixed` — обязательный. Параметры виджета.

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

Файл: `wp-includes/deprecated.php:2181`

```php
function register_widget_control($name, $control_callback, $width = '', $height = '', ...$params) {
	_deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_widget_control()' );
	// Compat.
	if ( is_array( $name ) ) {
		if ( count( $name ) === 3 ) {
			$name = sprintf( $name[0], $name[2] );
		} else {
			$name = $name[0];
		}
	}

	$id      = sanitize_title( $name );
	$options = array();
	if ( ! empty( $width ) ) {
		$options['width'] = $width;
	}
	if ( ! empty( $height ) ) {
		$options['height'] = $height;
	}

	wp_register_widget_control( $id, $name, $control_callback, $options, ...$params );
}
```

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

- 2.8.0 — Deprecated. Use wp_register_widget_control()
- 2.2.0 — Introduced.

## Связанные

Использует: [`sanitize_title`](https://chugunov.pro/api-wordpress/functions/sanitize_title/), [`wp_register_widget_control`](https://chugunov.pro/api-wordpress/functions/wp_register_widget_control/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/).

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