Strapi на практике: переезд с WordPress на современный стек

Что такое Strapi CMS

Привет! Я Артем, fullstack разработчик в evilUnion. В этой статье расскажу про Strapi на примере реального проекта: как мы перенесли сервис с WordPress на Strapi и Astro, какие возможности Strapi для этого пригодились и что получилось в итоге.

StrapiStrapi

Strapi это CMS с открытым исходным кодом на Node.js. По сути это готовый бэкенд для контента: вы описываете сущности и поля, а Strapi создаёт под них таблицы в базе, админку для редактирования и API. В качестве базы можно использовать PostgreSQL, MySQL, MariaDB или SQLite.

В отличие от WordPress и других классических CMS, Strapi не занимается внешним видом сайта. Шаблонов и тем здесь нет, он только хранит контент и отдаёт его по API. Фронтенд пишется отдельно на любом стеке, а к тем же данным могут обращаться мобильное приложение, CRM или любой другой сервис.

Что есть из коробки:

  • Content-Type Builder: визуальный конструктор коллекций и полей в админке

  • компоненты и динамические зоны: переиспользуемые блоки, из которых редакторы сами собирают страницы

  • админ панель для редакторов с черновиками и публикацией

  • система пользователей, ролей и прав доступа

  • REST и GraphQL API, которые генерируются автоматически по модели данных

Все роуты API по умолчанию закрыты, доступ к каждой коллекции открывается явно для конкретной роли. Для сторонних сервисов есть API токены с ограниченным доступом, а пароли и служебные поля в ответ API не попадают.

Дисклеймер: примеры кода в статье упрощены, чтобы показать сами инструменты Strapi, и в таком виде не подходят для продакшена.

Почему мы выбрали Strapi

Это расширяемый и лёгкий в освоении фреймворк. Создаёшь коллекции в админке и сразу получаешь рабочий API, а дальше постепенно добавляешь свою логику, не переписывая то, что уже есть. Поэтому мы используем Strapi не только как CMS, но и как полноценный бэкенд в своих проектах.

Внутри Strapi работает на Koa, и расширить можно практически любой его уровень, от API до админки. База, авторизация, права и админка уже готовы, остаётся только бизнес-логика. У Strapi большое комьюнити, больше 73 тысяч звёзд на GitHub, и много готовых плагинов, а если нужного нет, можно написать свой.

Развернуть Strapi можно в облаке или на своём сервере. Во втором случае код, база и данные пользователей полностью под вашим контролем.

Кейс: переезд сервиса для врачей с WordPress на Strapi

Возможности Strapi покажу на примере нашего кейса: переезда с WordPress на Strapi и Astro. Это сервис с платной подпиской на медицинские материалы для врачей: статьи, клинические рекомендации, гайды в PDF и курсы. Аудитория большая, контента много, часть материалов открыта всем, остальное доступно по подписке.

Сайт работал на WordPress, подписки и оплаты были сделаны на плагинах. Со временем начались проблемы:

  • сайт медленно грузился, на мобильных Lighthouse показывал 44 балла

  • админка работала медленно, открытие и сохранение материалов занимало много времени

  • были взломы

  • данным во встроенной CRM сложно было доверять: цифры в разных разделах не сходились из-за внутренних фильтров, логику которых было трудно понять

Контент у проекта сложный: статьи с аккордеонами, таблицами и всплывающими пояснениями, страницы курсов из множества секций. А вокруг него своя бизнес-логика: оплаты и автосписания, промокоды, реферальная программа, личный кабинет, вход через соцсети. Поэтому нужна была не просто CMS, а бэкенд, где всё это собрано в одном месте.

Решили переезжать на Strapi для бэкенда и Astro для фронта. Переезд нужен был полный, со всеми данными, чтобы никто не потерял доступ к своим подпискам и платному контенту.

Забегая наперёд: Lighthouse на мобильных вырос с 44 до 100, а выручка по подпискам выросла на 225% к тому же периоду прошлого года.

Как устроен Strapi

Коллекции, schema.json и REST API в Strapi

