is_page_template() — позволяет определить, используется ли указанный файл темы при создании текущей страницы

Функция возвращает true, если указанный в параметрах файл шаблона используется при генерации текущей (открытой в данный момент) страницы, во всех остальных случаях возвращает false.

is_page_template( $template = '' )

$template
(строка) полное имя файла шаблона с расширением, например home.php, при этом начиная с версии WordPress 3.4 можно также указать и папку, в которой находится файл относительно директории темы, например inc/wordpress.php.

Пример использования

Как вы возможно знаете, генерировать главную страницу сайта может один следующих файлов темы:

  • front-page.php,
  • home.php,
  • index.php,
  • page.php и ещё 2 файла, через которые можно вывести страницу,
  • бесконечное количество пользовательских шаблонов страниц, которые можно выставить в настройках на главную;

Более подробно о порядке использования файлов темы можно почитать вот здесь.

Предположим, нам нужно вывести рекламный баннер в шапке сайта только в том случае, если главная страница создается через файл index.php, тогда код будет следующий:

if( is_page_template( 'index.php' ) ){
	echo '<div id="banner"></div>';
}

Пример из кодекса WordPress

Тут все довольно просто, вот мы создали какой-нибудь файл шаблона страницы, например wordpress.php, и теперь нам нужно узнать, используется ли этот файл при создании каких-то определенных страниц или нет — в этом нам поможет следующий код:

if ( is_page_template('wordpress.php') ) {
	// в это место вставляем код, который будет выполняться если файл используется
} else {
	// код, который будет выполняться если файл НЕ используется
}

Использование по отношению к циклу

Как и большинство других условных тегов, is_page_template() не будет правильно работать внутри цикла, поэтому:

  • используйте тег перед началом цикла,
  • после цикла использовать тоже можно, но там обязательно должна быть задействована функция wp_reset_query();

Миша

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

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

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

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

Миша Рудрастых и WordPress

Полезности из мира WordPress и жизни студии.

Мой телеграм-канал