Иерархия шаблонов WordPress: как работает выбор файлов темы

Если вы изменили page.php, а нужная страница осталась прежней, WordPress, скорее всего, использует для неё другой файл. Ядро выбирает шаблон по типу текущего запроса и проверяет подходящие имена по установленному порядку. Этот порядок называется иерархией шаблонов.

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

Сначала определите, какой запрос обрабатывает WordPress

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

Перед поиском файла выясните, какой именно объект вы видите:

  • главную страницу сайта;
  • страницу записей блога;
  • отдельную запись или страницу;
  • архив рубрики, метки или пользовательской таксономии;
  • результаты поиска, архив автора или дату публикации;
  • страницу ошибки 404.

В WordPress это не просто выбор по адресу в браузере: шаблон связан с основным запросом, который сформировало ядро. Поэтому при нестандартных правилах URL, плагинах или пользовательском коде сначала полезно проверить, какой объект WordPress действительно считает текущим.

Как устроена иерархия в классической теме

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

Например, для записи типа «Записи» WordPress может проверить single-post-слаг.php, затем single-post.php, single.php, singular.php и index.php. В конкретном проекте найдутся не обязательно все эти файлы: поиск просто пропустит отсутствующие и продолжится.

Что открытоПорядок поиска в классической теме
Статическая главнаяfront-page.php, затем подходящие шаблоны страницы и общие запасные файлы
Страница записей блогаhome.php, затем index.php
Обычная страницаНазначенный шаблон страницы, page-слаг.php, page-ID.php, page.php, singular.php, index.php
Отдельная записьsingle-тип-слаг.php, single-тип.php, single.php, singular.php, index.php
Рубрикаcategory-слаг.php, category-ID.php, category.php, archive.php, index.php
Поиск или 404search.php или 404.php, затем index.php

В именах вместо слов «слаг» и «ID» используются фактический ярлык в адресе и числовой идентификатор. Например, для рубрики со слагом news специфичный файл называется category-news.php.

Как выбрать шаблон для главной страницы, страницы и архива

Главная сайта и страница записей — не одно и то же

front-page.php предназначен для главной страницы сайта и, если он есть, имеет приоритет для этого запроса. Если отдельного файла нет, WordPress продолжает поиск с учётом того, что показывается на главной: статическая страница или последние записи.

home.php отвечает за индекс записей блога — список публикаций. Он может отображаться на главной, если сайт настроен показывать последние записи, или на другой странице, назначенной страницей записей. Поэтому правка home.php не обязательно изменит статическую главную, а правка front-page.php не обязательно изменит список записей.

Проверьте настройки в разделе «Настройки → Чтение»: там видно, выбрана ли статическая главная и назначена ли отдельная страница для записей.

Страницы и назначенные шаблоны

Для обычной страницы сначала учитывается шаблон, назначенный ей в редакторе. В классической теме такой шаблон обычно объявлен в PHP-файле комментарием с названием шаблона, а его выбор хранится у страницы. Если он не назначен, WordPress проверяет имена с названием страницы и её ID, затем page.php и более общие варианты.

Это объясняет частую ситуацию: файл page-about.php существует, но страница «О нас» отображается иначе. Проверьте, не назначен ли ей другой шаблон в редакторе, и убедитесь, что слаг страницы действительно about. Также проверьте, не редактируете ли вы файл родительской темы, когда активна дочерняя.

Записи и архивы

Для пользовательского типа записи вместо post используется его системный ярлык. Например, для типа book WordPress ищет шаблоны вида single-book.php, а затем общие шаблоны отдельной записи. Шаблон архива этого типа обычно называется archive-book.php, если для типа включён архив.

Для пользовательской таксономии действуют варианты с названием таксономии и термина: например, taxonomy-genre-fiction.php, taxonomy-genre.php, taxonomy.php, затем общие шаблоны архивов. Поэтому файл archive.php может не использоваться, если в теме найден более точный шаблон.

Как узнать, какой файл выбран на конкретной странице

На работающем сайте удобнее всего начать с плагина Query Monitor: откройте нужную страницу, войдите в админ-панель и найдите в панели администратора информацию о шаблоне. Инструмент показывает выбранный файл и помогает отличить его от подключаемых частей шаблона. Используйте его на тестовой или рабочей копии с учётом правил сайта; после диагностики плагин можно отключить.

Если проверяете вручную, откройте каталог активной темы, а затем дочерней темы, если она используется. Сопоставьте тип страницы с иерархией и проверьте наиболее специфичные файлы первыми. В админке также проверьте назначенный шаблон страницы и настройки чтения. После правки очистите кеш страницы или CDN, если они настроены: кеш способен показывать прежнюю разметку, хотя WordPress уже выбрал другой файл.

Шаблон верхнего уровня не всегда содержит весь HTML нужного участка. Он может подключать части через get_template_part(), заголовок через get_header() или выводить блоки. Если нужного фрагмента нет в найденном шаблоне, ищите имя подключаемого файла в коде темы и проверяйте, не формируется ли этот участок блоком.

Классические и блочные темы: разные файлы

В блочной теме основные шаблоны обычно находятся в каталоге templates и представлены HTML-файлами, например single.html, page.html или index.html. Части шаблона размещаются в parts. Иерархия по смыслу сохраняется: WordPress подбирает шаблон для типа запроса, но редактируются блоки и HTML-разметка, а не PHP-шаблон классической темы.

Есть ещё одно отличие: изменения шаблона, сохранённые через редактор сайта, могут храниться в базе данных и иметь приоритет над файлом темы. Поэтому если файл в templates не отражается на сайте, проверьте «Внешний вид → Редактор» и сохранённые там шаблоны. Для безопасных изменений темы используйте дочернюю тему или редактор сайта, а не правьте файлы родительской темы: обновление может перезаписать ваши изменения.

Почему ожидаемый файл не срабатывает

В большинстве случаев причина обнаруживается проверкой типа запроса и более специфичных шаблонов. Если ожидаемый файл существует, но страница выглядит иначе, проверьте по порядку:

  • Это действительно нужный тип страницы, а не главная, индекс блога или архив?
  • Нет ли файла с более конкретным именем, который имеет приоритет?
  • Не назначен ли странице другой шаблон?
  • Активна ли та тема и та дочерняя тема, где вы ищете файл?
  • Не переопределён ли шаблон сохранённой версией из редактора сайта?
  • Не показывает ли кеш старую страницу?

Если диагностика подтверждает, что WordPress выбрал нужный PHP-шаблон, но участок страницы всё равно не меняется, проверьте подключаемые части, хуки темы и вывод блоков. Для блочной темы сначала проверьте шаблон в редакторе сайта. Так вы отделите выбор основного шаблона от содержимого, которое формируется уже внутри него.

Практический принцип простой: не начинайте с редактирования index.php или page.php наугад. Определите запрос, найдите самый конкретный шаблон, который может на него сработать, и только затем меняйте файл в активной теме. Это сокращает число пробных правок и помогает сохранить изменения при обновлении оформления.

Иерархия шаблонов WordPress: как выбрать нужный файл темы
11.11.2026
Как создать дочернюю тему WordPress и зачем она нужна
30.10.2026
Как перенести WordPress с локального сервера на хостинг
18.10.2026
Как установить WordPress на локальный сервер и начать разработку сайта
15.10.2026
Как создать кастомный виджет в WordPress: пошаговое руководство
02.10.2026
×
Дай суперсилу своему сайту!

WordPress

-20% на топовые темы и плагины

Создай сайт своей мечты ⋙