Описание функции set_theme_mod()
Функция set_theme_mod() используется для установки или обновления значения настройки темы в базе данных. Она позволяет разработчикам тем сохранять пользовательские настройки, такие как цветовые схемы, логотипы и другие параметры. Эти настройки могут быть затем извлечены с помощью функции get_theme_mod().
Функция позволяет интегрировать пользовательские настройки в тему, улучшая пользовательский опыт.
Параметры
$name
Тип: string
Обязательный: Да
Описание: Ключ настройки темы
Возможные значения:
$value
Тип: mixed
Обязательный: Да
Описание: Значение настройки, которое нужно сохранить
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешной установке значения, иначе false
Возможные значения:
• true — значение успешно установлено
• false — ошибка при установке значения
Примеры использования
Базовый пример установки цвета фона заголовка
$result = set_theme_mod('header_background_color', '#ffffff');
// Проверяем результат
if ($result) {
echo 'Настройка успешно обновлена';
} else {
echo 'Ошибка обновления настройки';
}
Настройка успешно обновлена
Пример установки массива пользовательских опций
$result = set_theme_mod('custom_options', array('option1' => true, 'option2' => false));
// Проверяем результат
if ($result) {
echo 'Настройка успешно обновлена';
} else {
echo 'Ошибка обновления настройки';
}
Настройка успешно обновлена
Безопасность
Валидация входных данных: Функция выполняет базовую проверку входных данных
Санитизация: Рекомендуется использовать sanitize_text_field() для строк
Рекомендации: Перед передачей значений в функцию, обязательно очищайте их
— Связанные функции
Получает значение настройки темы по ключу
Удаляет настройку темы по ключу
— Хуки
Фильтрует массив настроек перед сохранением
— Примечания
– Ограничения
Не поддерживает хранение сложных объектов без сериализации
– Частые проблемы
- Ошибка при попытке установить значение с пустым ключом
- Необходимость очищать данные перед сохранением для предотвращения уязвимостей
