load_template()
Подключает указанный файл в PHP, с помощью require_once.
Используется, чтобы быть уверенным, что среда WordPress уже установлена в момент подключения файла. Функция также устанавливает глобальные переменные: $posts, $post, $wp_did_header, $wp_query, $wp_rewrite, $wpdb, $wp_version, $wp, $id, $comment, $user_ID.
Хуки из функции
Возвращает
null
. Ничего не возвращает, а подключает файл в PHP.
Использование
load_template( $_template_file, $require_once, $args );
- $_template_file(cтрока) (обязательный)
- Серверный путь до файла, который нужно подключить.
- $require_once(логический)
true - будет подключать файл с помощью require_once, false - с помощью require.
Если подключение файла происходит внутри цикла и этот параметр указан в true, то первый элемент цикла отобразиться корректно, а следующие элементы выведутся как копии 1 элемента.
По умолчанию: true
- $args(массив) (С WP 5.5)
- Дополнительные параметры для подключаемого файла. Используйте переменную $args в подключаемом файле.
По умолчанию: array()
Примеры
#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' ); }
Заметки
- Global. Массив. $posts
- Global. WP_Post. $post Global post object.
- Global. true|false. $wp_did_header
- Global. WP_Query. $wp_query WordPress Query object.
- Global. WP_Rewrite. $wp_rewrite WordPress rewrite component.
- Global. wpdb. $wpdb WordPress database abstraction object.
- Global. Строка. $wp_version
- Global. WP. $wp Current WordPress environment instance.
- Global. int. $id
- Global. WP_Comment. $comment Global comment object.
- Global. int. $user_ID
Список изменений
С версии 1.5.0 | Введена. |
С версии 5.5.0 | The $args parameter was added. |