# in_widget_form

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

Тип: хук-действие.
Появился в версии: 2.8.0.

## Сигнатура

```php
do_action_ref_array( 'in_widget_form', WP_Widget $widget, null|string $return, array $instance )
```

## Описание

Используйте этот хук, чтобы добавить в форму виджета дополнительные поля. Хук срабатывает только в том случае, если значение, переданное в хук ‘widget_form_callback’, не равно false.
Примечание: если у виджета нет формы, текст, выводимый методом формы по умолчанию, можно скрыть с помощью CSS.

## Параметры

- `$widget` `WP_Widget` — обязательный. Экземпляр виджета (передаётся по ссылке).
- `$return` `null|string` — обязательный. Значение по умолчанию: 'noform'. Верните null, если добавляются новые поля.
- `$instance` `array` — обязательный. Массив настроек виджета.

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

Файл: `wp-includes/class-wp-widget.php:553`

```php
do_action_ref_array( 'in_widget_form', array( &$this, &$return, $instance ) );
```

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

- 2.8.0 — Introduced.

## Связанные

Используется в: `WP_REST_Widget_Types_Controller::get_widget_form`, `WP_Widget::form`, `WP_Widget::form_callback`.

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