Миграция с WordPress на Headless CMS под ключ

Монолитный WordPress тормозит при 5000 публикациях? В админке каждый клик длится 3 секунды? Редакторы теряют терпение, а PHP-шаблоны не дают реализовать современный дизайн. Выход — headless-архитектура. Мы помогаем мигрировать сайты под ключ, сохраняя SEO-позиции и сокращая Time to Market. На фронтенде используем Next.js или Nuxt — SSR/SSG, ленивая загрузка, оптимизация Core Web Vitals. Контент-менеджеры работают в удобном интерфейсе, а разработчики вольны выбирать стек.

Headless CMS Wikipedia отделяет управление контентом от представления. Миграция требует тщательного планирования: инвентаризации контента, маппинга типов записей, настройки API и периода параллельной работы.

Оценка до начала

Перед выбором целевой CMS проводим аудит: инвентаризируем кастомные типы записей, поля ACF, используемые плагины (WooCommerce, Events Calendar), уровень подготовки контент-команды, бюджет на лицензии и требования к черновикам и preview. На основе этих данных выбираем платформу: Strapi для self-hosted, Contentful для SaaS с мощным редактором, Sanity для гибкой схемы. После миграции затраты на хостинг и лицензии снижаются до 60% — средняя экономия составляет от 2000$ до 5000$ в год.

Как выбрать Headless CMS?

Сравним популярные платформы:

Strapi превосходит KeystoneJS по размеру сообщества в 3 раза и по количеству готовых плагинов. GraphQL API позволяет выбирать только нужные поля, сокращая объём передаваемых данных в 2-3 раза по сравнению с REST. Стоимость лицензий headless CMS в среднем в 2-3 раза ниже, чем у корпоративных решений. На Next.js с headless CMS LCP в 2-3 раза ниже, чем на классическом WordPress, что подтверждают замеры Core Web Vitals.

Этап 1: Аудит и маппинг контента (1–2 недели)

Инвентаризация существующего контента:

# Экспорт из WordPress через WP-CLI
wp export --post_type=post,page,product --status=publish --path=/var/www/html

# Анализ ACF-полей
wp acf field-group export --group_id=all --output=json > acf-fields.json

# Статистика по типам
wp post list --post_type=post --format=count
wp post list --post_type=page --format=count

Маппинг WordPress → целевая CMS:

# mapping.yaml
wordpress_types:
  post:
    target: blogPost
    fields:
      post_title: title
      post_content: body (RichText)
      post_excerpt: excerpt
      post_date: publishedAt
      _thumbnail_id: featuredImage (Asset)
      categories: categories (Reference[])
      tags: tags (Reference[])
      acf.seo_title: seoTitle
      acf.seo_description: seoDescription
  product:
    target: product
    fields:
      post_title: name
      _regular_price: price (Number)
      _stock_qty: stock (Number)
      product_cat: categories
      acf.gallery: gallery (Asset[])

Как перенести контент без потерь?

Для этого пишем скрипты на TypeScript. Они через WP REST API получают записи, медиа и связи, а затем отправляют их в новую CMS через Management API. Код обрабатывает rate limiting, преобразует HTML в Markdown и загружает изображения.

// scripts/migrate-from-wp.ts
import axios from 'axios';
import * as contentful from 'contentful-management';
import TurndownService from 'turndown';

const turndown = new TurndownService({ headingStyle: 'atx' });

const cmaClient = contentful.createClient({ accessToken: process.env.CMA_TOKEN! });

async function migratePosts() {
  const space = await cmaClient.getSpace(process.env.SPACE_ID!);
  const env = await space.getEnvironment('master');

  let page = 1;
  while (true) {
    const { data: posts } = await axios.get(
      `${WP_URL}/wp-json/wp/v2/posts?per_page=100&page=${page}&_embed`
    );
    if (!posts.length) break;

    for (const wpPost of posts) {
      await migratePost(env, wpPost);
      await delay(200);
    }
    page++;
  }
}

async function migratePost(env: any, wpPost: any) {
  const featuredImageUrl = wpPost._embedded?.['wp:featuredmedia']?.[0]?.source_url;
  let imageAsset;
  if (featuredImageUrl) {
    imageAsset = await uploadAsset(env, featuredImageUrl, wpPost.title.rendered);
  }

  const entry = await env.createEntry('blogPost', {
    fields: {
      title: { 'en-US': wpPost.title.rendered },
      slug: { 'en-US': wpPost.slug },
      body: { 'en-US': turndown.turndown(wpPost.content.rendered) },
      excerpt: { 'en-US': wpPost.excerpt.rendered.replace(/<[^>]*>/g, '') },
      publishedAt: { 'en-US': wpPost.date },
      ...(imageAsset && {
        featuredImage: {
          'en-US': {
            sys: { type: 'Link', linkType: 'Asset', id: imageAsset.sys.id }
          }
        },
      }),
    },
  });

  await entry.publish();
  console.log(`Migrated: ${wpPost.title.rendered}`);
}

Этап 2: Настройка новой CMS (1 неделя)

Создание Content Types в целевой CMS точно по маппингу. Настройка валидаций, локализации, ролей. Этот этап делаем параллельно с аудитом.

Этап 3: Скрипт миграции (1–2 недели)

Код выше — пример для Contentful. Аналогичные скрипты пишем для Strapi через его REST API или для Sanity через mutation API.

Этап 4: Миграция медиафайлов

// Скачиваем и загружаем все медиафайлы WP
async function migrateMedia() {
  const { data: media } = await axios.get(`${WP_URL}/wp-json/wp/v2/media?per_page=100`);
  for (const item of media) {
    const asset = await env.createAsset({
      fields: {
        title: { 'en-US': item.title.rendered },
        description: { 'en-US': item.alt_text },
        file: {
          'en-US': {
            contentType: item.mime_type,
            fileName: path.basename(item.source_url),
            upload: item.source_url,
          },
        },
      },
    });
    await asset.processForAllLocales();
    await asset.publish();
    mediaIdMap[item.id] = asset.sys.id;
  }
}

Этап 5: Параллельный запуск и переключение

1. Запустить новый фронтенд на staging с реальными данными.
2. Провести редизайн-ревью с контент-командой.
3. Настроить автоматическую синхронизацию WordPress → новая CMS на период перехода.
4. DNS-переключение в low-traffic период.
5. Отключить WordPress через 2–4 недели после стабилизации.

Сроки типовой миграции