get_parent_theme_file_path()
Получает полный путь от корня сайта до текущей темы (родительской, не дочерней). Не содержит слэш на конце.
Если передать имя файла (аргумент $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/example.com/public_html/wp-content/themes/theme_name
#2 Получим путь к файлу текущей темы
echo get_parent_theme_file_path('/js/custom.js'); //> /home/example.com/public_html/wp-content/themes/theme_name/js/custom.js
Список изменений
С версии 4.7.0 | Введена. |
Код get_parent_theme_file_path() get parent theme file path WP 6.4.3
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 ); }