Разберём на простом примере: коллекция «Статья» с заголовком, текстом и категорией. Модель можно создать в Content-Type Builder или описать вручную в schema.json, это одно и то же. Strapi по этой схеме создаёт таблицу в базе и поля в админке:

Content-Type Builder: коллекция статей с полями, связью с категориями и повторяемым компонентомContent-Type Builder: коллекция статей с полями, связью с категориями и повторяемым компонентом

{ "kind": "collectionType", "info": { "singularName": "article", "pluralName": "articles" }, "options": { "draftAndPublish": true }, "attributes": { "title": { "type": "string", "required": true }, "content": { "type": "richtext" }, "category": { "type": "relation", "relation": "manyToOne", "target": "api::category.category" } }}

После этого у статьи сразу появляются стандартные эндпоинты: GET /api/articles, GET /api/articles/:id, POST, PUT, DELETE. Писать для них ничего не нужно, достаточно открыть доступ нужной роли.

Права роли Public в Users & Permissions: для статей открыты только find и findOneПрава роли Public в Users & Permissions: для статей открыты только find и findOne

Когда приходит запрос, он проходит такой путь:

запрос → роут → middleware и policies → контроллер → сервис → Document Service API → база

Каждый шаг можно переопределить: middleware и policies проверяют запрос до контроллера, контроллер формирует ответ, а сервис содержит саму логику. Как добавлять свою логику, разберём в разделе про бэкенд.

Повторяющиеся блоки выносятся в компоненты, например «Вопрос и ответ» или «Карточка преподавателя». А динамическая зона позволяет редактору самому собирать страницу из разрешённых компонентов в нужном порядке.

Модель данных в Strapi: коллекции и компоненты

Всё разделили на две группы: контент и пользовательские данные. Всё, что живёт само по себе и на что можно сослаться, сделали коллекциями. Всё, что существует только внутри другой записи, сделали компонентами. Например, аккордеон внутри статьи это компонент, а категория статьи это отдельная коллекция со связью.

Для пользователей сделали отдельную коллекцию профиля, а не стали расширять стандартного пользователя из плагина users-permissions. От профиля идут связи к подпискам, платежам, купленным гайдам, промокодам, сессиям и избранному, а подписка связана с тарифом и платежами. Так по любой записи легко восстановить цепочку: кто купил, по какому тарифу, каким платежом и с каким промокодом.

Strapi и Astro: фронтенд для контентного сайта

Astro это фреймворк для быстрых сайтов, ориентированных на контент. В отличие от Next.js или Nuxt, которые отправляют в браузер JavaScript всего приложения, Astro по умолчанию отдаёт чистый HTML. Интерактивными становятся только отдельные компоненты, так называемые острова, и только они загружают свой код. Острова можно писать на React, Vue, Svelte и других библиотеках, а SSG или SSR выбирается для каждой страницы отдельно.

Сейчас Astro один из самых быстрорастущих фреймворков для контентных сайтов. Меньше JavaScript означает более быструю загрузку и хорошие показатели Core Web Vitals почти без дополнительной оптимизации, а это напрямую влияет на SEO. Синтаксис компонентов близок к обычному HTML, поэтому порог входа низкий, а готовые компоненты на React или Vue можно переиспользовать без переписывания.

Подробнее про сам Astro мы писали в отдельной статье: Обзор на Astro JS: опыт боевого проекта на 500+ тысяч страниц.

Как мы используем Astro со Strapi: SSR, кэш и prefetch

На сайте много страниц, и ведут они себя по-разному. Одни меняются редко, другие, например статьи и каталоги материалов, редакторы обновляют постоянно. В Astro это можно контролировать на уровне каждой страницы: основные страницы отдаются как статика, а часто меняющиеся рендерятся на сервере через SSR и кэшируются в nginx.

---// страница, которая собирается при билдеexport const prerender = true;---

Страница собирается на сервере из данных Strapi, а интерактивные части подключаются как React острова:

---const { data } = await fetchApi({ endpoint: 'articles', query: { filters: { slug } } });---

