Описание функции register_setting()
Функция register_setting() регистрирует настройку для использования в административной панели WordPress. Она позволяет сохранить значения настроек в базе данных и обеспечивает безопасный доступ к ним. Функция часто используется в контексте создания плагинов и тем, которые добавляют собственные настройки.
Настройки могут быть доступны через функции get_option() и update_option() после регистрации.
Параметры
$option_group
Тип: string
Обязательный: Да
Описание: Имя группы опций, к которой принадлежит настройка
Возможные значения:
$option_name
Тип: string
Обязательный: Да
Описание: Имя конкретной настройки
Возможные значения:
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив дополнительных аргументов для настройки
Возможные значения:
type: string
sanitize_callback: Имя функции для очистки данных перед сохранением
default: null
Возвращаемое значение
Тип: void
Описание: Функция не возвращает значения
Возможные значения:
Примеры использования
Регистрация настройки ‘my_setting’ в группе ‘my_plugin_options’
register_setting('my_plugin_options', 'my_setting');
Теперь ‘my_setting’ можно использовать в админке
Регистрация настройки с функцией очистки данных
register_setting('my_plugin_options', 'my_setting', array('sanitize_callback' => 'sanitize_text_field'));
Будет использовать sanitize_text_field для очистки значения перед сохранением
Безопасность
Валидация входных данных: Функция требует, чтобы имена групп и настроек были строками
Санитизация: Входные данные могут быть очищены с помощью sanitize_callback
Рекомендации: Используйте sanitize_callback для безопасного хранения данных
— Связанные функции
Получает значение зарегистрированной настройки
Обновляет значение настройки в базе данных
— Примечания
– Ограничения
Необходимо регистрировать настройки перед их использованием в админке
– Частые проблемы
- Ошибка при получении значения, если настройка не была зарегистрирована
- Конфликт имен настроек между плагинами
