Классическая и блочная тема WordPress: где заканчивается Gutenberg и начинается FSE
Блочный редактор WordPress (Block Editor, исторически связанный с проектом Gutenberg) отвечает за контент записей и страниц. FSE (Full Site Editing) - это набор возможностей WordPress для редактирования структуры сайта блоками и управления глобальными стилями: шаблонами, частями шаблонов, оформлением и настройками блоков. Классическая тема держит основную структуру в PHP и использует блочный редактор прежде всего для содержимого записей и страниц. При этом она может подключать отдельные возможности блочной системы, не становясь блочной темой. Блочная тема описывает структуру HTML-файлами с разметкой блоков и открывает ее для редактирования в Site Editor.
Окно блочного редактора контента в обоих случаях выглядит одинаково. Разница не в его интерфейсе, а в источнике структуры сайта и в том, где сохраняются изменения.
Блочный редактор, блочная тема и Site Editor - три разных уровня
Первый уровень - блочный редактор. Он создает и редактирует контент из блоков: абзацы, заголовки, изображения, собственные блоки проекта. Дальше в тексте для краткости используется привычное название Gutenberg, но технически имеется в виду именно Block Editor в составе WordPress.
Второй уровень - архитектура темы. WordPress различает классические и блочные темы. Классическая тема определяет шаблоны преимущественно через PHP. Блочная тема определяет шаблоны через HTML-файлы с разметкой блоков.
Третий уровень - Site Editor. Это интерфейс редактирования сайта блоками: шаблоны, части шаблонов, стили. Полноценное редактирование структуры сайта через Site Editor доступно для блочных тем. Классические темы поддерживают блочный редактор контента, но не полноценный Site Editor.
Такое разделение снимает ложное противопоставление «Gutenberg против FSE». Gutenberg работает в обеих архитектурах. FSE расширяет область применения блоков с контента на весь сайт.
Классическая тема и блочный редактор
Классическая тема задает структуру PHP-шаблонами. Типичный набор:
header.php- шапка;footer.php- подвал;single.php- отдельная запись;page.php- страница;archive.php- архивы.
functions.php - распространенный, но необязательный файл для подключения функциональности темы: скрипты, меню, поддержка возможностей. Архитектура не требует держать в нем всю логику. Код выносится в отдельные файлы и модули, а регистрация типов записей и таксономий - лишь одна из возможных задач, а не определяющий признак классики.
Блочный редактор в этой схеме отвечает за содержимое внутри the_content. Вы меняете текст и блоки страницы, а каркас, условия вывода, циклы и разметка остаются в коде:
<?php
// single.php - каркас в коде, контент из блоков
get_header();
while ( have_posts() ) {
the_post();
the_content();
}
get_footer();
Контроль разработчика в классике:
- разметка шаблонов и их иерархия;
- CSS, адаптивность, визуальная система;
- логика вывода: условия, циклы, запросы;
- шапка, подвал, навигация;
- собственные блоки под задачи проекта;
- произвольные типы записей и поля, например через ACF Pro.
В базовой классической теме контент редактируется в Gutenberg, а основная структура определяется файлами темы и версионируется вместе с кодом. Отдельные части шаблонов при необходимости можно сделать доступными для редактирования блоками, например через add_theme_support( 'block-template-parts' ).
Уточнение про theme.json: он не является признаком только блочной темы. Классическая тема тоже может содержать theme.json и настраивать через него палитру, типографику, отступы и параметры редактора. В классике структура остается в PHP, а theme.json дополняет тему настройками и стилями блоков и редактора. В блочной теме он играет более центральную роль.
Блочная тема и Site Editor
Блочная тема описывает структуру HTML-файлами с разметкой блоков. Типичная структура:
theme/
├── parts/
│ ├── header.html
│ └── footer.html
├── patterns/
├── templates/
│ ├── index.html
│ ├── single.html
│ ├── page.html
│ └── archive.html
├── styles/
│ └── dark.json
├── functions.php
├── style.css
└── theme.json
1. Назначение файлов и каталогов. Роль элементов такая:
templates/- шаблоны типов страниц, напримерsingle.htmlдля отдельной записи;parts/- повторяемые части: шапка, подвал;patterns/- готовые композиции блоков, которые можно вставлять в содержимое записей и страниц;styles/- вариации оформления, напримерdark.json;theme.json- настройки цветов, типографики, отступов и отдельных возможностей блоков;style.css- обязательный файл с заголовком темы и дополнительными стилями;functions.php- необязательный файл для регистрации функциональности, подключения скриптов и PHP-логики.
Механизм композиций доступен и классическим темам, поэтому сам по себе признаком блочной архитектуры не является.
Каталоги parts/, patterns/ и styles/ необязательны. Их наличие зависит от задач темы. При этом не все элементы блочной темы имеют формат HTML: композиции в patterns/ могут быть описаны PHP-файлами, а вариации в styles/ - JSON-файлами.
Один из определяющих признаков блочной темы - наличие шаблона index.html в каталоге templates/. WordPress также поддерживает прежний каталог block-templates/ для обратной совместимости.
2. Пример блочного шаблона. Шаблон templates/single.html может выглядеть так:
<!-- wp:template-part {"slug":"header","tagName":"header"} /-->
<!-- wp:group {"tagName":"main"} -->
<main class="wp-block-group">
<!-- wp:post-title /-->
<!-- wp:post-content /-->
</main>
<!-- /wp:group -->
<!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->
Здесь wp:template-part подключает повторяемые части шаблона, а wp:post-title и wp:post-content выводят заголовок и содержимое текущей записи. Весь каркас страницы описан блоками, а не PHP-вызовами в single.php. Это прямой аналог приведенного выше single.php, только каркас задан разметкой блоков.
3. Роль PHP в блочной теме. PHP никуда не исчезает: он по-прежнему используется для хуков, регистрации функциональности, серверной логики сложных запросов и интеграций. Блочная архитектура меняет способ описания шаблонов, а не всю архитектуру WordPress.
Что происходит с изменениями в Site Editor
Это главная архитектурная особенность блочной темы для сопровождения.
Измененные через Site Editor шаблоны и части шаблонов сохраняются в базе данных и имеют приоритет над соответствующими файлами темы. Пользовательские настройки глобальных стилей также хранятся в базе и могут переопределять значения из theme.json. Поэтому фактическое состояние сайта не всегда совпадает с исходным состоянием файлов в репозитории.
Конкретный сценарий расхождения выглядит так:
- Разработчик создал
templates/single.htmlи задеплоил тему. - Заказчик открыл шаблон в Site Editor и изменил расположение заголовка.
- WordPress сохранил пользовательскую версию шаблона в базе данных.
- Разработчик изменил исходный
single.htmlв репозитории и обновил файлы на сервере. - На сайте продолжает использоваться пользовательская версия из базы, а не обновленный файл.
Причина в порядке приоритета шаблонов: сохраненная в базе пользовательская версия имеет приоритет над соответствующим файлом активной темы. Поэтому обновление single.html само по себе не отменяет изменения, сделанные через Site Editor.
После шага 5 Git по-прежнему отражает состояние файлов в репозитории, но уже не полное состояние шаблонов на сайте. Файлы обновлены, а WordPress продолжает использовать сохраненную в базе версию.
Практические следствия:
- обновление файлов темы не обязательно заменит изменения шаблонов, сделанные в интерфейсе;
- правку в редакторе нельзя считать автоматически внесенной в исходники темы;
- при переносе, экспорте и откате нужно учитывать состояние шаблонов, частей шаблонов и пользовательских настроек глобальных стилей в базе, а не только файлы;
- для проекта нужен регламент: что правится в коде, что - в Site Editor, как изменения синхронизируются между окружениями.
Различие здесь не в интерфейсе, а в модели управления шаблонной структурой. В классической теме основная структура, как правило, определяется PHP-файлами и обновляется через код и деплой. В блочной теме разработчик также меняет файлы, но часть шаблонов и стилей может редактироваться через Site Editor и сохраняться в базе. Поэтому файловая версия темы не всегда совпадает с фактическим состоянием сайта.
Пользовательскую версию шаблона можно перенести обратно в файлы темы, например с помощью инструментов экспорта блочной темы. Расхождение не необратимо, но автоматического попадания изменений в Git при обычном сохранении через Site Editor нет.
Что меняется в поддержке сайта
Ни одна архитектура не проще другой в абсолютном смысле. У них разные точки контроля.
| Классическая тема | Блочная тема |
|---|---|
| Структура преимущественно в PHP | Структура преимущественно в HTML-разметке блоков |
| Изменения шаблонов через код и деплой | Изменения через код или Site Editor |
| Полноценное редактирование шаблонов через Site Editor недоступно | Шаблоны, части шаблонов и глобальные стили доступны для редактирования через Site Editor |
| Контроль изменений преимущественно через файлы и git | Нужно учитывать файлы и записи в базе данных |
theme.json необязателен, дополняет PHP | theme.json широко используется, формально не обязателен для всех случаев |
| Состояние сайта ближе к состоянию репозитория | Состояние сайта складывается из файлов темы и пользовательских изменений в базе данных |
Таблицу стоит читать как описание типичной организации работы, а не как жесткие ограничения платформы. Границы сдвигаются гибридными решениями.
Между классикой и блочной архитектурой есть промежуточные варианты. Гибридными обычно называют классические темы, которые используют отдельные возможности блочной системы, сохраняя PHP-шаблоны в качестве основы структуры сайта. Например, они могут применять theme.json для настройки глобальных стилей и редактора или подключать блочные части шаблонов, сохраняя основную структуру сайта в PHP.
Выбор сводится к двум вопросам: должен ли заказчик сам менять каркас сайта без разработчика и готовы ли вы сопровождать исходники темы и пользовательские изменения, сохраненные в базе данных. Если редактируемость каркаса не требуется, классическая тема или гибрид без пользовательского редактирования шаблонов и их частей дают меньше расхождений между исходниками и состоянием продакшена. Если требуется - блочная тема подходит, но перенос, откат и обновления проектируются с учетом кастомизации в базе.
Источники:
- Themes - Block Editor Handbook
- Introduction to theme.json
- Templates - Theme Handbook
- Bridging the gap: Hybrid themes
