Headless WordPress: оставить админку, заменить рендер
Headless WordPress — прагматичная середина. Он не требует, чтобы редакция выучила новый редактор, чтобы финансы отказались от работающей подписки, а клиент перенёс десять лет контента. Он требует одного: перестать позволять WordPress рендерить страницу.
Коротко
- WordPress становится API контента, сайтом становится Astro.
- Админка остаётся привычной — тот же дашборд, роли, медиатека, ревизии.
- Ядро REST API или WPGraphQL отдаёт данные на сборку, структуру несут кастомные поля.
- Фронтенд становится статическим: быстрым и без PHP в момент запроса.
- WordPress вы всё равно эксплуатируете — обновления, плагины и рантайм PHP остаются вашей задачей.
Что такое headless WordPress на практике
Обычный сайт на WordPress делает две вещи: хранит контент и показывает его. Headless их разделяет. WordPress оставляет себе первую и отдаёт контент по HTTP, вторая достаётся фронтенду.
Читать контент можно двумя способами:
- REST API ядра —
/wp-json/wp/v2/posts,/pages,/mediaплюс свои эндпоинты, которые вы регистрируете. Плагины не нужны, работает из коробки. - WPGraphQL — альтернатива со схемой, которая забирает всё дерево страницы одним запросом; это заметно на медленных сборках.
Структуру дают кастомные поля. Advanced Custom Fields (или его открытый наследник Secure Custom Fields) превращает страницу в типизированные данные, а не в поток разметки блоков — и это самое важное решение в проекте на headless WordPress. Без него вы парсите HTML.
Кому подходит
- Командам, которые уже на WordPress: есть архив, обученная редакция и плагины, от которых зависит работа.
- Издателям, которым роли и редакционные процессы нужны сразу, а не после миграции.
- Клиентам, которым нужен современный фронтенд, но публикацию нельзя останавливать на квартал ради смены CMS.
- Проектам с фиксированным бюджетом на миграцию, где дорогая часть — не сайт, а переделка редакционного процесса.
Плохо подходит, когда установка WordPress уже стала обузой: брошенные плагины, неподдерживаемая версия PHP, тема, которую никто не понимает. В этом случае headless делает фронтенд быстрым, а настоящую проблему оставляет на месте.
Как связать с Astro
Забираем данные на сборке, пререндерим, деплоим статику:
// src/lib/wp.ts
const WP = import.meta.env.WP_URL
export async function getPosts() {
const res = await fetch(`${WP}/wp-json/wp/v2/posts?per_page=100&_embed`)
if (!res.ok) throw new Error(`WP: ${res.status}`)
const posts = await res.json()
return posts.map((p: any) => ({
slug: p.slug,
title: p.title.rendered,
date: p.date,
html: p.content.rendered,
}))
}
С WPGraphQL те же данные приходят одним запросом нужной формы — удобнее для страниц из гибких секций. В обоих случаях схема одинаковая: забрать, привести к своей модели контента, отрендерить своими компонентами.
Публикация запускает пересборку через вебхук: небольшой плагин или функция на стороне WordPress дёргает хук деплоя вашего хостинга. Для разделов, которые меняются ежечасно, включите рендеринг по запросу для конкретных маршрутов, остальное оставьте предрендеренным.
Две детали настройки кусают каждого ровно один раз. Аутентификация: сборка лишь читает опубликованный контент, поэтому достаточно пароля приложения с правами только на чтение — доступ на запись остаётся внутри админки. Постоянные ссылки: REST API живёт под /wp-json, и правила пермалинков, съедающие этот путь, заставляют API отвечать 404, похожими на отказ аутентификации. Обе правки — в одну строку, но уже после часа, потраченного на их поиск.
Сильные стороны
- Преемственность. Редакторы работают в знакомом инструменте, переучивать никого не нужно.
- Роли, ревизии, медиа. Годы редакционных возможностей, которые не надо переписывать.
- Настоящий путь миграции. Фронтенд теперь ваш код, поэтому уход с WordPress становится плановым решением, а не аварией.
- Скорость и стоимость. Статические страницы на CDN грузятся быстро и дешево отдаются.
- Большая экосистема плагинов вокруг контента: формы, CRM, переводы.
Слабые стороны
- PHP никуда не делся. Обновления, гигиена плагинов и поддерживаемый рантайм обязательны; уязвимости PHP 2026 года (CVE‑2026‑109618 и CVE‑2026‑109619) напоминают, что хост CMS — реальная поверхность атаки.
- Выход блочного редактора — это HTML, а не структура; без кастомных полей чистых компонентов не получится.
- Две системы в эксплуатации: два конвейера деплоя и два набора доступов.
- SEO переезжает в код. Мета‑теги, карты сайта и разметка становятся работой фронтенда.
- С изображениями нужно разбираться. WordPress генерирует свои размеры, конвейер Astro хочет свои.
Когда выбирать
Выбирайте headless WordPress, когда стоимость смены редакционного инструмента выше стоимости эксплуатации двух систем — это верно для большинства сложившихся издателей и для многих клиентов с десятью годами контента. Это же честная рекомендация, когда команда ещё не готова к CMS со схемой в коде, но оставить сайт как есть уже нельзя.
Если команда техническая и хочет CMS в репозитории, чище в долгую будет Payload. Если редакторам нужен визуальный предпросмотр, Storyblok даёт его из коробки.
Итог
Headless WordPress — мост, а мосты полезны, когда есть река. Вы сохраняете админку, роли и архив и получаете быстрый статический фронтенд, которым владеете, — ценой нормальной эксплуатации WordPress и переноса SEO, картинок и предпросмотра во фронтенд.
Сравнение с альтернативами — в материале какая headless CMS лучше для Astro, общая картина — на хабе headless CMS. Мы переводим сайты с классического WordPress на фронтенд на Astro, не останавливая публикации: это часть разработки сайтов, а логика решения изложена в материале почему мы не начинаем новые проекты на WordPress.
Юрий Осипов
Основатель, SEO и аналитика
Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.