load_template

Подключает указанный файл в PHP, с помощью require_once. WordPress-обёртка для PHP функции require_once.

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

Хуков нет.

Возвращает

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

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

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

Примеры

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

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *