get_template_part() — подключает файлы темы

3.0.0 wp-includes / general-template.php / Кодекс WordPress

Возможно вы уже знаете, что файл header.php (и все его производные — header-1.php, header-home.php, header-main.php и так далее) подключает функция get_header(), файл footer.php — get_footer(), а функция get_sidebar() подключит sidebar.php.

Если хотите разобраться в создании тем для WordPress, рекомендую вам мой видеокурс.

А как подключить скажем nav.php или content.php? А что, если файл находится в подпапке темы?

Итак, get_template_part(). По сути это аналог include() или require() (функции PHP), но с некоторыми особенностями.

Во-первых, она уже знает, где расположена ваша тема и будет искать запрошенный файл непосредственно в директории текущей темы.
Во-вторых, если запрашиваемого файла не существует, она не выдаст предупреждение или ошибку, кроме того, она попробует подключить другой подходящий файл.
Поддерживает дочерние темы WordPress.
Позволяет передавать переменные в подключаемый файл (с версии WordPress 5.5).

get_template_part( $slug, $name = null, $args = array() )

Параметры

$slug: (строка) название файла, который будем подключать, его первая часть, также может содержать названия директорий через слэш.
$name: (строка) вторая часть названия (для того, чтобы понять, как работать с параметрами функции, смотрите примеры).
$args: (массив) аргументы, которые будут переданы в подключаемый файл (с версии 5.5.0)

Примеры

get_template_part( 'mymenu' ); // mymenu.php в директории темы

get_template_part( 'mymenu', 'header' ); // mymenu-header.php в папке темы

get_template_part( 'mymenu', 'footer' ); // mymenu-footer.php в папке темы

get_template_part( 'parts/entry' ); // entry.php в директории 'parts', которая, в свою очередь, находится в папке с темой

get_template_part( 'parts/entry', 'video' ); // entry-video.php в директории 'parts'

Динамическое подключение

Мы также можем подключать файлы динамически, например в зависимости от возвращаемых значений функций get_post_type() и get_post_format().

get_template_part( 'includes/entry', get_post_type() );

get_template_part( 'includes/entry', get_post_format() );

Обратите внимание, что данные примеры будут работать только внутри цикла WordPress. Про цикл рекомендую посмотреть отдельный видеоурок.

Передача параметров

Как я уже упоминал выше, начиная с версии WordPress 5.5, эта функция получила третий аргумент, в который можно передать любые параметры в виде массива. Давайте на примере с этим и разберёмся.

get_template_part(
    'entry',
    get_post_type(),
    array( // массив с параметрами
        'key1' => 'value1',
        'key2' => 'value2'
    )
);

Предположим мы подключаем какой-то шаблон для вывода поста в цикле, типо entry-тип поста.php и при этом хотим передать какие-то два параметра в шаблон.

То внутри нашего шаблона мы можем обратиться к ним следующим образом:

var_dump( $args );  // Можем распечатать всё, чтобы понять, что внутри
echo $args[ 'key1' ];  // Выводим значение определённого параметра

Порядок подключения файлов

get_template_part( 'nav', 'footer' );

Приоритет подключения файлов в данном случае:

nav-footer.php в дочерней теме,
nav-footer.php в родительской теме,
nav.php в дочерней теме,
nav.php в родительской теме.

Хук get_template_part_{$slug}

Хук запускается в самом начале функции и позволяет выполнить какой-либо код в зависимости от значений переменных $slug и $name.

do_action( "get_template_part_{$slug}", $slug, $name );

Кодекс WordPress: Файлы темы: get_footer(), get_header(), get_search_form(), get_sidebar(), get_template_part(), wp_get_theme()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Примеры
1. Динамическое подключение
2. Передача параметров
Порядок подключения
Хук get_template_part_{$slug}

Комментарии — 3

Евгений

27 Авг 2015

Здравствуйте!
Использую адаптивный шаблон "Awaken".
Установил плагин "Ultimate WP Query Search Filter", но возникли проблемы с отображением результатов ajax-поиска... автор плагина дал мне код для function.php -

add_filter('uwpqsf_result_tempt', 'customize_output', '', 4);
function customize_output($results , $arg, $id, $getdata ){
	 // The Query
            $apiclass = new uwpqsfprocess();
             $query = new WP_Query( $arg );
		ob_start();	$result = '';
			// The Loop
 
			if ( $query->have_posts() ) {
			while ( $query->have_posts() ) {
				$query->the_post();global $post; 
 
				get_template_part( 'content', get_post_format() );
			}
                        echo  $apiclass->ajax_pagination($arg['paged'],$query->max_num_pages, 4, $id, $getdata);
		 } else {
					 get_template_part( 'content', 'none' );
				}
				/* Restore original Post Data */
				wp_reset_postdata();
 
		$results = ob_get_clean();
			return $results;
}

Думаю проблема с - get_template_part( 'content', get_post_format() );
Почему-то не корректно отображается вывод статей... стили применяются к каждой статье, а не ко всем, как в стандартном поиске.

В чем может быть загвоздка?
Заранее спасибо!

В index.php есть код, который отвечает за "правильный" вывод статей -

<?php /* Start the Loop */ 
				$counter = 0;
			?>
			<div class="row">
			<?php while ( have_posts() ) : the_post(); ?>
 
				<?php
					/* Include the Post-Format-specific template for the content.
					 * If you want to override this in a child theme, then include a file
					 * called content-___.php (where ___ is the Post Format name) and that will be used instead.
					 */
					get_template_part( 'content', get_post_format() );
				?>
 
			<?php 
				$counter++;
				if ($counter % 2 == 0) {
					echo '</div><div class="row">';
			 	} 
			?>
			<?php endwhile; ?>
 
			<div class="col-xs-12 col-sm-12 col-md-12">
				<?php awaken_paging_nav(); ?>
			</div>
		</div><!-- .row -->

Вот он почему-то и не срабатывает в ajax-выводе....

Миша 31 Авг 2015
Здравствуйте!
Сорри за задержку, был в отъезде.

В первую очередь на вашем месте я бы проанализировал HTML статей с которыми всё ок и HTML статей, с которыми проблемы. Нашел бы, в чем отличие. И уже отталкивался бы от этого.

Чтобы оставить комментарий, пожалуйста, зарегистрируйтесь или войдите.