Интеграция CMS Headless WordPress (WP REST API + фронтенд)

Когда headless WordPress оправдан?

У вас уже есть сайт на WordPress, но клиенты жалуются на медленную загрузку, а редакторы привыкли к админке. Переезжать на другую CMS — риск потерять контент и SEO-позиции. Headless WordPress оставляет админку для контента, а фронтенд переписывается на современном стеке (Next.js, React, Vue). Это даёт скорость SPA, гибкость компонентов и привычный редактор. Не стоит выбирать headless, если сайт строится с нуля и нет жёстких требований — обычный WordPress проще и дешевле.

Как мы это делаем: разбор на реальном кейсе

Для одного из проектов мы использовали WordPress + Next.js 14 с ISR. Исходные данные: 10 000 постов, 5 категорий, ACF-поля для портфолио. Проблема — страницы грузились за 4 секунды (LCP > 4s). После headless-интеграции LCP упал до 1.2 с, TTFB — с 800 до 120 мс. Снижение нагрузки на сервер в 3 раза (с 8 до 3 запросов на страницу).

Ключевые шаги:

• Настройка REST API — включили _fields для минимизации ответа, отключили неиспользуемые эндпоинты.
• CORS и безопасность — разрешили только домен фронта, добавили валидацию Origin.
• ACF в API — через register_rest_field добавили метаполя прямо в ответ.
• Next.js API-клиент — единый fetch с ISR revalidate.
• Webhook on-demand revalidation — при публикации поста WordPress отправляет POST на /api/revalidate в Next.js.

Результат: скорость загрузки выросла на 70%, SEO-трафик увеличился на 25% за месяц.

Техническая реализация: от REST API до on-demand revalidation

WP REST API: базовые эндпоинты и оптимизация

WordPress REST API включён с версии 4.7. Базовый URL: https://site.com/wp-json/wp/v2/. Критически важно использовать параметр _fields — по умолчанию ответ содержит десятки полей, большинство не нужно.

# Список постов с нужными полями
GET /wp-json/wp/v2/posts?_fields=id,title,slug,date,excerpt,featured_media&per_page=10

Как настроить CORS для headless WordPress?

add_action('rest_api_init', function () {
    remove_filter('rest_pre_serve_request', 'rest_send_cors_headers');
    add_filter('rest_pre_serve_request', function ($value) {
        $allowed_origins = ['https://frontend.site.com', 'http://localhost:3000'];
        $origin = $_SERVER['HTTP_ORIGIN'] ?? '';
        if (in_array($origin, $allowed_origins, true)) {
            header("Access-Control-Allow-Origin: {$origin}");
            header('Access-Control-Allow-Methods: GET, POST, OPTIONS');
            header('Access-Control-Allow-Headers: Authorization, Content-Type');
        }
        return $value;
    });
}, 15);

Расширение REST API: ACF и кастомные эндпоинты

add_action('rest_api_init', function () {
    register_rest_field('portfolio', 'acf', [
        'get_callback' => function ($post) { return get_fields($post['id']); },
        'schema' => ['type' => 'object'],
    ]);
    register_rest_route('app/v1', '/home', [
        'methods'  => 'GET',
        'callback' => function (WP_REST_Request $request) {
            return rest_ensure_response([
                'hero'     => get_fields(get_option('home_hero_page_id')),
                'featured' => array_map(fn($p) => [
                    'id' => $p->ID, 'title' => get_the_title($p), 'slug' => $p->post_name
                ], get_posts(['post_type' => 'portfolio', 'posts_per_page' => 3])),
            ]);
        },
        'permission_callback' => '__return_true',
    ]);
});

Интеграция с Next.js: ISR и preview mode

const WP_API = process.env.WP_API_URL;
export async function getPosts(params = {}) {
    const url = new URL(`${WP_API}/posts`);
    url.searchParams.set('_fields', 'id,slug,title,excerpt,date,featured_image_url,acf');
    const res = await fetch(url, { next: { revalidate: 60 } });
    if (!res.ok) throw new Error(`WP API error: ${res.status}`);
    return { posts: await res.json(), total: Number(res.headers.get('X-WP-Total')) };
}

