Если вы изменили 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 |
| Поиск или 404 | search.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 наугад. Определите запрос, найдите самый конкретный шаблон, который может на него сработать, и только затем меняйте файл в активной теме. Это сокращает число пробных правок и помогает сохранить изменения при обновлении оформления.