Интеграция Verstka в сайт

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

Самая короткая версия интеграции:

В админке сайта появляется кнопка «Редактировать в Verstka».
Backend сайта запрашивает у Verstka URL редактора для конкретного материала.
Редактор открывается в отдельной вкладке.
После сохранения Verstka отправляет callback на сайт.
Сайт скачивает результат, сохраняет файлы, HTML и JSON у себя.
Публичная страница сайта выводит сохраненную статью.

Как это выглядит в админке

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

text

Ваш сайт
   |
   v
Ваша CMS / админка
   |
   +--> Обычный редактор CMS
   |        |
   |        v
   |    Обычная статья
   |
   +--> Кнопка «Редактировать в Verstka»
            |
            v
      Verstka Editor в новой вкладке
            |
            v
      Интерактивная публикация сохраняется обратно в CMS
            |
            v
      Публичная статья на вашем сайте

Главная идея: сайт остается владельцем материала. Verstka только дает инструмент для визуального редактирования и возвращает сайту готовый результат.

Что происходит технически

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

text

1. Website
      |
      |  material_id, callback_url, текущий vms_json
      v
   Verstka API
      |
      |  editor_url
      v
   Verstka Editor открывается в новой вкладке


2. Verstka Editor
      |
      |  Save
      v
   Callback на сайте
      |
      |  download ZIP
      v
   Распаковка ZIP: vms_html + vms_json + media
      |
      v
   Сайт сохраняет файлы, HTML и JSON
      |
      v
   Статья готова к выводу на сайте

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

Что нужно реализовать на сайте

Минимально нужно закрыть пять задач:

Добавить кнопку в админку и получать editor_url через SDK или API.
Создать callback route, куда Verstka придет после сохранения.
Сохранить медиа и шрифты в публичное хранилище сайта.
Записать vms_html и vms_json в таблицу статей.
Вывести сохраненный HTML на странице и подключить JS для отображения.

SDK помогает общаться с API: подписывать запросы, скачивать ZIP и обрабатывать callback, заменять публичные URL файлов и формировать ответ для Verstka.

Что хранит сайт

Обычно в CMS достаточно хранить:

vms_html - готовый HTML, который выводится на публичной странице.
vms_json - состояние редактора для следующего открытия статьи.
is_verstka - флаг, что материал нужно выводить как публикацию Verstka.

Для vms_html и vms_json выберите тип поля, который может вместить большой объем данных (например, TEXT/JSONB в PostgreSQL или LONGTEXT/JSON в MySQL). В этих полях храниться вся структура публикации, стили и данные для повторного открытия редактора.

Дальше

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

Дальше переходите к подробной инструкции по интеграции: Интеграция.

Интеграция Verstka в сайт ​

Как это выглядит в админке ​

Что происходит технически ​

Что нужно реализовать на сайте ​