На сервере рендерится только открытый контент, а всё, что зависит от пользователя, догружается на клиенте: закрытые материалы, личный кабинет, уведомления. Поэтому страницы одинаковые для всех и их можно кэшировать в nginx, а если правку нужно показать сразу, кэш сбрасывается из админки Strapi.

Кэшированная страница отдаётся без обращения к Strapi, а prefetch в Astro начинает её загружать, как только пользователь наводит курсор на ссылку. Сейчас переход между страницами занимает около 0,5 секунды, на старом сайте он занимал 2,5.

Среднее время перехода между страницами по неделям: после переезда около 0,5 секундыСреднее время перехода по данным Яндекс Метрики между страницами по неделям: после переезда около 0,5 секунды

Работа с контентом глазами редактора

Для редакторов главное, чтобы с материалами было удобно работать и не приходилось звать разработчика по каждой мелочи.

Динамические зоны: конструктор страниц в Strapi

Вся работа с контентом идёт в Content Manager: слева список коллекций, внутри таблица записей с поиском, фильтрами и сортировкой. Запись открывается как форма с полями из модели.

Самое интересное начинается на страницах, которые собираются из секций. Например, на странице курса редактор нажимает «Добавить компонент» в динамической зоне и выбирает секцию: программа, преподаватели, тарифы, отзывы, FAQ. Секции можно перетаскивать, сворачивать и удалять, так что страница любой структуры собирается без разработчика. Связи с другими записями выбираются из списка с поиском: если преподаватель поменял фото, оно обновится на всех страницах, где он указан.

Страница в Content Manager: секции в динамической зоне и кнопки действий справаСтраница в Content Manager: секции в динамической зоне и кнопки действий справаMedia Library в Strapi

Изображения и файлы хранятся в Media Library. Её можно открыть отдельно или прямо из поля записи, файлы раскладываются по папкам, у изображений есть alt, подпись и обрезка. При загрузке Strapi сам создаёт копии нескольких размеров, чтобы на телефоне не грузить оригинал.

Media Library: окно редактирования изображения с alt, подписью и обрезкойMedia Library: окно редактирования изображения с alt, подписью и обрезкойРедактор текста: Markdown, Blocks и CKEditor 5

Встроенных редакторов Strapi, Markdown и Blocks, для сложных статей не хватало, например в них нет полноценной работы с таблицами. Поэтому мы поставили плагин с CKEditor 5: таблицы, выравнивание, индексы, спецсимволы, медиа и редактирование HTML.

CKEditor можно расширять своими плагинами. Мы дописали метки УДД и УУР для клинических рекомендаций, скрытие изображений и текста, горячие кнопки со всплывающими пояснениями и обработку Tab для вложенных списков. А выбор шрифта, размера и цвета текста убрали, чтобы оформление статей оставалось единым.

CKEditor в админке Strapi: панель с метками УУР и УДД, скрытием текста и изображенийCKEditor в админке Strapi: панель с метками УУР и УДД, скрытием текста и изображенийDraft & Publish: черновики и редиректы

У всех основных коллекций включены черновики: опубликованная версия и черновик хранятся отдельно, и на сайте остаётся старый вариант, пока редактор не нажмёт «Опубликовать».

Черновики пригодились и для редиректов. Если у статьи меняется адрес, старая версия остаётся в черновиках с полем redirect_url, и фронт делает по нему редирект. Так редактор управляет редиректами в той же админке.

Превью в Strapi 5

В Strapi 5 появилось встроенное превью, и это одна из самых полезных функций для редакторов. Кнопка «Открыть превью» показывает страницу прямо внутри админки так, как она будет выглядеть на сайте, а между черновиком и опубликованной версией можно переключаться.

Strapi сам не знает, как выглядит ваш сайт, поэтому превью нужно связать с фронтом. В конфиге админки указывается функция, которая по типу записи возвращает адрес страницы превью:

