get_parent_theme_file_path() WP 4.7.0
Получает полный путь от корня сайта до текущей темы (родительской, не дочерней). Не содержит слэш на конце.
Если передать имя файла (аргумент $file
), то вернет путь к файлу в родительской теме. Не проверяет его наличие.
Это почти копия функции get_template_directory(), только можно передать имя файла темы, чтобы сразу получить путь к нему. Если не указать имя файла, то обе эти функции одинаковые.
Аналогична функции get_theme_file_uri(), только возвращает путь до файла, а не URL и не учитывает дочернюю тему.
Используйте get_theme_file_path(), когда нужно учитывать дочернюю тему.
Работает на основе: get_template_directory()
1 раз — 0.002969 сек (очень медленно) | 50000 раз — 2.55 сек (быстро) | PHP 7.1.5, WP 4.9.4
Хуки из функции
Возвращает
Строку. Путь к файлу или путь к папке с родительской темой.
Использование
get_parent_theme_file_path( $file = '' );
- $file(строка)
- Путь к файлу, относительно папки родительской темы. Необязательный.
По умолчанию: ''
Примеры
#1 Получим путь до папки текущей темы
Результат в данном примере точно такой же, как при использовании get_template_directory().
echo get_parent_theme_file_path(); //> /home/site.ru/public_html/wp-content/themes/theme_name
#2 Получим путь к файлу текущей темы
echo get_parent_theme_file_path('/js/custom.js'); //> /home/site.ru/public_html/wp-content/themes/theme_name/js/custom.js
Список изменений
С версии 4.7.0 | Введена. |
Код get_parent_theme_file_path() get parent theme file path WP 5.6.2
function get_parent_theme_file_path( $file = '' ) {
$file = ltrim( $file, '/' );
if ( empty( $file ) ) {
$path = get_template_directory();
} else {
$path = get_template_directory() . '/' . $file;
}
/**
* Filters the path to a file in the parent theme.
*
* @since 4.7.0
*
* @param string $path The file path.
* @param string $file The requested file to search for.
*/
return apply_filters( 'parent_theme_file_path', $path, $file );
}