get_parent_theme_file_path() WP 4.7.0

Получает полный путь от корня сайта до текущей темы (родительской, не дочерней). Не содержит слэш на конце.

Если передать имя файла (аргумент $file), то вернет путь к файлу в родительской теме. Не проверяет его наличие.

Это почти копия функции get_template_directory(), только можно передать имя файла темы, чтобы сразу получить путь к нему. Если не указать имя файла, то обе эти функции одинаковые.

Аналогична функции get_theme_file_uri(), только возвращает путь до файла, а не URL и не учитывает дочернюю тему.

Работает на основе: get_template_directory()

✈ 1 раз = 0.002969с = очень медленно | 50000 раз = 2.55с = быстро PHP 7.1.5, WP 4.9.4

Хуки из функции:

parent_theme_file_path

Возвращает

Строку. Путь к файлу или путь к папке с родительской темой.

Использование

get_parent_theme_file_path( $file = '' );

$file(строка): Путь к файлу, относительно папки родительской темы. Необязательный.
По умолчанию: ''

Примеры

#1 Получим путь до папки текущей темы

Результат в данном примере точно такой же, как при использовании get_template_directory().

echo get_parent_theme_file_path();
//> /home/site.ru/public_html/wp-content/themes/theme_name

#2 Получим путь к файлу текущей темы

echo get_parent_theme_file_path('/js/custom.js');
//> /home/site.ru/public_html/wp-content/themes/theme_name/js/custom.js

Код get parent theme file path: `wp-includes/link-template.php` ^{VER 4.9.5}

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