WordPress как на ладони
wordpress jino

get_theme_file_path() WP 4.7.0

Получает путь до указанного файла темы. Учитывает дочерние темы.

Функция пытается найти указанный файл сначала в дочерней теме, если его там нет, то получает путь до файла из основной темы.

Функция создана, для того, чтобы повсеместно использоваться при создании тем, чтобы все пути в теме поддерживали дочерние темы...

С появлением этой функции не нужно вручную писать проверки с использованием get_template_directory_uri() и get_template_directory().

Используйте get_theme_file_uri(), когда нужно получить URL файла а не его путь.

✈ 1 раз = 0.000051с = очень быстро | 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 Подключим файл темы учитывая дочернюю тему.

require_once( get_theme_file_path( 'myfile.php' ) );

В результате функция проверит если ли файл myfile.php в дочерней теме, если его нет, то подключит его из основной темы.

Код get theme file path: wp-includes/link-template.php WP 4.8.2

<?php
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 to a file in the theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $path The file path.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( 'theme_file_path', $path, $file );
}

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

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

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

get_theme_file_path Комментариев нет

Здравствуйте, !

Ваш комментарий