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

[ ←Вернуться к стандартному виду ]

Печатная версия

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

На заметку: Это статья — приложение к статье Устройство шаблонов (Stepping Into Templates).

Введение

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

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

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

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

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

Со времен появления Тем в Wordpress версии 1.5, Шаблоны становятся все более настраиваемы.
Перед тем, как создать свою Тему, Вам нужно понять механизм работы Шаблонов — почему WordPress использует разные файлы Темы для вывода того или иного контента в Вашем блоге. Эта статья призвана разъяснить, когда и как используется тот или иной Шаблон.

Условные теги (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

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

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

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

  1. home.php
  2. index.php

Одна запись

  1. single.php
  2. index.php

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

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

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

  1. Шаблон конкретной категории. Если ID категории 6, то шаблон для этой категории будет называться category-6.php
  2. category.php
  3. archive.php
  4. index.php
На заметку: Подробнее про шаблоны для категорий.

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

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

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

  1. author.php
  2. archive.php
  3. index.php
На заметку: Шаблон для страницы автора предназначен для вывода информации об авторе.

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

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

  1. date.php
  2. archive.php
  3. index.php

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

  1. search.php
  2. index.php

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

  1. 404.php
  2. index.php

Аттачменты

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

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

Комментариев: 77, оставить свой »

Страницы: « 4 3 2 [1] Показать все

  1. # 20 sonika (297) 06.05.2008 в 19:07

    Сергей, издержки быстрой модерации — ну уж больно сайтик странный — как будто Вам попался учебник по истории, еще не раздербанненый на саттелиты плюс копии статей из википедии — разве ж это блог? ;) А спамеры нынче умные пошли: не просто коммент напишут, а еще и поговорят с тобой, а потом присмотришься: нахер им ничего не нужно кроме ссылки и все комменты типа «спасибо!», «согласен» и т.п. Меня вон setty.biz тоже в спамеры как-то записал сгоряча — ничего, присмотрелся потом к моему блогу внимательнее и передумал :D

  2. # 19 Сергей (1) 06.05.2008 в 17:22

    «Соня» Я у тебя скачивал плагин расширенного редактора,

    И оставил комментарий с благодарностью!

    Дак почему твою мать на форуме по адресу forum.maxsite.org/viewtopic.php?id=4166

    Я вижу свой сайт в списке Спамеров?!!!

    есть что сказать, моя ICQ 393738069

  3. # 18 sonika (297) 30.04.2008 в 02:40

    Настя, это последствия переконвертации базы данных из cp1251 в utf8 — пострадали все заглавные буквы И и Р :))) Времени нет шерстить блог — как руки дойдут, исправлю во всех постах

  4. # 17 Настя Манно (1) 29.04.2008 в 23:07

    sonika, спасибо за статью! Но почему «Шерархия»? :)

  5. # 16 Alexey (2) 25.02.2008 в 22:22

    Огромное спасибо за перевод статьи.

    Нашёл решение своей проблемы!

  6. # 15 sonika (297) 25.01.2008 в 11:48

    ludmila, и вопрос не по теме, и… неужели Вы думаете, что я телепат или что на форуме WordPress на такие вопросы не отвечают?

  7. # 14 ludmila 25.01.2008 в 00:30

    Здравствуйте,

    у меня вопрос не совсем по теме, но очень важный для меня.

    Помогите, пожалуйста, разобраться: как вывести на странице “Контакты” в wordpresse форму для связи так, чтобы она отражалась только на этой странице, а на других страницах ее не было?

    Буду очень благодарна за помощь.

    Людмила

  8. # 13 sonika (297) 31.12.2007 в 17:14

    2Александр

    смотрите код своих файлов в папке Темы, ключевые слова: get_sidebar();. Например в Теме default вызова сайдбара нет в файле single.php, поэтому при просмотре одной записи сайдбар и не отображается.

  9. # 12 Александр (10) 30.12.2007 в 13:58

    Sonica, статья очень помогла. Только возник вопрос: я создал шаблон для категории, у нее свой сайдбар. Как сделать чтобы этот же сайдбар оставался при прочтении полной новости, а не только анонса?

  10. # 11 Kanaev 27.12.2007 в 18:09

    спасибо

  11. # 10 generator2003 16.12.2007 в 02:54

    БООльшое спамибо очень облегчили мне жизнь

    Щас как раз читаю кодекс но с енг плохо

  12. # 9 Spotm 21.10.2007 в 15:12

    Спасибо за перевод. Понятно и доступно и кратко ) В кодексе уж больно всего много и так размыто по ссылкам что переводить замучаешься, если плохо с английским.

  13. # 8 sanick (1) 21.09.2007 в 02:42

    Вот так удача! Случайно забрел сюда, а сколько полезного узнал о структуре WordPress. Благодарствую.

    С уважением.

  14. # 7 Шумахер (1) 12.09.2007 в 17:20

    спасибо за перевод!

  15. # 6 Тамерлан (1) 23.08.2007 в 20:15

    Респект за перевод! Хотелось бы больше СВОшХ мыслей и передачи опыта. У максе как то более полезная статья по шаблонам IMHO

  16. # 5 sasharp 11.08.2007 в 21:16

    Спасибо тебе за твой труд. Полезная статья. Если бы не прочитал, пришлось бы на форуме спрашивать:)

  17. # 4 douson 07.08.2007 в 10:03

    Информация полезная, особенно для тех, кто только начал сам заниматься создание шаблонов для WP... Достойные люди оценят труд автора :-)

  18. # 3 azimsky 03.08.2007 в 11:47

    А может такой перевод?

    WordPress uses the Query String

    — information contained within each link on your web site — to

    decide which template or set of templates will be used to display the page.

    WordPress использует строку запроса (запрос контента) — [т.е.]

    информацию, содержащуюся внутри каждой ссылки на вашем

    веб-сайте — для того, чтобы решить какой шаблон или набор

    шабюлонов будет использован для отображения [запрошенной]

    страницы.

    =====

    It also illustrates the relationship of Query Strings to

    corresponding Conditional Tags.

    Graphic Example of the WordPress Template Hierarchy Structure

    Он [график]также показывает отношение строки запроса (запрос

    контента) к соответствующему условному тегу (комментарию).

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

  19. # 2 sonika (29) 22.07.2007 в 23:49

    Устала рассказывать одно и то же на форуме русского WordPress. Случаются такие люди, которые не знают английского и не умеют пользоваться переводчиками, к сожалению…

  20. # 1 Van (1) 22.07.2007 в 23:43

    Ради чего всё это?

Страницы: « 4 3 2 [1] Показать все

Написать комментарий


Ручная модерация комментов. Все саттелиты — в топку! Даже не сомневайтесь. Для вопросов о вордпресс не по теме поста есть два русскоязычных форума по wordpress.


Subscribe without commenting

[ ←Вернуться к стандартному виду ]

Печатная версия