Функция get_template() возвращает название каталога текущей активной темы. Если на сайте активирована дочерняя тема, функция вернёт название родительской темы. Это полезно, когда нужно получить информацию о шаблоне, на котором основана дочерняя тема.
Для получения названия дочерней темы (если таковая используется), нужно применять функцию get_stylesheet().
get_template(): stringВозвращаемое значение
- Строка — Название каталога текущей активной родительской темы.
Особенности
- Если активирована дочерняя тема,
get_template()вернёт каталог родительской темы. - Для получения каталога дочерней темы используйте функцию
get_stylesheet().
Примечания
- Эта функция является обёрткой для опции
get_option( 'template' ). - Используется для работы с родительскими темами, когда важно отличать родительскую и дочернюю темы.
1. Вывод названия каталога родительской темы
Простой пример использования функции get_template(). Допустим, ваша активная родительская тема находится в каталоге ale. Функция выведет именно это имя:
echo esc_html( get_template() );
// Результат: ale2. Проверка родительской и дочерней тем
Этот пример проверяет, используется ли дочерняя тема, и выводит название как родительской, так и дочерней тем:
if ( get_stylesheet() !== get_template() ) {
echo 'Родительская тема: ' . get_template() . '<br>';
echo 'Дочерняя тема: ' . get_stylesheet();
} else {
echo 'Активирована только родительская тема: ' . get_template();
}
Здесь get_template() возвращает название родительской темы, а get_stylesheet() — дочерней.
3. Использование для подключения файлов из родительской темы
Если нужно подключить файл из директории родительской темы, вы можете использовать эту функцию для получения её пути:
$parent_template_dir = get_template_directory() . '/custom-template.php';
if ( file_exists( $parent_template_dir ) ) {
include( $parent_template_dir );
}Этот код проверяет наличие файла в директории родительской темы и включает его в шаблон.
Связанные функции
get_stylesheet()— Возвращает название каталога активной темы (дочерней или родительской).get_template_directory()— Возвращает полный путь до директории родительской темы.get_template_directory_uri()— Возвращает URL до директории родительской темы.
Заключение
Функция get_template() полезна для получения данных о родительской теме. Она широко используется в темах и плагинах, особенно при работе с дочерними темами, когда требуется доступ к родительскому шаблону.