Для preview mode добавляем API-роут /api/preview, который активирует draftMode и редиректит на нужный пост.

On-demand revalidation: WordPress → Next.js

При сохранении поста WordPress отправляет POST на /api/revalidate:

export async function POST(req: Request) {
    const { secret, slug } = await req.json();
    if (secret !== process.env.REVALIDATE_SECRET) return Response.json({ error: 'Forbidden' }, { status: 403 });
    revalidatePath(`/blog/${slug}`);
    revalidatePath('/blog');
    return Response.json({ revalidated: true });
}

Кэширование и производительность

REST API не кэшируется по умолчанию. Мы добавляем Redis Object Cache или Nginx-кэш для анонимных запросов. Это снижает TTFB на 30–50% и нагрузку на БД в 2 раза. Если у вас высокие требования к скорости — используем Edge Cache (Cloudflare) с purge по webhook.

Что входит в работу и сроки

• Настройка headless (CORS, ACF, эндпоинты) — 6–8 часов.
• Интеграция с Next.js (клиент, ISR, preview) — 1–1.5 рабочих дня.
• Webhook и on-demand revalidation — 3–4 часа.

Мы даём гарантию на код 3 месяца и бесплатную поддержку после деплоя. За 10+ лет мы интегрировали WordPress с десятками проектов — от лендингов до порталов с миллионами посетителей. Свяжитесь с нами — оценим ваш проект за один день.

Сравнение: Headless vs Традиционный WordPress

Headless WordPress — разумный выбор, когда важна производительность и контроль над фронтендом. Не подходит, если бюджет ограничен или нет команды фронтендеров. Получите консультацию: мы поможем выбрать архитектуру и оценим ваш проект бесплатно. Закажите интеграцию — первые результаты через 2 дня.

Дополнительные материалы: REST API и ISR.

WordPress разработка: кастомные темы, плагины и WooCommerce

Клиент приходит с готовым сайтом на WordPress — и первое, что я вижу в DevTools: 47 активных плагинов, страница весит 6.8 MB, TTFB 2.4 с, в консоли пять конфликтующих версий jQuery. Это не редкость, а стандарт «доделанного» сайта, выросшего из шаблона в нечто живое, но неуправляемое. Мы решаем такие задачи под ключ — от аудита до деплоя. Оценим ваш проект за один рабочий день, свяжитесь.

WordPress занимает 43% рынка CMS (данные Wikipedia) — не потому что идеален, а потому что предсказуем, обширно задокументирован и имеет экосистему под любую задачу. Задача инженера — использовать эту экосистему аккуратно, не превращая сайт в помойку зависимостей. Мы помогаем найти баланс между функциональностью и производительностью, опираясь на 10-летний опыт и 80+ выполненных проектов.

Архитектурные решения и частые проблемы

Блокировка рендеринга из-за плагинов

Plugin A загружает jQuery 3.6, Plugin B — jQuery 1.12, тема — свой jQuery Migrate. В итоге wp_enqueue_scripts отдаёт три разных версии библиотеки, рендеринг страницы блокируется на 800 мс ещё до начала парсинга основного контента. Решается через wp_dequeue_script, централизованный контроль зависимостей и перевод некритичных скриптов в defer/async.

N+1 запросы и их решение

Разработчик написал WP_Query в цикле — каждый пост генерирует отдельный SQL-запрос. На странице с 20 постами это 21+ запрос к базе. MySQL начинает тупить, сервер греется. Фиксируется через post__in с prefetch или через переход на wpdb->get_results() с JOIN. Query Monitor — первый инструмент для диагностики.

WooCommerce под нагрузкой

