Иерархия шаблонов в 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

Оставить комментарий »

  1. # максим 17.02.2009 в 12:33

    есть кое что интересное, изучим на днях

  2. # Basil_Snowman 17.02.2009 в 17:40

    to Юля.
    для работы с личными шаблонами страниц
    первой строкой шаблона должна быть следующая:

    где template_name - слуг и имя файла шаблона

  3. # Basil_Snowman 17.02.2009 в 17:47

    шайтан! теги съел..

    кодекс. pages.
    вот оно.
    Раздел \"Creating Your Own Page Templates\"

    http://codex.wordpress.org/Pages

  4. # Рома (2) 22.02.2009 в 10:04

    Sonika вопрос такой:подскажите как для страницы сделать подстраницу чтобы она на главной была не видна и далее у этой подстраницы было подолжение на следующею типа как у вас Стр. 1 из 5  1  2  3  4  5 » Может есть плагин?

  5. # sonika (301) 28.02.2009 в 20:39

    Рома, ставьте тег <!--nextpage--> (в режиме КОД в виз. редакторе) и пост будет делиться на страницы, в шаблоне для одиночного поста должен быть также wp_link_pages

  6. # Рома (2) 01.03.2009 в 02:13

    Спасибо с тегом разобрался.

  7. # Лена 14.03.2009 в 12:42

    скажите где редактировать исходные формы,если сайт на вордпрессе...где они там....а?

  8. # sonika (301) 14.03.2009 в 15:05

    Лена, какие еще формы?

  9. # Yeva 09.04.2009 в 11:14

    Ну, во-первых, спасибо огромное за весьма полезную статью! Она у меня уже давненько в избранном.
    А во-вторых, вопрос:

    А что с иерархией шаблонов в WP 2.7.1?
    уменя почему-то не работают ни именованные шаблоны страниц, ни слаги...

  10. # voronzoff (1) 27.04.2009 в 19:17

    Полезно, раньше примерно только знал, что если нет шаблона к рубрикам то архивный будет...
    кароче можно одним файликом обойтись: index.php и файлом стилей, если очень надо))))

  11. # Евгений 20.05.2009 в 13:55

    Я хочу сделать на главной странице свой собственный шаблон, а всю вункциональность блока оставить под раздел "Новости". Как это сделать не пойму!?

  12. # Vitaliy (1) 23.05.2009 в 09:23

    Классическая структура темы для WordPress, системы шаблонов (темы) очень популярны в cms, что не заставляет конечного пользователя баз знания html особо напрягатся при администрировании системы. Еще популярны штуки основанные на xml разметке, данных.

  13. # максим (1) 19.07.2009 в 12:23

    попробовал создать свой шаблон, сразу хочу сказать что не получилось ничего путного, проблема в том что когда я sidebar заганяю стилями влево, то справа в колонках при наведении мышки ссылки не отображаются, они отображаються только в одной определеной точке, то есть проводишь мышкой по записи(а запись это ссылка), то только в определенной точке можно кликнуть, убираю sidebar, всё нормально становиться ссылки кликаются везде по всему протяжении записи, не встречалась с такой проблемой ты раньше, и если нет то где можно почитать

  14. # sonika (301) 20.07.2009 в 15:11
  15. # Yeva 21.07.2009 в 10:56

    Евгений, Вам нужно создать или изменить страницу home.php

  16. # Asus 17.08.2009 в 07:51

    Где можно увидеть, узнать ID у рубрик?

  17. # Сергей (1) 22.10.2009 в 09:50

    Спасибо за познавательную статью по вордпрессу.
    Вот не знал что так ещё можно делать, пойду пробовать.

  18. # Человек из Симферополя (2) 09.11.2009 в 11:07

    А есть ли возможность сделать вывод постов в конкретной рубрике по конкретному шаблону? ну то есть, шаблон не для рубрики в целом а для страницы полной версии ее постов? пока не нашел как реализовать.

  19. # sonika 15.11.2009 в 18:51

    Человек из Симферополя, посмотрите этот плагин:
    blog.portal.kharkov.ua/2008/07/19/use_parent_category_template/

  20. # Человек из Симферополя (2) 22.11.2009 в 23:40

    Оно, спасибо большое, Sonika

  21. # AlterVision (1) 24.11.2009 в 00:30

    Огромное спасибо за статью!)
    Не первый год уже верстаю под вордпресс, теперь наконец-то разобрался, как он корректно выводит иерархию шаблонов))

  22. # OkadaSan 14.12.2009 в 15:13

    Cпасибо за полезнейший пост

  23. # Александр-HIMиk (1) 29.01.2010 в 05:13

    Пользуясь случаем скажу спасибо, хоть и несколько лет назад прочитал это здесь :)

  24. # Carik (2) 05.04.2010 в 22:56

    Sonika, схему  Иерархия шаблонов Темы - уже пора поменять. Для точности изложения.

  25. # surger 25.05.2010 в 21:11

    Кому: Сергей #75

    Ваш шаблон category-5.php - для просмотра ЛЕНТЫ постов, т.е. не ОДНОЙ записи, а многих.

    ОДНА запись выводится по шаблону файла single.php.

    Как сделать разными? Наверное, делать дополнительную проверку на ИД категории в single.php.

  26. # Carik (2) 26.05.2010 в 00:14

    Сергею:  Для начинающих - лучше поставить плагин Single Post Template

  27. # Ler4ik (1) 28.06.2010 в 17:23

    Спасибо за интересные полезности. Напишите пожалуйста мне если сможете взяться за доработку шаблона на вордпрессе.

  28. # kridan 15.10.2010 в 09:13

    Спасибо за статью, помогла во многом разобратся. Но по ходу понимания возник вопрос. У меня есть несколько категорий со смоими шаблонами, каждая категория имеет несколько дочерних. Вопрос состоит в том, как организовать вывод дочерних категорий в шаблон материнской.
    Есть cat-1, со своим шаблоном, есть дочернии cat-2, cat-3, как сделать чтобы cat-2 и cat-3 выводились в шаблон cat-1
    Заранее благодарен.

  29. # Владимир (1) 16.10.2010 в 13:58

    Подскажите, пожалуйста, а как отредактировать шаблон вывода комментариев?

  30. # Игорь 18.01.2011 в 09:15

    Sonika, привет!
    Спасибо за ваши усилия.
    Вас, должно быть, уже утомили вопросы вокруг home и index, но я таки дерзну и докину ещё один ) Ситуация: нужен отдельный шаблон для первой страницы многостраничного листинга записей. Использую home.php, ставлю wp-paginate, рассчитываю, что со второй страницы (и так далее) в игру вступит index.php, но на деле остаюсь в шаблоне главной. Проверка is_home внутри home.php, конечно, всегда положительна.
    Правильнее ли для такой задачи всё размещать внутри index.php или как-то ещё? Спасибо!

  31. # Дима (1) 14.02.2011 в 16:56

    Плиз хелп!! Почему-то не отрабатывается category-id.php. Т.е. я создаю шаблон category-3.php для отображения страницы 3 категории, но категория отображается по шаблону category.php. Пробовал также category-slug.php - тоже самое. Также пробовал на другом шаблоне - тоже самое. Как думаете в чем может быть проблема? Использую WordPress 2.8.6. Заранее спасибо )

  32. # Игорь (1) 04.03.2011 в 16:09

    Очень полезный сайт.Только всё мудрёно,надо разбираться.

  33. # vitalysedov (1) 19.03.2011 в 19:45

    "..Почему-то не отрабатывается category-id.php.."
    читать тут
    http://blog.portal.kharkov.ua/2008/07/19/use_parent_category_template/

  34. # Женя (1) 06.05.2011 в 23:33

    Полезная информация, В будущем думаю заняться созданием собственных тем, пригодится сайт). Спасибо автору.

  35. # Віталій 04.10.2011 в 14:05

    Здравствуйте. Как с Вами связаться по поводу создания wordpress темы?
    Нужна сложная тема-конструктор.
    Если заинтересуетесь - пишите.

  36. # Иришка (1) 01.04.2012 в 16:34

    Для раздела видео хочу сделать чють другой шаблон, не пойму как это сделать :(

  37. # Женя (1) 07.04.2012 в 20:58

    Пробовала сделать отдельные шаблоны страниц для сайта http://alina-krishtal.ru/. Не получилось нормального отображения того, что хотелось бы там видеть. Возможно ли, что какие-то элементы шаблонов могут блокировать отображаемость элементов в других шаблонах этой же темы?

  38. # Евгений (1) 31.05.2012 в 12:37

    Спасибо за статью! А то в инете везде только урывками удается найти информацию по файлам шаблона. А тут у вас все вместе и ссылки для отдельных файлов есть. Тоже очень удобно!

  39. # Настя (1) 22.08.2012 в 16:06

    Только посте вашего поста я поняла иерархию шаблона вордпресс)) спасибо большое!

  40. # Ирина 20.05.2013 в 17:13

    Замечательная статья, спасибо
    Нужно только подправить, что для статической страницы по короткой ссылке шаблон должен называться не about.php  а page-about.php потому что первый вариант не работает.

  41. # Иван (2) 20.05.2015 в 11:46

    Один шаблон не сложно настроить а вот если несколько шаблонов использовать на сайте то можно запутаться

  42. # Pingback Sonika’s blog. Ð’ основном про WordPress » Условные теги WordPress 05.07.2016 в 22:45

    [...] внимание на перевод статьи Иерархия шаблонов Темы WordPress (оригинал, англ. яз.), это тесно переплетенные между [...]

  43. # Pingback Sonika’s blog. Ð’ основном про WordPress » Custom fields в WordPress — примеры продвинутого использоваР05.07.2016 в 22:48

    [...] Иерархия шаблонов WordPress — рекомендуется к ознакомлению всем, кто собрался курочить Тему, а ниже мы этим как раз и займемся :) Если кратко, то за вывод одиночной записи отвечает шаблон single.php, а за вывод страницы — page.php [...]

  44. # Pingback Sonika’s blog. Ð’ основном про WordPress » Чекбокс «Опубликовать на главной» 05.07.2016 в 22:50

    [...] Загружаем conf.ini в папку плагина rc-custom-field-gui. Все готово, чекбокс на месте, осталось чуть модифицировать код главной страницы. За вывод записей на главной отвечает файл-шаблон home.php или index.php (зависит от вашей Темы, подробнее читайте тут о иерархии шаблонов). [...]

Подписаться на фид.
RSS комментариев к этой записи. | TrackBack URI

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


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

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

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