Sonika’s blog. В основном про WordPress » Иерархия шаблонов в WordPress

Опубликовано: 01.09.2018

Перевод статьи Кодекса WordPress: Template Hierarchy . Перевод почти дословный, я старалась не отклоняться от оригинала:

Введение

Страницы сайта на WordPress собираются из файлов-шаблонов Темы подобно пазлу. Некоторые Шаблоны (например header.php и footer.php) задействованы на всех страницах, другие используются только при определенных условиях.

О чем эта статья

Эта статья дает ответ на вопрос:

Какие шаблоны используются для отображения того или иного типа страниц в WordPress?

LEO JULY 2018 Tarot Reading ☕️💗

Для кого эта статья

Со времен появления Тем в WordPress версии 1.5, Шаблоны становятся все более настраиваемы.

Перед тем, как создать свою Тему, Вам нужно понять механизм работы Шаблонов — почему WordPress использует разные файлы Темы для вывода того или иного контента в Вашем блоге. Эта статья призвана разъяснить, когда и как используется тот или иной Шаблон.
ARIES MAY 2018 Tarot Reading ☕️💗

Условные теги (Conditional Tags) и иерархия Шаблонов

WordPress может несколькими способами подбирать Шаблоны в соответствии с типом контента (query types). Разработчики Тем для WordPress могут также использовать «условные теги» (Conditional Tags) для того, чтобы определенный Шаблон был использован на конкретной странице блога.

Некоторые Темы могут не содержать всех файлов-шаблонов, описанных в этой статье.

В некоторых Темах использованы условные теги (conditional tags) для вызова других (собственных) шаблонов.

Посмотрите здесь: Создание Тем и условные теги (Conditional Tags) .

Иерархия шаблонов Темы

Общие сведения

WordPress использует строку запроса (запрос контента) ( Query String ), т.е. информацию, содержащуюся внутри каждой ссылки на вашем веб-сайте для того, чтобы решить какой шаблон или набор шаблонов будет использован для отображения [запрошенной] страницы.

Первым делом WordPress сравнивает каждый запрос контента из базы данных (Query String) с существующими типами контента (query types) — таким образом, WordPress определяет, какой тип контента запрошен (страница поиска, страница категории, главная страница и т.п.).

Затем выбирается нужный шаблон в соответствии с иерархией шаблонов — и страница генерируется. Использование того или иного шаблона зависит от того, присутствует ли нужный шаблон в папке активной Темы.

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

За исключением основного шаблона index.php , разработчик Темы может выбрирать: создавать ли отдельный шаблон для определенного типа контента или нет. Если WordPress не может найти Шаблон с определенным именем, то он переходит к следующему Шаблону в соответствии с иерархией. Если WordPress не найдет ни одного Шаблона для данного типа контента, то будет использован основной шаблон index.php .

Примеры

Если Ваш блог находится по адресу http://domain.com/wp/

и посетитель переходит на страницу категории http://domain.com/wp/category/your-cat/ ,

WordPress в папке текущей Темы в первую очередь ищет шаблон, который отвечает за вывод этой категории. Если ID данной категории 4, WordPress ищет шаблон с именем category-4.php .

Если такой шаблон не найден, WordPress ищет общий для всех категорий шаблон category.php .

Если и такого файла-шаблона нет, WordPress ищет шаблон для вывода архива archive.php .

Если нет и этого файла, WordPress будет использовать основной шаблон Темы index.php .

Если посетитель переходит на главную страницу сайта http://domain.com/wp/ , WordPress ищет шаблон home.php . Если файла home.php в папке Темы нет, WordPress использует файл index.php для вывода главной страницы блога.

Теперь наглядно

На этой картинке показано, какие файлы-шаблоны используются для вывода тех или иных типов страниц.

График также показывает отношение строки запроса (запрос контента) ( Query Strings ) к соответствующему условному тегу ( Conditional Tags ).

Графический пример структуры иерархии шаблонов WP

Новая схема!!!

Иерархия шаблонов в WordPress

Подробнее о иерархии шаблонов Темы

Рассмотрим приоритет использования шаблонов при вызове разных типов контента в WordPress.

Главная страница

home.php index.php

Одна запись

single.php index.php

Статичная страница

Шаблон, выбранный при создании или редактировании статичной страницы в выпадающем списке справа «Шаблон страницы».

Подробнее про шаблоны Статичных страниц . если слаг (короткая ссылка) Страницы about , то для этой страницы может использоваться шаблон about.php page.php index.php На заметку: Это относится только к Статичным страницам, НЕ к страницам с постами. Подробнее: Статичные страницы .

Страница категории

Шаблон конкретной категории. Если ID категории 6 , то шаблон для этой категории будет называться category-6.php category.php archive.php index.php

Страница тега (метки)

В первую очередь шаблон для вывода постов с определенной меткой ищется по его слагу («короткая ссылка»). Если слаг метки privet , WordPress сначала ищет шаблон tag-privet.php tag.php archive.php index.php

Страница автора

author.php archive.php index.php

Страница даты

К примеру, архив за месяц.

date.php archive.php index.php

Страница результатов поиска

search.php index.php

Страница 404 (ничего не найдено)

404.php index.php

Аттачменты

Шаблоны для аттачментов (прикрепленных файлов) (картинки, видео и т.д., открываемые на отдельной странице)

image.php, video.php, audio.php, application.php и другие первые слова из названия MIME типов . attachment.php index.php