Описание функции settings_fields()
Функция settings_fields() создает необходимые скрытые поля для формы настроек WordPress. Она используется для обеспечения безопасности при отправке данных настроек и включает в себя nonce-проверку, необходимую для защиты от CSRF-атак.
Используется внутри форм настроек в админке WordPress.
Параметры
$option_group
Тип: string
Обязательный: Да
Описание: Группа настроек, к которой относится форма
Возможные значения:
Возвращаемое значение
Тип: void
Описание: Функция ничего не возвращает
Возможные значения:
Примеры использования
Базовый пример создания формы настроек для плагина
function my_plugin_settings_page() {
echo '<form method="post" action="options.php">';
settings_fields('my_plugin_options');
do_settings_sections('my_plugin');
submit_button();
echo '</form>';
}
Форма отправляет данные в группу ‘my_plugin_options’
Пример использования в функции настройки темы
function my_theme_settings() {
add_settings_section('my_theme_section', 'Настройки темы', null, 'my_theme');
add_settings_field('my_theme_field', 'Поле', 'my_theme_field_callback', 'my_theme', 'my_theme_section');
settings_fields('my_theme_options');
}
Не забудьте зарегистрировать настройки с помощью register_setting()
Безопасность
Валидация входных данных: Nonce-проверка для защиты от CSRF-атак
Санитизация: Данные автоматически обрабатываются при сохранении настроек
Рекомендации: Используйте функцию в каждой форме настроек для обеспечения безопасности
— Связанные функции
Регистрирует группу настроек для использования с settings_fields()
Выводит секции настроек
— Примечания
– Ограничения
Работает только в контексте админки WordPress
– Частые проблемы
- Отсутствие nonce-поля может привести к ошибкам безопасности
- Неправильное указание option_group может вызвать проблемы с сохранением настроек
