Функция get_stylesheet() возвращает название каталога (папки) текущей активной темы. Если используется дочерняя тема, она вернёт именно её каталог. Эта функция полезна для получения данных о теме, которая отображает контент на фронтенде.
Для большинства сайтов название каталога темы совпадает с названием шаблона, но в случае использования дочерних тем, шаблон может быть родительским, а стиль — дочерним.
get_stylesheet(): stringВозвращаемое значение
- Строка — Название каталога активной темы.
Примечания
- Если используется дочерняя тема,
get_stylesheet()вернёт название папки дочерней темы. - Для получения каталога родительской темы можно использовать функцию
get_template().
1. Получение имени папки активной темы
Этот пример показывает, как можно вывести название папки текущей активной темы. Например, если ваша тема находится в папке twentytwentytwo, то функция вернёт именно это название:
echo get_stylesheet();
// Результат: twentytwentyfour2. Проверка на дочернюю тему
Можно использовать эту функцию для проверки, активирована ли дочерняя тема, и в зависимости от этого предпринимать действия:
if ( get_stylesheet() !== get_template() ) {
echo 'Дочерняя тема активирована: ' . get_stylesheet();
} else {
echo 'Активирована родительская тема: ' . get_template();
}
В этом примере выводится название активной темы и проверяется, используется ли дочерняя тема или родительская.
3. Использование с URL активной темы
Вместе с функцией get_stylesheet_directory_uri() можно получить URL директории активной темы для правильного подключения ресурсов:
$stylesheet_uri = get_stylesheet_directory_uri() . '/style.css';
echo '<link rel="stylesheet" href="' . $stylesheet_uri . '">';
Этот код динамически подключает основной файл стилей активной темы.
Связанные функции
get_template()— Получает каталог родительской темы.get_stylesheet_directory()— Возвращает полный серверный путь до директории текущей темы.get_stylesheet_directory_uri()— Возвращает URL до директории текущей темы.
Заключение
Функция get_stylesheet() — удобный инструмент для получения данных о текущей активной теме, особенно в случаях с дочерними темами.