Описание in_widget_form
— Action
Хук in_widget_form позволяет добавлять или изменять элементы формы виджетов в WordPress. Он срабатывает, когда отображается форма настройки виджета в админке, что позволяет разработчикам настраивать поведение и внешний вид виджетов
Примеры использования
Пример добавления нового текстового поля в форму виджета:
add_action('in_widget_form', function($widget) {
echo '<p><label for="my_custom_field">Мой кастомный параметр:</label>
<input class="widefat" id="my_custom_field" name="my_custom_field" type="text" value="' . esc_attr($widget->get_settings('my_custom_field')) . '" /></p>';
});
В этом примере мы добавляем новое текстовое поле в форму виджета
Пример добавления чекбокса в форму виджета:
add_action('in_widget_form', function($widget) {
$checked = !empty($widget->get_settings('my_checkbox')) ? 'checked' : '';
echo '<p><input type="checkbox" id="my_checkbox" name="my_checkbox" value="1" ' . $checked . ' /> <label for="my_checkbox">Активировать опцию</label></p>';
});
Здесь мы добавляем чекбокс, который будет сохранять свое состояние
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить или дополнить форму настройки виджета в админке
– Производительность
Хук не должен существенно влиять на производительность, однако стоит избегать избыточного кода
– Предупреждения
Следите за тем, чтобы изменения не нарушали стандартный интерфейс WordPress и были понятны пользователю
Альтернативы
Тип: filter
Этот фильтр позволяет изменять данные, которые сохраняются при обновлении виджета
Используйте его, если нужно обработать данные виджета перед их сохранением
