Описание функции wp_get_theme()
Функция wp_get_theme() возвращает объект WP_Theme, содержащий информацию о текущей активной теме или указанной теме. Она используется для получения данных о теме, таких как название, версия, автор и другие метаданные.
Функция полезна для разработчиков тем и плагинов, которые хотят взаимодействовать с текущей темой.
Параметры
$theme
Тип: string
Обязательный: Нет
По умолчанию: null
Описание: Имя темы, для которой нужно получить информацию
Возможные значения:
0: Имя активной темы (например, ‘twentytwentyone’)
1: Имя неактивной темы (например, ‘twentytwenty’)
Возвращаемое значение
Тип: WP_Theme|false
Описание: Объект WP_Theme с информацией о теме или false в случае ошибки
Возможные значения:
• Объект WP_Theme при успешном выполнении
• false, если тема не найдена
Примеры использования
Базовый пример получения информации о текущей активной теме
$theme = wp_get_theme();
echo $theme->get('Name'); // Выводит название темы
Вывод названия активной темы
Получение версии неактивной темы ‘twentytwenty’
$theme = wp_get_theme('twentytwenty');
if ($theme) {
echo $theme->get('Version');
}
Проверяем, существует ли тема перед выводом версии
Безопасность
Валидация входных данных: Входные параметры проверяются на наличие существующих тем
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для названий тем
— Связанные функции
Получает метаданные темы из файла style.css
Проверяет, активна ли указанная тема
— Хуки
Фильтрует путь к каталогу тем перед его использованием
Фильтрует объект WP_Theme перед его возвращением
— Примечания
– Ограничения
Не возвращает информацию о темах, которые не установлены
– Частые проблемы
- false, если тема с указанным именем не найдена
- Ошибки при неправильном написании имени темы