Магазин с 15 000 SKU, без object caching, без Redis — при 200 одновременных пользователях wc_get_product() убивает базу. Транзиент-кэш WordPress не спасает: он пишет в базу, увеличивая нагрузку. Реальное решение — Redis через wp-redis или Memcached, плюс wp_cache_set()/wp_cache_get() в кастомном коде.

Как выбрать архитектуру: headless или монолит?

Выбор зависит от требований к производительности и сложности интерфейсов. Headless (REST API / WPGraphQL + Next.js) даёт прирост TTFB до 50% и изоляцию фронтенда, но требует более сложной инфраструктуры. Монолитная тема проще в поддержке для контентных проектов, где SEO критично и нужен прямой доступ к WP Rewrite. Мы помогаем определить оптимальный вариант на этапе аудита. Переход на headless улучшает LCP в 2.5 раза по сравнению с монолитом при правильной настройке кэширования — это подтверждено на 30+ проектах.

Стек и подходы в WordPress разработке

Разработка тем. Не используем page builders типа Elementor для продуктовых сайтов — они генерируют раздутый HTML и привязывают клиента к визуальному редактору навсегда. Кастомная тема на базе _s (underscores) загружается в 4 раза быстрее, чем тема на Elementor. Вместо этого: кастомная тема или блочная тема для Full Site Editing, Tailwind CSS через Vite, TypeScript для сложного JS.

Gutenberg и блочная разработка. Начиная с WordPress 5.0, Gutenberg — это не редактор, а платформа. Разрабатываем кастомные блоки через @wordpress/scripts, регистрируем через register_block_type() с block.json. Серверный рендеринг через PHP для SEO-критичных блоков, клиентский — для интерактивных. Inner Blocks для составных компонентов.

REST API и headless. WordPres как headless CMS через WP REST API v2 или WPGraphQL. Типичная схема: WordPress на поддомене cms.example.com, Next.js фронтенд на основном домене. ISR (Incremental Static Regeneration) для страниц блога — страница регенерируется в фоне при обращении после истечения revalidate, не блокируя пользователя. Для аутентифицированных запросов — JWT через jwt-authentication-for-wp-rest-api или Application Passwords (встроено с WP 5.6). Подробнее о REST API — Wikipedia.

WooCommerce. Расширяем через хуки и фильтры — никогда не правим core-файлы. Кастомные типы продуктов через WC_Product extension. Для сложной логики цен — woocommerce_get_price_html и woocommerce_product_get_price. Payment gateways пишем с нуля, наследуя от WC_Payment_Gateway. Интеграция с 1С — через CommerceML или кастомный REST endpoint.

Производительность. Обязательный стек: Redis Object Cache + Full Page Cache (LiteSpeed Cache или WP Rocket) + CDN для статики + WebP через add_image_size() с конвертацией. Lazy load нативный (loading="lazy") плюс кастомный для критичных изображений выше сгиба — preload через <link rel="preload">.

Кейс из нашей практики: WooCommerce‑магазин, LCP 9:00 с → 1.8 с

Магазин электроники, 40 000 SKU, WooCommerce + кастомная тема. PageSpeed Insights: LCP 9.2 с, CLS 0.41, INP 680 мс.

Диагноз:

• Hero-изображение 3.8 MB JPEG, не оптимизированное, без srcset
• 23 плагина загружали JS/CSS на каждой странице, включая страницы продуктов
• wc_get_product() вызывался 60 раз на странице категории без кэширования
• Шрифты загружались через Google Fonts (дополнительный DNS lookup)

Что сделали:

• Hero — WebP 180 KB, <img fetchpriority="high" decoding="async">, srcset для 3 breakpoints
• Условная загрузка плагинов через is_product(), is_cart(), is_checkout() — убрали 80% лишнего JS
• Redis Object Cache, WC_Product prefetch через wc_get_products() с include
• Шрифты — self-hosted через @font-face, font-display: swap
• CLS победили через aspect-ratio на всех product card images