// config/admin.jspreview: { enabled: true, config: { allowedOrigins: [env('PREVIEW_URL')], async handler(uid, { documentId, status }) { const pathname = getPreviewPathname(uid, documentId); if (!pathname) return null; return `${env('PREVIEW_URL')}${pathname}?token=${env('PREVIEW_SECRET')}&status=${status}`; }, },},

На фронте страница превью проверяет секретный токен и рендерит запись теми же компонентами, что и сайт, без кэша, так что редактор всегда видит актуальную версию. Рядом с записью мы ещё добавили кнопки «Открыть страницу» и «Обновить кэш», чтобы срочную правку редактор мог выкатить сам.

Условные поля в Strapi

Чтобы форма записи не превращалась в простыню, часть полей показывается только по условию. Например, цена и пробная версия появляются у гайда, только если он отмечен как платный:

"price": { "type": "decimal", "conditions": { "visible": { "==": [{ "var": "isPremium" }, true] } }}

Поля гайда, которые показываются по условиюПоля гайда, которые показываются по условиюРоли и права редакторов

Редакторы работают под ролями с ограниченным доступом. Есть нюанс: на новое поле у кастомных ролей нет прав, и вместо него в форме появляется «No permissions to see this field». Права нужно выдавать вручную, об этом легко забыть.

Бэкенд на Strapi: своя бизнес-логика

Наш кейс это не только статьи и гайды, а полноценная платформа: личный кабинет, подписки и автосписания, покупки, промокоды, рефералка, вход через соцсети, уведомления и письма. Для такого проекта нужен бэкенд со своей бизнес-логикой, и Strapi закрывает и эту часть. Ниже основные инструменты, которые для этого есть.

Покажем их на одном сквозном примере: у статьи есть время чтения и счётчик просмотров, а раз в неделю отмечаются популярные материалы.

Кастомные роуты, контроллеры и сервисы

Если стандартных эндпоинтов не хватает, рядом с ними добавляются свои. Стандартный контроллер расширяется новым методом, а встроенные find, findOne и остальные продолжают работать. Саму логику лучше держать в сервисе: он доступен из любого места приложения, от контроллеров до крон задач.

// src/api/article/routes/custom.jsmodule.exports = { routes: [{ method: 'POST', path: '/articles/:documentId/view', handler: 'article.view' }],};// src/api/article/controllers/article.jsmodule.exports = createCoreController('api::article.article', ({ strapi }) => ({ async view(ctx) { await strapi.service('api::article.article').incrementViews(ctx.params.documentId); ctx.status = 204; },}));// src/api/article/services/article.jsmodule.exports = createCoreService('api::article.article', ({ strapi }) => ({ async incrementViews(documentId) { const article = await strapi.documents('api::article.article').findOne({ documentId }); await strapi.documents('api::article.article').update({ documentId, data: { views: (article.views ?? 0) + 1 }, }); },}));

Middleware

Middleware в Strapi это обычная Koa функция. Она может выполнить что-то до контроллера, а после await next() получить готовый ответ и изменить его. Например, проставить заголовки кэширования для публичных ответов API:

// src/middlewares/cache-headers.jsmodule.exports = (config, { strapi }) => { return async (ctx, next) => { await next(); if (ctx.method === 'GET' && ctx.url.startsWith('/api/articles') && ctx.status === 200) { ctx.set('Cache-Control', 'public, max-age=60'); } };};

Подключается он одной строкой в config/middlewares.js, глобально или только для нужных роутов. Это удобное место для проверок и правил, которые касаются сразу многих эндпоинтов.

Lifecycles

Lifecycles позволяют выполнить код до или после создания, обновления и удаления записи. Например, пересчитывать время чтения при каждом сохранении статьи:

// src/api/article/content-types/article/lifecycles.jsconst getReadingTime = (html = '') => Math.ceil(html.replace(/]+>/g, ' ').split(/s+/).length / 200);module.exports = { beforeCreate(event) { event.params.data.readingTime = getReadingTime(event.params.data.content); }, beforeUpdate(event) { if (event.params.data.content) { event.params.data.readingTime = getReadingTime(event.params.data.content); } },};

