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 );
} 