Rich text editor (CKEditor)
Throughout the Management Center, some objects contain fields in which we can perform text editing and formatting. For example, we can create a bulleted list or add HTML code to enhance the display of text on the storefront. The following fields in the Management Center support rich text editing:
Management Center tool Fields Catalogs tool
- The Long description field in the properties for a product, SKU, bundle, and kit.
- The Long description field in the properties for a category.
- The Long description field in the properties for a sales catalog.
Marketing tool
- The Email content field in the properties for an email template.
- The Text field in the properties for marketing content.
Promotions tool
- The Customer viewable long description field in the properties for a promotion under the Descriptions tab.
Commerce Composer tool
- The Display text field in the properties of the Text Editor widget.
CKEditor rich text editor
The default text editor in Management Center is the CKEditor. Management Center uses a customized version of CKEditor 4.2.2.1. The following image displays the available editing options with CKEditor:For more information about the various options in the toolbar, see Editing text in CKEditor.CKEditor supports two modes for editing content: editor mode and source mode.
- Editor mode: Edit content with the options in the toolbar and view the changes as we make them.
- Source mode: Add custom HTML code to edit content.
Important: CKEditor ensures that proper HTML is generated. As a result, when using CKEditor to edit content that contains HTML code, CKEditor might correct or remove code that the editor cannot interpret. This behavior rarely occurs but can produce unexpected results. IBM recommends that you back up content that you think might be affected before you use CKEditor. If you continuously encounter issues where CKEditor modifies HTML code, an IT developer can customize CKEditor to prevent the correction or removal of code. See CKEditor Developers Guide.
Advantages of CKEditor
CKEditor includes the following features:
- Edit content by using Undo, Redo, and Paste special options.
- Import different elements, such as tables, lines, and special characters.
- Use templates to provide a quick start for standardized content.
- Automatically correct broken HTML code to ensure that proper HTML is generated. For example, a store developer might provide HTML code to add to a rich text field. If the code contains a missing closing bold tag (</b>), CKEditor automatically inserts the missing tag.
The following table lists the capabilities of the CKEditor.
Editor features
Editor features CKEditor Edit/View source code X X Start from template X Cut X Copy X Paste X Paste as plain text X Paste special X Undo X Redo X Find and replace X Replace X Select all X Bold X Italic X Underline X Strikethrough X Subscript X Superscript X Remove format X Numbered list X Bulleted list X Increase indent X Decrease indent X Blockquote X Align left X Align center X Align right X Align justified X Text direction from left to right X Text direction from right to left X URL link X Remove link X Insert document bookmark X Insert image X Insert Flash movie X Insert table X Insert horizontal line X Insert special character X Style (for example Coding, Red title) X Paragraph format X Font X Font size X Text color X Background color X Maximize editor window X Show block X Spell check X
CKEditor browser limitations
For best results, use the Mozilla Firefox browser with CKEditor.
Browser Usage notes Google Chrome The CKEditor window might not open if we are using the Chrome browser because the browser does not support this type of modal window. For more information, IT developers can refer to . Internet Explorer You might encounter CKEditor limitations with some versions of Internet Explorer when we are formatting text and tables. The drop-down or right-click (context) menus in CKEditor might not display or work as expected.To avoid this issue with the drop-down and right-click menus, add the Management Center web server URL as a trusted site in Internet Explorer:
- Open Internet options, click the Security tab, and then click Trusted sites.
- Click Sites, and then add your Management Center server site to the list of trusted sites, for example:
https://mymanagementcenter.com- Clear the browser cache, and then close and reopen the browser.
Third-party rich text editors
If your company prefers to use a different rich text editor, IT developers can refer to .
- Editing text in CKEditor
Use CKEditor to edit rich text when working with objects in Management Center tools. CKEditor is embedded in certain fields that support rich text editing in the Catalogs, Promotions, Marketing, and Commerce Composer tools.