Хуки можно задать для конкретной модели или подписаться на события сразу всех моделей в одном месте, например чтобы отправлять изменения в другую систему.

Cron задачи

Крон задачи описываются прямо в конфиге сервера, отдельный планировщик не нужен. Например, раз в неделю отмечать самые просматриваемые статьи:

// config/server.jscron: { enabled: true, tasks: { '0 3 * * 1': async ({ strapi }) => { await strapi.service('api::article.article').markPopular({ limit: 10 }); }, },},

Плагины Strapi

С плагинами возможностей Strapi становится ещё больше. Они ставятся через npm или из Marketplace в админке и настраиваются в config/plugins.js. Ниже то, что пригодилось в нашем кейсе.

Marketplace Strapi со списком плагиновMarketplace Strapi со списком плагиновCKEditor

Плагин заменяет встроенный редактор Strapi на CKEditor 5. В нём есть таблицы, медиа, редактирование HTML, а набор кнопок на панели настраивается в конфиге. К CKEditor можно писать свои плагины, так мы добавили в редактор кнопки под медицинский контент. Подробнее про это мы писали выше в пункте «Редактор текста».

Поиск в Strapi на Meilisearch

Материалов много, и искать нужно как по всему сайту, так и внутри раздела, например только по гайдам. При этом врачи часто пишут слово в другой форме, с опечаткой или описывают тему своими словами.

Для поиска мы взяли Meilisearch. Это самостоятельный open source движок, но в Strapi он легко подключается через плагин. В админке появляется страница, где выбирают, какие коллекции индексировать, и дальше индекс обновляется автоматически при каждом изменении записи.

Страница плагина Meilisearch в админке: коллекции и их индексацияСтраница плагина Meilisearch в админке: коллекции и их индексация

В конфиге для каждой коллекции можно указать, какие связанные данные подтягивать в индекс и как преобразовать запись:

// config/plugins.jsmeilisearch: { config: { host: env('MEILISEARCH_HOST'), apiKey: env('MEILISEARCH_API_KEY'), article: { entriesQuery: { populate: { content: { populate: { accordion: true } } }, }, transformEntry({ entry }) { return { ...entry, contentPlain: stripHtml(entry.content), stemmedTitle: stemText(entry.title), }; }, settings: { embedders: { default: { source: 'huggingFace', model: 'sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2', }, }, }, }, },},

В индекс попадает весь текст статьи вместе с аккордеонами, а слова приводятся к основе. Опечатки Meilisearch прощает сам, а через открытую мультиязычную модель эмбеддингов работает ещё и поиск по смыслу. В итоге поиск гибридный: половина веса у совпадения слов, половина у смысла. Глобальный поиск ищет по нескольким индексам одним запросом, а поиск по разделу обращается к одному.

Очереди в Strapi на BullMQ

На фронте у нас работает модуль аналитики, который отправляет события: просмотры страниц, открытие аккордеонов, скачивания, клики по баннерам. Если записывать каждое событие в ClickHouse прямо в запросе, при большом трафике бэкенд начнёт тормозить.

Поэтому запись вынесли в очереди на BullMQ, библиотеке для фоновых задач поверх Redis. Для Strapi есть плагин, и очереди с воркерами доступны как обычный сервис:

// эндпоинт только ставит событие в очередь и сразу отвечаетconst queue = strapi.plugin('bullmq').service('queue').get('analytics');await queue.add('track', event, { attempts: 3, backoff: { type: 'exponential', delay: 2000 },});// воркер в фоне забирает события и пишет их в ClickHousestrapi.plugin('bullmq').service('worker').create(queue, async (job) => { await writeToClickHouse(job.data);});

Если задача упала, она повторится сама. Через те же очереди у нас работают выгрузки и отмена зависших платежей. А чтобы видеть, что с ними происходит, подключили Bull Board, веб-интерфейс с очередями и ошибками, который открывается отдельной страницей на сервере Strapi.

Документация Strapi API: OpenAPI и Swagger

Официальный пакет OpenAPI генерирует документацию по всем роутам. Стандартные эндпоинты описываются автоматически, а описания своих роутов мы дописывали с помощью ИИ агентов. В итоге у фронта и интеграций всегда есть актуальный Swagger.

