get_parent_theme_file_path()
Получает системный путь до родительской темы (не дочерней). Не содержит слэш на конце.
Если указать параметр $file
(имя файла), то получит путь к этому файлу в родительской теме. Не проверяет его наличие.
Это обертка для функции get_template_directory(), которая позволяет указать путь к файлу внутри темы, а также запустит хук parent_theme_file_path, который может быть полезен для публичных тем.
Используйте get_theme_file_path(), когда нужно учитывать дочернюю тему.
Используйте get_theme_file_uri(), когда нужно получить УРЛ и учитывать дочернюю тему.
Работает на основе: 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.8.1
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 ); }