get_parent_theme_file_path()
Отримує повний шлях від кореня сайту до поточної теми (батьківської, не дочірньої). Не містить слеш на кінці.
Якщо передати ім’я файлу (аргумент $file
), то поверне шлях до файлу батьківської теми. Чи не перевіряє його наявність.
Це майже копія функції get_template_directory() , тільки можна передати ім’я файлу теми, щоб одразу отримати шлях до нього. Якщо не вказати ім’я файлу, обидві ці функції однакові.
Аналогічна функція get_theme_file_uri() , тільки повертає шлях до файлу, а не URL і не враховує дочірню тему.
Використовуйте get_theme_file_path() , коли потрібно враховувати дочірню тему.
Працює на основі:
get_template_directory()
get_template_directory()
1 раз – 0.002969 сек
(дуже повільно) | 50000 разів – 2.55 сек
(швидко) |
PHP 7.1.5, WP 4.9.4
(дуже повільно) | 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.0.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 до файлу в parent theme. * * @ Since 4.7.0 * * @param string $path file path. * @param string $file Потрібен файл для пошуку. */ return apply_filters( 'parent_theme_file_path', $path, $file); }