WordPress как на ладони
Наставник Трепачёв Д.П., phphtml.net wordpress jino

load_template() WP 1.5.0

Подключает указанный файл в PHP, с помощью require_once.

Используется, чтобы быть уверенным, что среда WordPress уже установлена в момент подключения файла. Функция также устанавливает глобальные переменные: $posts, $post, $wp_did_header, $wp_query, $wp_rewrite, $wpdb, $wp_version, $wp, $id, $comment, $user_ID.

Используется в: locate_template().

Хуков нет.

Возвращает

Ничего не возвращает, а подключает файл в PHP.

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

load_template( $_template_file, $require_once );
$_template_file(cтрока) (обязательный)
Серверный путь до файла, который нужно подключить.
$require_once(логический)
true - будет подключать файл с помощью require_once, false - с помощью require.
По умолчанию: true

Примеры

#1 Подключение файла-шаблона в плагине, с возможностью его изменить в теме

Предположим мы создаем плагин и в нем нам нужно указать файл шаблона, который будет использоваться в теме. Логично, что для разных тем файл шаблона будет разный и нам нужно оставить возможность изменять файл шаблона из темы. Для этого мы подключим нужный там файл, только в том случае, если он не определен в теме:

if ( $overridden_template = locate_template('some-template.php') ) {
   // locate_template() вернет путь до файла, если дочер. или родит. тема имеет такой файл
   load_template( $overridden_template );
 } else {
   // если файл не найден в теме или доч. теме, загружаем файл из каталога 'templates' плагина
   load_template( dirname( __FILE__ ) . '/templates/some-template.php' );
 }

Код load template: wp-includes/template.php WP 4.8.1

<?php
function load_template( $_template_file, $require_once = true ) {
	global $posts, $post, $wp_did_header, $wp_query, $wp_rewrite, $wpdb, $wp_version, $wp, $id, $comment, $user_ID;

	if ( is_array( $wp_query->query_vars ) ) {
		extract( $wp_query->query_vars, EXTR_SKIP );
	}

	if ( isset( $s ) ) {
		$s = esc_attr( $s );
	}

	if ( $require_once ) {
		require_once( $_template_file );
	} else {
		require( $_template_file );
	}
}

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

Из метки: _template (функции шаблоны)

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

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

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

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