Кастомизация админки Strapi

Если готового плагина под задачу нет, админку можно доработать самим. Она написана на React и расширяется через src/admin/app.js: можно добавить панель на страницу записи, кнопку в список записей, поле или целую страницу. Благодаря дизайн-системе Strapi доработки выглядят как родная часть интерфейса.

// src/admin/app.jsexport default { bootstrap(app) { const contentManager = app.getPlugin('content-manager'); // панель справа на странице редактирования записи contentManager.apis.addEditViewSidePanel([ActionsPanel]); // своя кнопка над списком записей contentManager.injectComponent('listView', 'actions', { name: 'category-order-sort', Component: CategoryOrderSort, }); },};

Например, редакторам нужно было самим менять порядок категорий на сайте. Готовый плагин для drag-n-drop приходилось настраивать у каждого администратора отдельно, поэтому мы написали свою кнопку «Поменять порядок», где категории просто перетаскиваются.

Своя кнопка «Поменять порядок» в списке записей и окно сортировкиСвоя кнопка «Поменять порядок» в списке записей и окно сортировки

CRM на Strapi API

В старой CRM на WordPress цифры в разных разделах не сходились. Поэтому новую CRM мы построили прямо на Strapi. Раз Strapi отдаёт всё через API, CRM не нужна своя база: это отдельное приложение на React и TypeScript, которое работает с тем же Strapi API, что и сайт. Пользователи, подписки и платежи в CRM и на сайте одни и те же, расхождений больше нет.

Для таблиц используются стандартные возможности REST API Strapi: фильтры, сортировка, пагинация на стороне сервера и выбор связей через populate. Поэтому CRM не загружает всех пользователей сразу, а запрашивает только нужную страницу, а колонки и фильтры менеджер настраивает под себя. Любую выборку можно выгрузить в Excel.

Вход в CRM работает через стандартный плагин Users & Permissions. Права настраиваются по разделам и действиям: кто может только смотреть пользователей, кто редактировать промокоды, кто запускать рекламу. Роли с наборами прав хранятся в обычной коллекции Strapi, поэтому новую роль администратор создаёт сам, без изменений в коде.

Фронтенд CRM писали с агентом Claude Code по спецификации: заранее описали в markdown типы данных, экраны и формат запросов к Strapi, разбили работу на этапы, а агент реализовывал их по очереди и вёл журнал изменений. У всех коллекций Strapi одинаковые эндпоинты, фильтры и пагинация, поэтому формат запроса хватило описать в спецификации один раз, а дальше агент применял его ко всем таблицам CRM.

В итоге в CRM на Strapi есть разделы пользователей, платежей, промокодов, рекламы, сегментов и аналитики. Ниже подробнее про самые интересные из них.

CRM: таблица пользователейCRM: таблица пользователейСегменты пользователей

Самая важная часть CRM это сегменты, группы пользователей, отобранные по правилам. Например, «врачи с активной подпиской, которая заканчивается через неделю» или «пользователи, у которых не прошло автосписание».

Сервис живёт на подписке, и важно вовремя обращаться к нужным людям: напомнить о продлении, предложить скидку тем, кто давно не заходил, показать баннер курса врачам нужной специальности. Типов правил больше двадцати, от статуса подписки и специальности до посещённых страниц и событий аналитики. Их можно комбинировать через AND и OR, а сегменты строить и по зарегистрированным пользователям, и по анонимным посетителям.

Конструктор сегментов в CRM: правила отбора, AND/OR и счётчик найденных пользователейКонструктор сегментов в CRM: правила отбора, AND/OR и счётчик найденных пользователей

Правила хранятся в JSON поле коллекции сегментов. Чтобы посчитать сегмент, дерево правил рекурсивно превращается в обычный фильтр Strapi:

async function evaluateNode(node) { if (node.logic) { const filters = await Promise.all(node.conditions.map(evaluateNode)); return node.logic === 'AND' ? { $and: filters } : { $or: filters }; } return evaluators[node.type](node);}const filters = await evaluateNode(segment.conditions);const users = await strapi.documents('api::profile.profile').findMany({ filters });

