WordPress.org

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Теги шаблонов/get template part

Описание

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

Включает определенную часть шаблона темы, а если указано имя, то будет подключена специализированная часть шаблона. Если тема не содержит файла {slug}.php, тогда шаблон не будет подключен.

Подключается файл с именем "{slug}-{name}.php".

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

 <?php get_template_part$slug$name ); ?> 

Параметры

$slug
(строка) (обязательный) Имя для базового шаблона.
Default: None
$name
(строка) (необязательный) Имя специализированного шаблона.
Default: None

Примеры

Использование loop.php в дочерних темах

Предположим, что темы находятся в папке wp-content/themes; материнская тема "TwentyTen", а дочерняя тема "twentytenchild", тогда следующий код

<?php get_template_part( 'loop', 'index' ); ?>

подключит с помощью require() первый существующий из следующих файлов (в порядке приоритета):

  1. wp-content/themes/twentytenchild/loop-index.php
  2. wp-content/themes/twentyten/loop-index.php
  3. wp-content/themes/twentytenchild/loop.php
  4. wp-content/themes/twentyten/loop.php

Использование с поддиректориями

Чтобы использовать эту функцию с поддиректорией в директории вашей темы, просто наберите имя папки перед базовым именем. Например, если в директории вашей темы есть папка "partials" и часть шаблона "content-page.php" в этой папке, вы должны использовать get_template_part() следующим образом:

<?php get_template_part( 'partials/content', 'page' ); ?>

Навигация

Панель навигации может быть добавлена с использованием файла базового шаблона nav.php:

<?php get_template_part( 'nav' );           // Панель навигации (nav.php) ?>
<?php get_template_part( 'nav', '2' );      // Панель навигации #2 (nav-2.php) ?>
<?php get_template_part( 'nav', 'single' ); // Панель навигации для одиночных страниц (nav-single.php) ?>

Примечания

История изменений

  • Появился начиная с версии: 3.0

Исходный код

Код get_template_part() находится в wp-includes/general-template.php.

Внешние ссылки

Связанные ссылки

Include Tags