in_widget_form — action WordPress: параметры и описание

Сигнатура

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

Описание

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

Оригинал (английский)

Use this hook to add extra fields to the widget form. The hook is only fired if the value passed to the ‘widget_form_callback’ hook is not false.

Note: If the widget has no form, the text echoed from the default form method can be hidden using CSS.

Параметры

$widget WP_Widget обязательный

Экземпляр виджета (передаётся по ссылке).

$return null|string обязательный

Значение по умолчанию: 'noform'. Верните null, если добавляются новые поля.

$instance array обязательный

Массив настроек виджета.

Исходный код

wp-includes/class-wp-widget.php:553

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

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

Версия	Описание
2.8.0	Introduced.