get_parent_theme_file_path() WP 4.7.0

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

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

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

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

Возвращает

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

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

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 ^{WP 5.3.2}

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

Cвязанные функции

Из метки: theme path url (папка темы)

Еще из метки: path directory (путь папка)

Еще из раздела: Подключение файлов темы