Свой язык запросов писать не пришлось, почти все правила сводятся к стандартным фильтрам Strapi. Сегменты пересчитываются в фоне каждые 30 минут через очередь, а для массовой вставки результата используется Knex, доступный через strapi.db.connection. Дальше сегменты синхронизируются со списками рассылок в Unisender и используются для показа рекламы.

Рекламный модуль

Реклама тоже управляется из CRM. Рекламная кампания это обычная коллекция в Strapi с тремя форматами: баннер в шапке, попап и баннер в личном кабинете. Баннер можно загрузить картинками, HTML5 архивом или собрать во встроенном конструкторе, в том числе в варианте для акций со скидкой и копируемым промокодом.

Перед запуском баннер смотрят в окне превью, которое растягивается и масштабируется под разные экраны. Для кампании задаётся, кому её показывать (всем или выбранным сегментам), на каких страницах и сколько раз за сессию. На сайте один эндпоинт Strapi определяет сегменты посетителя и отдаёт только подходящие баннеры, а показы и клики уходят в аналитику. В итоге маркетинг сам запускает рекламу на нужную аудиторию за несколько минут.

Аналитика: ClickHouse и Yandex DataLens

Дашборды собраны в Yandex DataLens поверх данных в ClickHouse и встроены прямо в CRM. Подписанный токен для встраивания выдаёт эндпоинт Strapi, поэтому ключ не попадает на фронт.

Миграция с WordPress на Strapi

Самой трудоёмкой частью переезда оказался не новый сайт, а данные: пользователи, подписки, платежи, купленные гайды, промокоды, избранное.

Как хранятся данные в WordPress

WordPress изначально задумывался как движок для блога. Почти всё, что не является пользователем, лежит в одной таблице wp_posts и различается полем post_type, а дополнительные поля хранятся в wp_postmeta и wp_usermeta в формате ключ и значение. Каждый плагин складывает туда данные по-своему, и чтобы просто собрать пользователя, приходится разворачивать десятки строк в одну:

SELECT u.ID, u.user_email, MAX(CASE WHEN um.meta_key = 'first_name' THEN um.meta_value END) AS first_name, MAX(CASE WHEN um.meta_key = 'telefon_lk' THEN um.meta_value END) AS phone, MAX(CASE WHEN um.meta_key = 'user_registration_select_1667036325' THEN um.meta_value END) AS status, MAX(CASE WHEN um.meta_key = 'user_registration_select_1667037133924' THEN um.meta_value END) AS specialtyFROM wp_users uLEFT JOIN wp_usermeta um ON um.user_id = u.IDGROUP BY u.ID;

Понять, что user_registration_select_1667036325 это статус пользователя, можно было только опытным путём, сопоставляя значения с сайтом.

За годы плагины ставились и удалялись, а таблицы и ключи оставались. Уже нельзя было сказать наверняка, какие данные актуальны, а документации к старой базе не было. После переезда без этого мусора объём базы уменьшился в 20 раз, с 1 ГБ до 50 МБ.

Проблемы данных WordPress при миграции

  • одно JSON поле в разных записях было то обычным JSON, то JSON внутри строки, то строкой с задвоенными кавычками

  • вместо пустых дат стояло 0000-00-00

  • у части сущностей не было связей по ID, гайды и тарифы сопоставляли по названию

  • у части пользователей нашлись дубли с одинаковой почтой

  • пароли хранились в разных форматах хэшей

На каждый случай приходилось писать отдельную обработку, поэтому большая часть времени ушла не на сам перенос, а на то, чтобы понять, что где лежит.

Как это выглядит в Strapi

В Strapi такой проблемы нет. У каждой коллекции своя таблица с явными колонками, структура видна в schema.json и в Content-Type Builder, а связи заданы явно. Новый разработчик сразу видит, какие есть данные и как они связаны, и не гадает, что значит ключ с числом в названии.

