.. include:: /Includes.rst.txt .. _introduction: ============ Introduction ============ .. _what-it-does: What does it do? ================ The extension `rte_ckeditor` provides a rich text editor (RTE) by integrating `CKEditor 5 `__ into TYPO3. This makes it possible to use the features of CKEditor when editing rich text fields in the TYPO3 backend or frontend (if frontend editing is used). Rich text fields are fields which may contain text with markup, for example for adding a style such as bold, using lists or enumerations, headlines or adding links. .. figure:: images/example_textfield.png :class: with-shadow Editing a textfield in the backend with rte_ckeditor. CKEditor is a :abbr:`WYSIWYG (what you see is what you get)` editor mostly written in JavaScript, and is used in many systems due to its flexibility. There are hundreds of free open-source plugins for CKEditor to enhance the editing experience. History ======= Before TYPO3 v8, a custom fork of "HtmlArea", another open-source WYSIWYG editor was shipped with TYPO3 Core in a separate extension `rtehtmlarea`. "HtmlArea" isn't supported anymore since TYPO3 v9 LTS. You have to migrate to `rte_ckeditor` when upgrading from previous TYPO3 versions (=< v8). CKEditor 4 was officially integrated as the default rich text editor in TYPO3 v8 LTS, within an extension called `rte_ckeditor`. With TYPO3 v12, CKEditor 4 has been updated to CKEditor 5. .. _features: Features ======== The extension `rte_ckeditor` incorporates the features of CKEditor and adds additional functionality, configuration presets and plugins. Some examples of features: * Configurable via YAML files * Configuration presets (minimal, default, full) for TYPO3 * Toolbar customization * Link functionality: integration with TYPO3 link wizard * Wordcount: plugin that counts and shows the chars/words/paragraphs in the footer of the editor. It also supports limiting the max. amount of chars/words.