RTE Setup 

Complete guide for configuring the RTE (Rich Text Editor) with CKEditor image support.

Table of Contents

Automatic Configuration (Default) 

The extension automatically provides for the backend:

  • Preset: rteWithImages registered and enabled globally
  • Toolbar: insertimage button included in default toolbar
  • Configuration: Configuration/RTE/Default.yaml with full toolbar

Custom RTE Configuration 

Creating Custom Presets 

If you need to customize the toolbar or RTE behavior beyond the defaults, create a custom preset:

EXT:my_ext/Configuration/RTE/Custom.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:
    toolbar:
      items:
        - heading
        - '|'
        - insertimage
        - link
        - '|'
        - bold
        - italic
Copied!

Register Custom Preset 

EXT:my_ext/ext_localconf.php 
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['custom']
    = 'EXT:my_ext/Configuration/RTE/Custom.yaml';
Copied!

Enable Custom Preset 

Page TSConfig 
RTE.default.preset = custom
Copied!

Advanced RTE Configuration 

Custom Allowed Extensions 

editor.externalPlugins.typo3image.allowedExtensions

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!