Интеграция
Файлы Setka Editor подключаются как на страницу редактирования поста (для функционирования инструментов редактора), так и на страницу превью поста (для подключения стилей Сетки для страницы предпросмотра).
Файлы Setka Editor на странице редактирования поста:
- content_editor_files — JS и CSS файлы редактора (WYSIWYG интерфейс Setka Editor);
- theme_files — конфигурационные файлы JSON и составной CSS файл стилей Setka Editor.
Файлы Setka Editor на странице предпросмотра поста:
- pulbic.js — скрипты, запускающие интерактивные элементы поста (анимации, примечания, галереи и т.д.);
- Файлы стилей - запускаются на странице предпросмотра несколькими способами.
Все изменения стилей и настроек сеток автоматически отправляются на сайт клиента с помощью веб хуков. Чтобы изменения отразились в Drupal, нужно настроить получение обновлений с сайта editor.setka.io.
Setka Editor обращается к URL, указанному в поле Your site domains на странице Integrations в вашем личном кабинете Setka Editor.
Как только обновляется стиль в аккаунте Setka Editor, изменения отображаются в уже опубликованных постах, созданных с использованием этого стиля. Изменения могут отображаться с задержкой в зависимости от настроек обновления кэша на сервере клиента. Добавление новых элементов в стиль не отобразится в уже опубликованных постах.
С помощью опции Type of integration на странице настроек вы можете выбрать тип файлов, подключаемых к постам. Опция Default подключает только standalone стили, опция Legacy подключает combined CSS файлы.
Чтобы перенести хранение файлов с вашего локального сервера на Setka CDN, откройте страницу настроек модуля Setka Editor (admin/config/content/setka-editor) и поставьте галочку напротив опции Use files from Setka CDN.
К Setka Editor можно подключить своё хранилище изображений с помощью API, подробный процесс мы описываем в этой инструкции.
Стили Setka Editor
Тема Drupal обладает своими настройками – свой CSS и классы внутри CSS. Setka Editor частично деактивирует настройки темы путем сброса стилей (CSS reset), чтобы вы могли применять пользовательские стили постов, созданные в Управлени дизайн системой.
Большинство стилей элементов постов Setka Editor состоят из двух блоков:
- CSS reset - возвращает свойствам изначальное значение;
- Сами значения для отображения элементов в соответствии со стилями (шрифты, цвета, кегль и т.д.).
Совпадения в названии классов в Setka Editor и темах Drupal почти полностью исключены, поэтому вероятность конфликта стилей минимальна. Однако, если вы столкнулись с конфликтом стилей, пожалуйста, обратитесь к вашему Drupal-специалисту или в нашу службу поддержки.
Также, тема Drupal может определять ширину, доступную для вашего поста, или быть адаптивной и не иметь фиксированной ширины. Это влияет на финальный вид поста для каждого читателя в зависимости от ширины его экрана. Чтобы проверять верстку поста при различной ширине экрана, используйте меню View post as в левом верхнем углу вкладки Setka Editor.
Где хранится контент
Контент хранится в базах данных Drupal в формате JSON. При отображении контента, JSON-файл обращается к JS библиотеке Setka для корректного отображения страницы редактора.
Что лежит в файле JSON:
- HTML поста (схож с обычным Drupal WYSIWYG);
- Метадата для конвертирования сущностей в статью или лендинг (например, такие параметры вёрстки как post id, postTheme id, postGrid id).
Setka Editor может использоваться для любого текстового поля, на странице можно использовать только один виджет Setka Editor.