Как переносили

Перенос шёл скриптами по шагам: пользователи, потом тарифы, подписки и платежи, затем гайды, промокоды и реферальные ссылки. На каждом шаге сохранялось соответствие старых и новых ID, чтобы правильно проставить связи. Старый ID пользователя мы оставили в профиле, он потом пригодился для интеграций.

Пользователи и авторизация в Strapi

Одна из главных задач переезда: пользователь заходит со старым паролем и видит всё как раньше, подписку, платежи, купленные гайды и избранное.

Своя авторизация: VK, Яндекс и пароли из WordPress

В Strapi есть встроенная система пользователей с регистрацией, JWT, ролями и входом через внешних провайдеров. Нам её оказалось мало, и мы сделали свою авторизацию. Strapi это позволяет: стандартный плагин можно расширить или написать свою логику рядом.

Причины:

  • пользователь у нас это профиль с десятками полей и связей, и удобнее держать его одной коллекцией

  • нужно было ограничить количество устройств, с которых входят в один аккаунт

  • вход через VK и Яндекс с привязкой к уже существующему аккаунту

  • проверка старых паролей из WordPress

Всё это обычные роуты, контроллеры, сервисы и коллекции Strapi.

Проверка данных после миграции в админке Strapi

После переноса важно было убедиться, что у всех всё на месте, и тут сильно помогла админка Strapi. Менеджерам не нужно лезть в базу или просить выборку у разработчиков: в записи пользователя сразу видны подписки, платежи, купленные гайды, избранное, промокоды и сессии. Если человек писал, что у него что-то пропало, менеджер сам открывал профиль и разбирался.

Другие возможности Strapi

В нашем кейсе мы использовали далеко не всё, что есть в Strapi.

MCP сервер в Strapi: подключение ИИ агентов

В Strapi 5 есть встроенный MCP сервер. MCP это открытый протокол, через который ИИ агенты работают с внешними сервисами. Если его включить, к Strapi можно подключить Claude, Cursor или другой MCP клиент, и агент сможет искать, создавать, редактировать и публиковать записи:

// config/server.jsmodule.exports = ({ env }) => ({ mcp: { enabled: true, },});

Агент подключается через админ токен и получает ровно те права, что и владелец токена. Так ему можно поручить, например, разложить по категориям сотню статей, не давая лишнего доступа.

i18n, вебхуки, GraphQL, CLI и S3

  • Мультиязычность встроена в ядро: у записи появляются версии на разных языках, а какие поля переводить, выбирается отдельно

  • Вебхуки сообщают внешним сервисам о создании, изменении и публикации записей

  • GraphQL подключается официальным плагином, схема генерируется по моделям автоматически

  • CLI умеет экспортировать и импортировать данные вместе с файлами или переносить их напрямую между серверами, например с прода на стейджинг

  • Хранилище файлов можно заменить через провайдер на S3 или совместимое, медиатека при этом работает так же

Итоги

Strapi оказался удобным и для разработчиков, и для тех, кто работает с контентом. Разработчику он даёт готовую основу, в которой легко освоиться и постепенно наращивать логику, а контент-менеджеры сами собирают страницы, работают с медиа и публикуют материалы.

Скорость сайта на мобильных по Lighthouse:

Метрика

Было

Стало

Performance

44

100

First Contentful Paint

5,4 с

1,5 с

Largest Contentful Paint

6,1 с

1,5 с

Speed Index

7,1 с

2,1 с

Lighthouse до и после переезда: 44 и 100Lighthouse до и после переезда: 44 и 100

Переходы между страницами ускорились примерно с 2,5 до 0,5 секунды.

Бизнес показатели:

  • выручка по подпискам выросла на 225% к тому же периоду прошлого года

  • конверсия выросла на 90%

  • глубина просмотра выросла на 75%

Кроме цифр, у проекта появились своя CRM с сегментами и рекламой, своя аналитика и данные, которым можно доверять.

Источник: habr.com

0 0 голоса
Рейтинг новости
1
0
Подписаться
Уведомить о
0 комментариев