get_theme_file_path()
Отримує шлях до вказаного файлу теми. Враховує дочірні теми.
Функція намагається знайти вказаний файл спочатку у дочірній темі, якщо його там немає, то отримує шлях до файлу з основної теми.
Функція створена для того, щоб повсюдно використовуватися при створенні тим, щоб усі шляхи в темі підтримували дочірні теми.
З появою цієї функції не потрібно писати вручну перевірки з використанням get_template_directory() .
Використовуйте get_parent_theme_file_path() , коли НЕ потрібно враховувати дочірню тему.
Використовуйте get_theme_file_uri() , коли потрібно отримати URL-файл, а не його шлях.
(дуже швидко) | 50000 разів – 0.55 сек
(дуже швидко) |
PHP 7.1.2, WP 4.7.3
Хуки з функції
Повертає
Строку. Дорога до файлу з урахуванням дочірньої теми.
Використання
get_theme_file_path($file);
-
$file
(рядок) Назва файлу, який потрібно знайти в темі. Наприклад
file.php. Можна вказати вкладений файлinc/file.phpабо так/inc/file.php.Якщо залишити рядок порожнім, то поверне шлях активної теми. get_stylesheet_directory ()
За замовчуванням: ”
Приклади
#1 Демо
echo get_theme_file_path( 'myfile.php'); /* В результаті отримаємо шлях до одного із файлів: /home/site/www/wp-content/themes/wpkama-child/myfile.php або /home/site/www/wp-content/themes/wpkama/myfile.php */
#2 Підключимо файл теми з огляду на дочірню тему.
require_once( get_theme_file_path( 'myfile.php' ) );
В результаті функція перевірить, чи файл myfile.php в дочірній темі, якщо його немає, то підключить його з основної теми.
#3 Підключення файлу з каталогу темиinc
include get_theme_file_path('/inc/template.php');
список змін
| З версії 4.7.0 | Введено. |
Код get_theme_file_path() get theme file path WP 6.0.2
function get_theme_file_path( $file = '' ) {
$file = ltrim($file, '/');
if (empty($file)) {
$ path = get_stylesheet_directory();
} elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
$ path = get_stylesheet_directory() . '/'. $ file;
} else {
$ path = get_template_directory() . '/'. $ file;
}
/**
* Filters the path до файлу в theme.
*
* @ Since 4.7.0
*
* @param string $path file path.
* @param string $file Потрібен файл для пошуку.
*/
return apply_filters( 'theme_file_path', $ path, $ file );
}