WordPress.org

Ready to get started?Download WordPress

Codex

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

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

Contents

Описание

Загружает шаблон темы в вызвавший шаблон (имеется ввиду пользовательский шаблон, отличный от header, sidebar, footer и др. дефолтных шаблонов темы). Упрощает процесс повторного использования участков кода для тем-наследников child themes, использующих шаблоны тем-родителей. Добавляет выбранный шаблон в вызвавший шаблон темы. Может добавлять по составному имени шаблона или по не составному. Если не выбран добавляемый шаблон {slug}.php (см. параметр slug) т.е. главная часть названия шаблона, то ничего не будет добавлено.

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

<?php get_template_part( $slug, $name ) ?>

Параметры

$slug
(string) (required) Главное название (slug) добавляемого шаблона.
Default: None
$name
(string) (optional) Составное название (name) добавляемого шаблона.
Default: None

Примеры

Использование шаблона loop.php в теме-наследнике

Предполагается, что в следующем коде используется шаблон loop.php из дефолтной темы-родителя twentyten, из папки wp-content/themes темой-наследником twentytenchild:

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

Это эквивалентно функции PHP require() для следующих шаблонов:

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

Навигация

Добавление навигационной панели в тему, используя общий шаблон 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' ); // Ещё наследница для шаблона single (nav-single.php) ?>

Все эти навигационные панели основаны на nav.php и расположены в директории текущей темы. Источник: wp-tricks.co.il - using get_template_part() to create generic navigation bar

Хранение шаблонов в папках

В организационных целях Вы можете хранить шаблоны в отдельных папках Вашей темы. Например:

<?php get_template_part( 'blocks/advertisement' ); ?>

Будет предпринята попытка загрузить шаблон по следующему пути wp-content/themes/your-theme/blocks/advertisement.php.

Примечание

История версий

  • Начиная с: 3.0

Исходный код

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

Схожие функции

Include Tags

Смотрите также Справочник функций и Теги шаблона