HTML fields
Field types
There are two types of HTML fields in Bloomreach Experience Manager: formatted text and rich text. Formatted text fields only allow simple text editing, and do not support links or images. Rich text fields allow all possible markup, including links and images. The table below lists the main differences.
| Formatted text field | Rich text field | |
| Functionality | Simple text editing: bold, underline, lists, etc. | Complex text editing, including links, images, tables, etc. |
| Supports links and images | No | Yes |
| HTML stored as | String property of a document | String property 'hippostd:content' of a child node of a document |
Configuration
The configuration of HTML fields is explained in several sub-sections:
- HTML field configuration properties
All configuration properties available for HTML fields in the document type editor.
- HTML cleaning
How to configure client-side and server-side HTML cleaning.
CKEditor
HTML fields are edited in the CMS with a customized version of CKEditor 4.
Versioning
Because of a licensing issue, per versions 14.7.23, 15.7.1 and 16.2.0, there's a split in the versions used:
- Bloomreach Experience Manager Developer Edition contains CKEditor 4.22.1-h1
- Bloomreach Experience Manager Enterprise Edition contains CKEditor 4.25.0-lts-h1
Note: the Enterprise version is pulled in through Maven pom dependency "hippo-enterprise-package-cms-dependencies" that should be present in the Maven build.
Before above versions, the CKEditor version is 4.19.0-h2.
Configuration
The configuration of CKEditor is explained in several sub-sections:
- CKEditor configuration properties
Explanation of the configuration properties ckeditor.config.overlayed.json and ckeditor.config.appended.json.
- CKEditor plugins
A list of all available CKEditor plugins, instructions how to add and remove them, and an explanation about custom CKEditor plugins.
- CKEditor toolbar configuration
How to configure the CKEditor toolbar.
- CKEditor toolbar items
A list of all available CKEditor toolbar items.
- CKEditor keyboard shortcuts
How to configure keyboard shortcuts in CKEditor.
- CKEditor caching
How to configure the browser caching of CKEditor resources.
- Customize CKEditor Styles
How to customize the options in the 'styles' combo box of CKEditor.
- Customize CKEditor CSS
How to customize the styling of the CKEditor editing area and 'styles' combo box.