get_parent_theme_file_uri() │ WP 4.7.0

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

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

Используйте get_theme_file_uri(), когда нужно учитывать дочернюю тему.

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

Работает на основе: get_template_directory_uri()
Хуки из функции

Возвращает

Строку. The URL of the file.

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

get_parent_theme_file_uri( $file );
$file(строка)

Название файла, который нужно найти в родительской теме. Например file.js. Можно указать вложенный файл js/file.php или /js/file.js.

Если оставить строку пустой, то вернет URL родительской темы. См. get_template_directory_uri()

По умолчанию: ''

Примеры

0

#1 Получим URL файла родительской темы из дочерней темы

Допустим нам нужно подключить файл js/my-script.js из родительской темы. Но код вызывается в дочерней теме.

wp_enqueue_script( 'my-script', get_parent_theme_file_uri( 'js/my-script.js' ) );

Список изменений

С версии 4.7.0 Введена.

Код get_parent_theme_file_uri() WP 6.7.1

wp-includes/link-template.php 
function get_parent_theme_file_uri( $file = '' ) {
	$file = ltrim( $file, '/' );

	if ( empty( $file ) ) {
		$url = get_template_directory_uri();
	} else {
		$url = get_template_directory_uri() . '/' . $file;
	}

	/**
	 * Filters the URL to a file in the parent theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $url  The file URL.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( 'parent_theme_file_uri', $url, $file );
}

theme path url (папка темы)

Подключение файлов темы