Блочный шаблон

В классической теме за вид одиночной записи отвечает single.php, в блочной — templates/single.html. Внутри не PHP, а та же разметка блоков, что и в содержимом записей: комментарии <!-- wp:... --> с настройками. Выбор файла подчиняется обычной иерархии шаблонов: для рубрики «Новости» WordPress сначала поищет category-news.html, затем category.html, archive.html и в конце index.html.

Пример шаблона записи

<!-- wp:template-part {"slug":"header","tagName":"header"} /-->

<!-- wp:group {"tagName":"main","layout":{"type":"constrained"}} -->
<main class="wp-block-group">
<!-- wp:post-title {"level":1} /-->
<!-- wp:post-content {"layout":{"type":"constrained"}} /-->
</main>
<!-- /wp:group -->

<!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->

Шапка и подвал подключаются как части шаблона из папки parts/: их правят один раз, и изменения видны во всех шаблонах.

Свои шаблоны для выбора в редакторе

Кроме шаблонов по иерархии, тема может предложить дополнительные — например, «Лендинг без шапки» для отдельных страниц. Их объявляют в theme.json, а файл кладут в templates/:

"customTemplates": [
  { "name": "page-landing", "title": "Лендинг", "postTypes": [ "page" ] }
]

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

Не путать с шаблоном типа записи

В документации по блокам встречается ещё одно значение: параметр template при регистрации типа записи. Это массив блоков, которые автоматически вставляются в новую запись — например, заголовок, галерея и таблица характеристик для карточки объекта. Он задаёт стартовое содержимое, а не макет страницы. В редакторе сайта блочные шаблоны правятся в отдельном режиме, о нём — в статье про режим редактирования шаблона.