HTML Fields
Field Types
Bloomreach Content provides two types of HTML fields: formatted text and rich text.
- Formatted text fields support basic text formatting, such as bold, underline, and lists. They do not support links or images.
- Rich text fields support advanced editing features, including links, images, tables, and other markup.
The table below summarizes the differences between these field types:
| Formatted text field | Rich text field | |
|---|---|---|
| Functionality | Basic text formatting: bold, underline, lists, and similar options | Advanced editing, including links, images, tables, and more |
| Supports links and images | No | Yes |
| HTML stored as | String property on the document | String property hippostd:content on a child node of the document |
Configuration
HTML field configuration is covered in the following sections:
- HTML field configuration properties:
Describes all configuration properties available for HTML fields in the document type editor. - HTML cleaning:
Explains how to configure client-side and server-side HTML cleaning.
CKEditor
The CMS uses a customized version of CKEditor 4 for editing HTML fields.
Versioning
CKEditor versions differ between Bloomreach Content editions and releases due to licensing requirements:
-
Developer Edition uses CKEditor 4.22.1-h1
-
Enterprise Edition uses CKEditor 4.25.0-lts-h1
The Enterprise Edition includes CKEditor through the Maven dependency
hippo-enterprise-package-cms-dependencies, which must be present in your Maven build.
For versions prior to those listed above, CKEditor 4.19.0-h2 is used.
Configuration
CKEditor configuration topics are organized as follows:
- CKEditor configuration properties:
Details the configuration propertiesckeditor.config.overlayed.jsonandckeditor.config.appended.json. - CKEditor plugins:
Lists available CKEditor plugins, and explains how to add, remove, or create custom plugins. - CKEditor toolbar configuration:
Describes how to configure the CKEditor toolbar. - CKEditor toolbar items:
Lists all available toolbar items for CKEditor. - CKEditor keyboard shortcuts:
Explains how to configure keyboard shortcuts in CKEditor. - CKEditor caching:
Describes how to configure browser caching for CKEditor resources. - Customize CKEditor Styles:
Explains how to customize the options in the CKEditor 'styles' combo box. - Customize CKEditor CSS:
Describes how to customize the styling of the CKEditor editing area and the 'styles' combo box.