Skip to the content
Documentation

The online editors

No ratings yet

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.

The Body text field of an article in TinyMCE 8, with its toolbar, the text and the editor switch

A rich text field in TinyMCE 8: the toolbar above, the text, the element path below it, and the Editor switch.

The Body text field of an article in Tiptap, with its toolbar, the text 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 listing TinyMCE 3, TinyMCE 8 and Tiptap with their version and status, and the editor choice

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

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

In this section

Contributors

Comments

Add a comment

Comments are read by a moderator before they appear.