API для кастомной интеграции Setka Editor С чего начать кастомную интеграцию?

С чего начать кастомную интеграцию?

Помимо установки Setka Editor Wordpress Plugin, вы можете интегрировать Setka Editor с другими CMS, например: Joomla, Drupal, 1CBitrix, Typo3 и т.д.

Setka Editor это WYSIWYG-редактор для изданий и блогов. Он позволяет наладить регулярный быстрый выпуск красивых и сложных постов без привлечения верстальщиков и предварительного создания макетов. Setka Editor состоит из двух частей:

  • JS редактор, встраиваемый на страницу редактирования поста в CMS
  • Style Manager  — веб-интерфейс на editor.setka.io для создания и редактирования фирменного стиля издания. Он позволяет создать стили постов (шрифты, заголовки, цвета) и сетки (задавать параметры для колонок, отступов и пробелов между колонками).

Интеграция Setka Editor и CMS проходит в два этапа:

  1. Интеграция со Style Manager — для обновления редактора и стилей из аккаунта Style Manager.
  2. Инициализация редактора на странице редактирования поста в CMS.

 

Как зарегистрировать и заполнить аккаунт

Для того, чтобы начать интеграцию, необходимо создать аккаунт (если у вас его еще нет) на https://editor.setka.io/signup. Заполните все обязательные поля и cвяжитесь с менеджером Setka Editor через форму Contact us для того, чтобы он активировал в вашем аккаунте поля для кастомной интеграции. После их активации в главном меню на editor.setka.io появится раздел Integration.

 

Что необходимо для интеграции:

  1. Ввести license key. В вашем личном кабинете вы можете найти license key. Для того, чтобы активировать подписку, на стороне своей CMS необходимо создать поле для ввода license key, не обязательно создавать поле в интерфейсе, достаточно добавить его в коде.
  2. Заполнить все поля* во вкладке Integration:

Editor config url - по этой ссылке вы будете получать в своей CMS актуальную версию редактора и обновления стилей, созданные в Style Manager. Так же при первой синхронизации вы получите `public_token`, необходимый для работы ряда функций редактора, например комментариев и вставки ембедов по ссылке.

Company status url - по этой ссылке вы будете получать информацию о подписке. Прошел/не прошел платеж, закончился пробный период и т.д. 

Server status url - по этой ссылке мы проверяем корректность проведенной интеграции.

* Указать имя локального сервера (localhost, 127.0.0.1) нельзя. Домену должен соответствовать публичный IP-адрес на DNS-серверах.

 

______________2017-06-29___16.52.34.png

 

Для корректной интеграции ссылки необходимо ввести с учетом протокола (http/https).

Последняя версия документации по API находится по адресу https://editor.setka.io/docs/api2/index.html.

Пример интеграции на Ruby on Rails: https://github.com/setkaio/grid-editor-integration

 

Кастомная интеграция: