Ієрархія шаблонів блокової теми WordPress

Повна ієрархія шаблонів блокової теми (FSE): для кожного типу запиту — упорядкований перелік шаблонів, які шукає WordPress, від найспецифічнішого до запасного index.html. Аналог класичної схеми ієрархії для епохи блоків.

Для кожного запиту WordPress шукає ці шаблони по черзі — спочатку найконкретніші — і зупиняється на першому, який існує в папці /templates вашої теми. Ланцюжок завжди завершується на index.html.

Головна сторінка

Головна сторінка сайту — незалежно від того, чи налаштована вона на показ останніх записів, чи на статичну сторінку.

front-page.html

home.html

index.html

front-page.html має пріоритет незалежно від вибору в Налаштування → Читання. Якщо головна сторінка — це статична сторінка, а front-page.html відсутній, обробка переходить до ланцюжка статичної сторінки, а не до home.html.

Стрічка записів блогу

Сторінка зі списком ваших останніх записів («сторінка записів» у Налаштування → Читання).

home.html

index.html

Окремий запис

Окремий запис блогу.

single-post-{slug}.html

single-post.html

single.html

singular.html

index.html

Окремий запис довільного типу

Окремий запис довільного типу вмісту (наприклад, «книга»).

single-{post-type}-{slug}.html

single-{post-type}.html

single.html

singular.html

index.html

Для типу запису «book» зі слагом «dune»: single-book-dune.html, потім single-book.html, потім single.html.

Статична сторінка

Звичайна сторінка WordPress.

page-{slug}.html

page-{id}.html

page.html

singular.html

index.html

Сторінка з довільним шаблоном

Сторінка, якій у панелі «Шаблон» редактора призначено довільний шаблон.

{custom-template}.html

page-{slug}.html

page-{id}.html

page.html

singular.html

index.html

Довільні шаблони оголошуються в масиві customTemplates файлу theme.json і зберігаються в /templates. Призначений шаблон має пріоритет над усім ланцюжком сторінки.

Архів рубрики

Архів зі списком записів однієї рубрики.

category-{slug}.html

category-{id}.html

category.html

archive.html

index.html

Архів мітки

Архів зі списком записів з однією міткою.

tag-{slug}.html

tag-{id}.html

tag.html

archive.html

index.html

Архів довільної таксономії

Архів для терміна довільної таксономії.

taxonomy-{taxonomy}-{term}.html

taxonomy-{taxonomy}.html

taxonomy.html

archive.html

index.html

Архів автора

Архів записів одного автора.

author-{nicename}.html

author-{id}.html

author.html

archive.html

index.html

Архів за датою

Архів за роком / місяцем / днем.

date.html

archive.html

index.html

Архів типу запису

Головна архіву для довільного типу запису, у якого встановлено has_archive.

archive-{post-type}.html

archive.html

index.html

Результати пошуку

Сторінка результатів пошуку по сайту.

search.html

index.html

404 (не знайдено)

Показується, коли жоден вміст не відповідає URL-адресі.

404.html

index.html

Сторінка вкладення

Сторінка окремого медіавкладення.

attachment.html

single.html

singular.html

index.html

Багато сайтів повністю вимикають сторінки вкладень (це малоцінний вміст). Якщо ви їх залишаєте, ось відповідний ланцюжок.

Сторінка політики конфіденційності

Сторінка, вибрана як політика конфіденційності сайту в Налаштуваннях.

page-privacy-policy.html

privacy-policy.html

page.html

singular.html

index.html

Чим це відрізняється від класичної (PHP) ієрархії

Шаблони — це файли .html у /templates, а не файли .php в корені теми. Немає single.php — є single.html.
Повторно використовувані області (шапка, підвал) — це ЧАСТИНИ шаблонів у /parts, на які посилаються за допомогою блоку wp:template-part, а не PHP-викликів get_header() / get_footer().
Немає ланцюжка get_template_part() і немає get_header()/get_footer(). Компонування виконується за допомогою блоку «Частина шаблону» всередині файлів .html.
index.html є ОБОВ'ЯЗКОВИМ. block theme без templates/index.html не є коректною block theme — це обов'язковий кінцевий резервний варіант для кожного з наведених вище маршрутів.
Тема вважається block theme завдяки НАЯВНОСТІ templates/index.html разом із theme.json, а не через якийсь прапорець у заголовку.
Ви можете редагувати будь-який із цих шаблонів у Редакторі сайту (Вигляд → Редактор) і зберегти зміни в базі даних — після чого вони ПЕРЕВИЗНАЧАЮТЬ файли теми, доки ви не скинете налаштування. Це дивує тих, хто намагається зрозуміти, «чому моя зміна шаблону нічого не робить».