Результат: LCP 1.8 с, CLS 0.04, INP 140 мс. Core Web Vitals — зелёные. Клиент сократил расходы на хостинг на 240 000 руб в год после перехода на более дешёвый тариф, ставший возможным благодаря снижению нагрузки. Дополнительно замена 10 плагинов на один кастомный сэкономила ещё 80 000 руб в год на лицензиях.

Процесс работы

1. Аудит и аналитика. Анализ существующей кодовой базы, конкурентов, технических требований. Для нового сайта — семантическое ядро, UX-прототипирование.
2. Архитектура. Решаем: монолит или headless. Определяем Custom Post Types, Custom Fields (ACF или нативные register_meta()), таксономии.
3. Разработка. Локальное окружение: Docker (nginx + php-fpm + MariaDB). Git с pre-commit хуками для PHP CS Fixer и ESLint. Деплой через WP-CLI + SSH или Buddy.works CI/CD.
4. Тестирование. PHPUnit для кастомных плагинов. Playwright для E2E критичных сценариев (добавить в корзину → оформить заказ → подтверждение). Lighthouse CI в пайплайне — падаем, если Performance Score < 85.
5. Деплой и поддержка. Staging через WP Stagecoach или ручной клон. Мониторинг — UptimeRobot + Sentry для PHP ошибок. Обновления плагинов — через WP-CLI в тестовой среде сначала.

Как провести аудит WordPress сайта за 5 шагов?

1. Проверьте wp-config.php — включён ли WP_DEBUG и WP_DEBUG_LOG. В продакшене они должны быть выключены.
2. Откройте Query Monitor (или аналоги) и посмотрите количество запросов на главной. Норма — менее 30.
3. Запустите Lighthouse — обратите внимание на LCP, CLS, INP. Если LCP > 2.5 с, ищите блокирующие ресурсы.
4. Проверьте плагины на дублирование функционала (например, два плагина кэширования).
5. Сделайте нагрузочный тест с помощью Locust или k6 — 200 одновременных визитов не должны вызывать ошибки тайм-аута.

Что вы получите в результате

• Полностью кастомную тему или доработку существующей
• Настроенные объектное кэширование (Redis/Memcached) и Full Page Cache
• Оптимизированные медиафайлы (WebP, srcset, lazy load)
• Документацию по структуре кода и инструкции по обновлению
• Обучение контент-менеджеров работе с блоками Gutenberg
• Гарантию бесперебойной работы в течение 30 дней после деплоя
• Доступ к репозиторию с полной историей изменений

Ориентиры по срокам

Стоимость рассчитывается индивидуально после аудита требований. Получите консультацию для предварительной оценки.

Типичные ошибки при разработке на WordPress

• Прямое редактирование файлов темы — при обновлении темы все изменения теряются. Всегда используйте дочернюю тему или полностью кастомную.
• update_post_meta() в цикле — каждый вызов отдельный UPDATE. Для массовых операций применяйте $wpdb->update() или update_metadata_by_mid().
• Отключённый WP_DEBUG в разработке — скрытые PHP Notice засоряют error log и часто указывают на реальные проблемы.
• Хранение медиа в Git — wp-content/uploads в .gitignore, синхронизация через WP-CLI media import или rsync.
• Нет лимита на WP_Query — posts_per_page => -1 на странице с тысячами записей гарантирует таймаут.

Почему стоит доверить WordPress разработку профессионалам?

Мы на рынке более 10 лет, выполнили 80+ проектов, имеем сертификаты Automattic и опыт работы с WooCommerce на высоконагруженных площадках. Наши решения учитывают все нюансы: от совместимости плагинов до требований Core Web Vitals (рекомендации Google). После завершения проекта вы получаете не просто сайт, а документированную, тестированную и готовую к масштабированию платформу.

Для консультации и оценки вашего проекта — пишите или звоните. Мы отвечаем в течение часа в рабочее время. Закажите аудит уже сегодня.