RTE Setup
Complete guide for configuring the RTE (Rich Text Editor) with CKEditor image support.
Table of Contents
RTE Configuration
Basic Setup
Create or update your RTE preset configuration:
EXT:my_ext/Configuration/RTE/Default.yaml
imports:
# Import default RTE config
- { resource: "EXT:rte_ckeditor/Configuration/RTE/Default.yaml" }
# Import image plugin configuration
- { resource: "EXT:rte_ckeditor_image/Configuration/RTE/Plugin.yaml" }
editor:
config:
# Restore image plugin (default config removes it)
removePlugins: null
toolbar:
items:
- '|'
- insertimage
Copied!
Register Preset
EXT:my_ext/ext_localconf.php
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['default']
= 'EXT:my_ext/Configuration/RTE/Default.yaml';
Copied!
Enable Preset
Page TSConfig
RTE.default.preset = default
Copied!
Advanced RTE Configuration
Custom Allowed Extensions
editor.externalPlugins.typo3image.allowedExtensions
-
- type
-
string
- Default
-
Value from
$GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']
Comma-separated list of allowed image file extensions for the RTE image plugin.
Restricts which file types can be selected through the image browser.
Example:
editor: externalPlugins: typo3image: route: "rteckeditorimage_wizard_select_image" allowedExtensions: "jpg,jpeg,png,gif,webp"
Copied!If not specified, falls back to the global TYPO3 configuration at
$GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']
Multiple RTE Presets
Different configurations for different content types:
EXT:my_ext/Configuration/RTE/Simple.yaml
imports:
- { resource: "EXT:rte_ckeditor/Configuration/RTE/Minimal.yaml" }
- { resource: "EXT:rte_ckeditor_image/Configuration/RTE/Plugin.yaml" }
editor:
config:
removePlugins: null
toolbar:
items:
- insertimage
Copied!
Different presets for different fields
# Different presets for different fields
RTE.default.preset = default
RTE.config.tt_content.bodytext.preset = full
RTE.config.tt_content.header.preset = simple
Copied!