Функция get_theme_root() возвращает абсолютный путь к каталогу тем WordPress. Этот путь не содержит завершающего слэша.
Основная цель функции — получить путь к каталогу тем, в котором хранятся установленные темы. Это полезно при работе с файлами и директориями тем, например, для автоматического поиска тем или проверки структуры каталогов.
get_theme_root( string $stylesheet_or_template = ” ): stringПараметры
- $stylesheet_or_template (строка) (опционально): Имя темы или шаблона, для которого нужно получить родительскую директорию. По умолчанию — пустая строка (
''), что указывает на использование основного корневого каталога тем.
Возвращаемое значение
- строка: Абсолютный путь к каталогу тем.
Пример возвращаемого пути
/home/example.com/public_html/wp-content/themes
Пример 1: Получение пути к каталогу тем
echo get_theme_root(); // Вывод: /home/user/public_html/wp-content/themes
echo get_theme_root('my-theme'); // Вывод: /home/user/public_html/wp-content/themesПример 2: Подсчёт количества подкаталогов в каталоге тем
Следующий пример иллюстрирует, как можно использовать функцию get_theme_root() для подсчёта количества подкаталогов (которые могут являться темами или другими директориями) в каталоге тем.
function display_themes_subdirs_count_info() {
// Получаем путь к каталогу тем
$theme_root = get_theme_root();
// Ищем все подкаталоги в каталоге тем
$files_array = glob("$theme_root/*", GLOB_ONLYDIR);
// Выводим количество подкаталогов
echo "В каталоге " . $theme_root . " содержится " . count($files_array) . " подкаталогов.";
}
Пример вывода:
В каталоге /home/user/public_html/wp-content/themes содержится 5 подкаталогов.Этот код полезен, если вам нужно узнать количество каталогов в папке тем, но учтите, что это количество не обязательно совпадает с количеством активных тем в WordPress, поскольку не все каталоги могут быть темами.
Заключение
Функция get_theme_root() в WordPress возвращает абсолютный путь к каталогу тем, что позволяет эффективно работать с файловой системой сайта. Она полезна для поиска тем, управления каталогами и получения информации о структуре директорий.