The online editors
Rich text fields, such as the intro and the body of an article or the description of a folder, are written with the online editor. It works like a small word processor inside the edit form: you type, choose headings and lists, add links, images and tables, and see the result as you work. This chapter explains the editors Exponential 6 offers, how to choose one, and how to use them.
One online editor, several editors
The online editor (the extension ezoe) edits every rich text field. It offers several editors, which it calls engines:
| Editor | What it is |
|---|---|
| TinyMCE 8 | The modern TinyMCE, with the dialogs of the online editor for links, embedded objects, custom tags, literal text and tables. A site makes it its default with one setting; the pictures of this manual show it. |
| Tiptap | A newer editor that edits inside the page itself, with find and replace, a context menu, cleaner pasting from Word and an AI menu where the site has one. It comes with the extension exp_oe_tiptap, so it is offered only where that extension is installed. |
| TinyMCE 3 | The editor of every earlier version. It is still the default of a new installation unless the site chooses another one. Where the administration has a strict content security policy, it cannot run there, and the page Online editor says so. |
All editors store the same text in the same way. A page saved from one looks the same on the site as a page saved from another, and you can switch between them at any time without losing anything.
A rich text field in TinyMCE 8: the toolbar above, the text, the element path below it, and the Editor switch.
The same field in Tiptap: another toolbar, the same text, and the same switch below it.
Which editor you get, and how to switch
The site decides the editor you start with (an administrator sets it). You can choose your own, and your choice is remembered for your user on every rich text field and every visit, until you choose again:
- Below each rich text field, the switch Editor lists the editors of the site, for example TinyMCE 8 | Tiptap. The one in use is marked. A click on another stores the draft with everything you typed, in every field, and opens the form again with that editor. Nothing is published.
- On the page Online editor (/ezoe/engine; in the administration add it to the address, for example /admin/ezoe/engine), every editor is listed with its version, a short description and its status. Choose Default of this site or one of the editors under Editor for text fields and press Save.
The page Online editor lists the editors of the site with their status, and lets you choose your own. On this site TinyMCE 3 cannot run in the administration.
The switch below the fields is not there when the site has turned it off; the page Online editor still works then.
The pages of this chapter
- Writing rich text: what rich text is, and writing it without the editor.
- Getting started: typing, paragraphs and lines, pasting, fullscreen.
- The toolbar: every button and dialog, in TinyMCE 8 and in Tiptap.
- Formatted text: headings, lists, alignment, classes and literal text.
- Embedded objects: images, files and other items inside the text.
- The element path: where the cursor is, and the properties of each element.
- Keyboard shortcuts
- The AI assistant in the editor
Installing the online editor and its settings are described for administrators in Installation and Settings.
What can go wrong
- The field shows tags instead of formatted text. The editor is switched off for you. Press Enable editor below the field.
- The editor does not load. Switch to another editor below the field, or reload the page. The text is safe either way. Tell an administrator which editor and browser you used.
- The text looks different on the site. The editor stores the structure of the text, not its look; the site's design decides fonts, sizes and colors. Check with Preview.
Read more
- Creating and editing content, in the help center.
- The online editor on TinyMCE 8, the feature page, with the settings.
- ezoe, the extension.
In this section
- The AI assistant in the editor Exponential Intelligence in the Exponential 6 edit form: filling a form from a brief, the buttons of each field, alt texts, the AI menu of Tiptap and the Intelligence tab, and how to use it responsibly.
- Requirements This topic has moved to Setting up the online editor.
- Setting up the online editor Setting up the online editor of Exponential 6: requirements, the engines TinyMCE 3, TinyMCE 8 and Tiptap, the default engine and the rights of the ezoe module.
- Writing rich text Rich text in Exponential 6 is structure, not layout: what that means for editors, where to read on, and writing rich text with tags when the editor is switched off.
- Online editor settings The settings that shape the online editor of Exponential 6: the engine, the toolbar, skins and content styles, custom attributes, uploads and pasting from Word.
Contributors
- Andrea Melo Maintainer
- André Rømcke Maintainer
- Ricardo Correia Maintainer
- Graham Brookins Updated Maintainer
Comments
Add a comment