Help Center
Search…
Integrations
VIDEO TUTORIALS
Components Library
Content Experience Design Best Practices
Setka for Drupal — compatibility, and features
All about Setka Drupal module compatibility and features.
Setka Editor for Drupal — compatibility, and features
This article is intended to answer your questions about Setka Editor's technical qualities and compatibility features that are specific to Drupal CMS.
How Setka Module hooks up with Drupal
Setka integration module provides an input widget and a formatter to hook into Drupal form API and render API.
Do Setka Editor styles affect my Drupal theme?
Setka Editor styles are independent of any styles of your Drupal theme, so they do not influence each other.
How do Setka Editor styles work?
Each theme has its own CSS settings with CSS classes in it. Setka Editor partially overwrites theme settings using CSS reset, in order to allow you to use custom styles, created in Content Design System Manager.
Styles of most elements of a Setka Editor post consist of two main blocks:
- Properties themselves, which are required to properly display these elements (font, color, size, etc. in accordance with your style).
These styles apply to the elements within a Setka post only. They are quite specific, thereby ensuring that there are no conflicts with the styles of the platform and that Setka posts are displayed consistently regardless of what is around them and the CMS.
A Drupal theme may also determine the width available for your post. It may also be adaptive and have no fixed width. This influences the final appearance of the post for each reader, depending on the width of their screen.
In order to check the layout of the post at various screen widths, click the View post button in the top left corner of Setka Editor.
Where the content is stored
Content stored in the Drupal database (as a regular field) in JSON format. During the display, this JSON passed to the Setka JS library to render the page as in the editor.
This JSON contains:
- 1.Post's HTML (similar to regular Drupal's WYSIWYG);
- 2.Metadata needed for Setka Editor to convert particular contents to a well-looking article or a landing page (e.g. specific layout settings: post id, postTheme id, postGrid id).
You can use Setka Editor for any text field you want, but take a note for now that it is possible to use only one Setka Editor Widget on the page.
Integration
Setka Editor files launched both on the post editing page (for the operation of the editor tool), and on the post preview page (to connect Setka Editor styles to user’s content).
Setka Editor files on the post-editing page:
content_editor_files— JS и CSS editor files (WYSIWYG interface of Setka Editor).theme_files— JSON config file and a concatenated CSS file of user’s styles.
Setka Editor files on a post preview page
pulbic.js— scripts to launch interactive post elements (animations, footnotes, galleries, etc.)- style files — there are several ways to turn post styles on the post preview page
All the changes in styles and layout grids are automatically sent via webhook push events to the user’s domain.
In order to get these changes to be reflected in Drupal, the user needs to receive updates from editor.setka.io.
Setka Editor will address a URL, specified in the Editor Webhooks Endpoint field on the CMS Integration page (e.g.,
yourdomain.com/setka_editor_config) with the following request: POST yourdomain.com/setka_editor_config. For Drupal, the user will only need to specify a domain that will be used to run Setka Editor and makeup posts.
Once a Style Manager style is updated, the posts where these styles were used change to reflect the changes made to the style. However, the changes cannot be applied instantly. The delay depends on the cache update settings on the client-server. Adding new elements does not cause changes to old posts.
Graphic scheme of Setka Editor integration structure
To switch files storage from your local server to Setka CDN go to
admin/config/content/setka-editor and click on the checkbox next to the Use files from Setka CDN option.
Screenshot of Setka Editor configuration page in Drupal
A Type of integration option allows you to choose a type of files that you connect to your post. In case you choose Default, only standalone styles will be loaded, a Legacy option loads combined CSS file for your Setka Editor posts. You can activate it at
/admin/config/content/setka-editor
Screenshot of Setka Editor configuration page in Drupal
Media Library
Currently, Setka Editor is not compatible with the Media Library module or other modules for storing media asset files out of the box. This means that you can only download media assets from your computer.
Setka Editor has an API for connecting to any custom media library (DAM). It would be useful if you need to reuse your media assets.
We are planning to implement integration with the most popular modules soon.
Last modified 1yr ago
Copy link
Contents
Setka Editor for Drupal — compatibility, and features
How Setka Module hooks up with Drupal
Do Setka Editor styles affect my Drupal theme?
How do Setka Editor styles work?
Where the content is stored
Integration
Setka Editor files on the post-editing page:
Setka Editor files on a post preview page
Media Library