WordPress.org

Ready to get started?Download WordPress

Codex

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

Справочник по функциям/Получение части шаблона

Эта страница помечена как незавершённая. Вы можете помочь проекту, дополнив её.

Описание

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

Includes the named template part for a theme or if a name is specified then a specialized part will be included. If the theme contains no {slug}.php file then no template will be included.

For the parameter, if the file is called "{slug}-{name}.php".

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

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

Параметры

$slug
(string) (required) The slug name for the generic template.
Default: None
$name
(string) (optional) The name of the specialized template.
Default: None

Примеры

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

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

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

will do a PHP require() for the first file that exists among these, in this priority:

  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

Using with theme subfolders

To use this function with subfolders in your theme directory, simply prepend the folder name before the slug. For example, if you have a folder called "partials" in your theme directory and a template part called "content-page.php" in that sub-folder, you would use get_template_part() like this:

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

Навигация

Adding a navigation bar to theme using a generic nav.php template file:

<?php get_template_part( 'nav' );           // Navigation bar (nav.php) ?>
<?php get_template_part( 'nav', '2' );      // Navigation bar #2 (nav-2.php) ?>
<?php get_template_part( 'nav', 'single' ); // Navigation bar to use in single pages (nav-single.php) ?>

Заметки

Изменения

Source File

get_template_part() is located in wp-includes/general-template.php.

External Resources

Related

Include Tags

See also index of Function Reference and index of Template Tags.