Описание функции get_theme_mods()
Функция get_theme_mods() возвращает все настройки темы, которые были сохранены через функцию set_theme_mod(). Это позволяет разработчикам тем и плагинов легко получать доступ к пользовательским настройкам, заданным через кастомайзер. Используется в шаблонах и настройках тем для динамического отображения пользовательских данных.
Функция полезна для получения всех настроек сразу без необходимости запрашивать каждую настройку по отдельности.
Параметры
$none
Тип: none
Обязательный: Да
По умолчанию: нет
Описание: Функция не принимает параметров
Возможные значения:
Возвращаемое значение
Тип: array
Описание: Ассоциативный массив с настройками темы
Возможные значения:
• Ассоциативный массив с настройками при успешном выполнении
• Пустой массив, если настройки не найдены
Примеры использования
Базовый пример получения всех настроек темы
$theme_mods = get_theme_mods();
print_r($theme_mods);
Выведет массив всех настроек темы
Получение конкретной настройки (изображение заголовка) и вывод его
$theme_mods = get_theme_mods();
$header_image = $theme_mods['header_image'];
echo '<img data-lazyloaded="1" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" decoding="async" data-src="' . esc_url($header_image) . '" alt="Header Image">';
Проверяйте наличие настройки перед выводом
Безопасность
Валидация входных данных: Не требуется, так как функция не принимает параметры
Санитизация: Содержимое массива настроек должно быть очищено перед выводом
Рекомендации: Используйте функции для экранирования, такие как esc_html() и esc_url() при выводе значений
— Связанные функции
Сохраняет значение настройки темы
Получает значение конкретной настройки темы по ключу
— Примечания
– Ограничения
Возвращает только настройки, которые были сохранены через кастомайзер
– Частые проблемы
- Пустой массив, если настройки не были заданы
- Необходимо проверять наличие ключей перед использованием значений
