WordPress-плагин

WordPress-плагин Verstka добавляет в админку WordPress кнопку открытия редактора, принимает callback после сохранения, сохраняет медиа в wp-content/uploads и выводит публикацию на сайте.

Этот вариант подходит, если сайт уже работает на WordPress и вы хотите подключить Verstka без собственной backend-интеграции.

Что понадобится

Перед установкой подготовьте:

• архив плагина vms_wordpress_v2;
• api_key и api_secret проекта Verstka;
• публичный URL сайта, доступный редактору Verstka;
• доступ администратора к WordPress.

Если сайт закрыт Basic Auth, заранее подготовьте логин и пароль для callback: плагин передаст их Verstka, чтобы backend смог отправлять callback на сайт.

Установка

Через админку WordPress:

1. Откройте Plugins -> Add New.
2. Нажмите Upload Plugin.
3. Загрузите архив vms_wordpress_v2.
4. Нажмите Install Now.
5. Активируйте плагин.

Если устанавливаете вручную, распакуйте плагин в wp-content/plugins и активируйте его в разделе Plugins.

Настройка

После активации откройте:

Settings -> Verstka Backend v2

Заполните обязательные поля:

Настройка	Что указать
API key	Ключ проекта Verstka.
API secret	Секрет проекта Verstka для подписи запросов.
API URL	Обычно https://api.r2.verstka.org/integration.
Callback URL	Обычно https://your-site.example/wp-json/verstka/v2/callback.
Viewer script URL	Обычно https://go.r2.verstka.org/viewer-latest.js.

Обычно API URL и Viewer script URL можно оставить значениями по умолчанию.

Дополнительные настройки

Эти поля обычно можно не менять при первой настройке:

Настройка	Когда нужна
Media subdir	Если нужно изменить папку внутри wp-content/uploads, куда сохраняются медиа публикаций.
Fonts subdir	Если нужно изменить папку внутри wp-content/uploads, куда сохраняются шрифты.
Max content size	Если публикации могут приходить в больших ZIP-архивах.
Dev mode	Для более подробных ошибок во время настройки и отладки.
Verify callback user email	Если нужно дополнительно проверять email редактора из callback.
Basic Auth user	Если callback URL закрыт Basic Auth.
Basic Auth password	Пароль для Basic Auth callback URL.

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

Проверка подключения

После настройки проверьте диагностический endpoint:

https://your-site.example/wp-json/verstka/v2/test

Если плагин установлен и REST API WordPress доступен, endpoint должен ответить без ошибки. Если сайт закрыт, убедитесь, что Verstka сможет достучаться до Callback URL.

Как открыть редактор

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

Кнопка появляется после сохранения поста в WordPress. У поста должен существовать уникальный ID.

При первом открытии Verstka создаст новую публикацию. При повторном открытии плагин передаст сохраненный vms_json, и редактор откроет последнюю сохраненную версию.

Что происходит после сохранения

Когда редактор нажимает Save в Verstka:

1. Verstka отправляет callback на Callback URL.
2. Плагин скачивает ZIP с публикацией.
3. Медиафайлы сохраняются в wp-content/uploads.
4. HTML и JSON публикации сохраняются в данных поста.
5. Плагин возвращает Verstka обновленный JSON с публичными URL файлов.

После этого пост можно открыть на сайте. Плагин подставит сохраненный HTML в контент поста и подключит viewer script для интерактивности, эффектов и анимаций.

Шрифты

Если в Verstka используется свой набор шрифтов, плагин также принимает отдельный callback обновления шрифтов.

Плагин сохраняет:

• файлы шрифтов в wp-content/uploads;
• CSS с @font-face;
• JSON-описание шрифтов.

CSS шрифтов подключается на страницах, где выводятся публикации Verstka.

Если что-то не работает

Проверьте по порядку:

• плагин активирован;
• API key и API secret заполнены без лишних пробелов;
• Callback URL открывается снаружи сайта;
• REST API WordPress не заблокирован firewall, security plugin или Basic Auth;
• если сайт закрыт Basic Auth, логин и пароль указаны в настройках плагина;
• wp-content/uploads доступен для записи;
• Viewer script URL доступен из браузера читателя;
• если кнопки редактирования Verstka не появляются, проверьте сохранен ли пост.

Для понимания общего flow интеграции смотрите Интеграцию.