TYPO3 + CKEditor: Alles, was Sie wissen müssen

Der weltweit beliebteste CKE-Editor wurde in TYPO3 integriert, und das war eine der großen Entscheidungen. An dieser Stelle möchte ich von der grundlegenden bis zur fortgeschrittenen Ebene der CKEditor-Integration und -Anpassung in TYPO3 CMS führen.

TYPO3 + CKEditor: Alles, was Sie wissen müssen

Der weltweit beliebteste CKEditor wurde in TYPO3 integriert, und das war eine der großen Entscheidungen. Hier möchte ich von der einfachen bis zur fortgeschrittenen Ebene der CKEditor-Integration und -Anpassung in TYPO3 CMS führen.

CKEditor hilft sowohl TYPO3-Entwicklern als auch Redakteuren - im Vergleich zu alten sogenannten htmlArea RTE-Redakteuren.

Teams, die ihre redaktionellen Workflows mit KI erweitern, können die AI Foundation für TYPO3 nutzen, um gemeinsam verwendete KI-Anbieter, Prompts, Berechtigungen und Kontexte zentral zu verwalten. Seit TYPO3 v8 ist der CKEditor Teil des TYPO3 Kerns und ersetzt das alte RTE."

Lassen Sie uns mit einer Schritt-für-Schritt-Anleitung des TYPO3 CKEditor mit Einrichtung, Konfigurationen, Anpassung, Installation von Plugins und vielem mehr beginnen.

Kurze Antwort: TYPO3 liefert CKEditor 5 in der Core-Extension rte_ckeditor aus. Sie konfigurieren ihn mit YAML-Presets: Registrieren Sie eine Preset-Datei in der ext_localconf.php Ihres Sitepackages, legen Sie Toolbar-Einträge, Überschriften und Styles unter editor.config fest und aktivieren Sie das Preset per Page TSconfig mit RTE.default.preset. Eigene Plugins sind ES6-Module, die über importModules geladen werden.

Das Wichtigste in Kürze

  • TYPO3 v12, v13 und v14 nutzen CKEditor 5. TYPO3 v8 bis v11 nutzten CKEditor 4. CKEditor-4-Plugins und Optionen wie toolbarGroups, removeButtons oder stylesSet funktionieren in CKEditor 5 nicht.
  • Der Core bringt drei Presets mit: default, minimal und full. Aktiv ist "default", solange Sie kein anderes Preset wählen.
  • Neue Presets werden in $GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets'] in der ext_localconf.php registriert. Diese Einstellung lässt sich nicht im Backend ändern.
  • Per Page TSconfig wählen Sie das Preset je Seitenbaum, Feld oder Inhaltstyp, zum Beispiel mit RTE.config.tt_content.bodytext.preset.
  • Zwei Ebenen entscheiden, welches HTML erhalten bleibt: htmlSupport im Editor und die Processing-Regeln aus Processing.yaml beim Speichern. Behalten Sie den Import von Processing.yaml bei, er enthält Sicherheitsmaßnahmen.
  • In TYPO3 v14 folgt der Editor im Backend standardmäßig dem hellen oder dunklen Modus des Systems, und das PSR-14-Event AfterRichtextConfigurationPreparedEvent erlaubt Änderungen an der RTE-Konfiguration in PHP.

Getestet mit / gültig für: TYPO3 v13.4 LTS und v14.3 LTS (Systemextension rte_ckeditor mit CKEditor 5). Abschnitte mit dem Zusatz "(CKEditor 4)" beschreiben TYPO3 v8 bis v11.

Aktualisiert: November 2026

Grundlegend handelt es sich um einen WYSIWYG-HTML-Editor der Enterprise-Klasse mit breiter Browser-Kompatibilität und älteren Browsern.

  • Einfaches Kopieren/Einfügen aus Word und Excel, Rechtschreibprüfung, Zugänglichkeitsprüfung, Tabellen.
  • Breite Palette von Plugins von Drittanbietern, z.B. Autovervollständigung, Widgets, Code-Schnipsel, emoji ? plugins.
  • Bessere Kontrolle über den Inhalt: HTML-Filter und Ansichtsmodus des Quellcodes
  • Hervorragende Zugänglichkeit: WCAG 2.0 AA und Abschnitt 508 konform.
  • Langzeit-Unterstützung (LTS)-Versionen

Lesen Sie mehr auf der offiziellen Website CKEditor.com

CKEditor ist ein Feature eines Drittanbieters, das in TYPO3 über die Systemerweiterung namens EXT:rte_ckeditor einsatzbereit ist. TYPO3-Benutzer haben jetzt einen coolen Editor, mit dem sie ihre Inhalte einfach verwalten können.

21.000+ tests

27M+ downloads

400+ plugins

23.000+ Fragen

Kein Problem, probieren Sie diese kurze Demo jetzt selbst aus 
ckeditor.com/ckeditor-4/demo/#article

Die Erweiterung rte_ckeditor enthält die Funktionen von CKEditor und fügt zusätzliche Funktionalität, Konfigurationsvoreinstellungen und Plugins hinzu.

Schlüsselmerkmale der Stichprobe

  • Konfigurierbar über YAML-Dateien
  • Voreinstellung drei gebrauchsfertige CKEditor, die in TYPO3 voreingestellt sind
  • Flexibel zu modifizieren der Symbolleiste
  • Integriert mit dem TYPO3-Link-Assistenten
  • Beliebtestes Wortzahl-CKEditor-Plugin in TYPO3 integriert
  • Man muss es nicht vollständig von der TYPO3-Community pflegen, da andere coole OpenSource-Projekte bereits gut entwickelt und gepflegt werden, z.B. CKEditor.
  • CKeditor hat gute Cross-Browser & Cross-Kompatibilitäts-Unterstützung
  • Einhaltung der neuesten TYPO3 Barrierefreiheit und Web-Barrierefreiheits-Standards
  • Kühle Inline-Bearbeitungsfunktionen, die zu einer besseren Frontend-Inline-Bearbeitung beitragen
  • Erweiterte Inhaltsfilter unterstützen

Der alte htmlArea RTE ist seit TYPO3 v8 veraltet.

Wenn Sie eine alte TYPO3-Website mit RTE htmlArea haben und die Migration zu CKEditor schwierig ist, dann kein Problem – Sie können weiterhin Updates sowie weiteren TYPO3 Support & Wartung bei FriendsOfTYPO3/rtehtmlarea finden.

TYPO3 RTE-Bearbeitungsmodi

Modus 1: Klassischer Artikelmodus
Das im TYPO3 Backend integrierte Standard-RTE, z.B.: Hinzufügen eines Textelements get RTE.

Modus 2: Dokument-Editor-Modus
Die Bearbeitung erfolgt wie in Microsoft Word oder Google Docs, wobei das Dokument selbst ein Blatt Papier imitiert. Der Schwerpunkt liegt auf der Strukturierung des Inhalts und nicht hauptsächlich auf dem Layout selbst.

Modus 3: Inline-Editor-Modus
Leider hat TYPO3 keine Frontend_Editing-Projekte innerhalb des TYPO3-Kerns erhalten. Sie können es von TER.

aus verwenden.

Grundlegende Funktionen von CKEditor in TYPO3

Beispiel: Fettdruck verwenden
Markieren Sie den Text und klicken Sie auf die Schaltfläche B (für fett):

Beispiel: Einen Link erstellen
Markieren Sie den Text und klicken Sie auf die Schaltfläche Link:

TYPO3 v12 führte CKEditor 5 ein, einen vollständig neuen und neu geschriebenen Editor im Vergleich zum vorherigen CKEditor 4, der seit TYPO3 v8 in TYPO3 integriert war. Wenn Sie eine ältere Version von TYPO3 verwenden, müssen Sie ein TYPO3 Upgrade von TYPO3 8 auf TYPO3 9 oder eine höhere Version durchführen, um die Vorteile des CKEditor RTE nutzen zu können.

Integration von CKEditor 5

TYPO3 v12 führt CKEditor 5 als Standard-Rich-Text-Editor ein und ersetzt damit CKEditor 4. CKEditor 5 verfügt über eine völlig neue Architektur und viele moderne Funktionen.

Neues Plugin-System

CKEditor 5 verfügt über ein neues Plugin-System, das nicht mit CKEditor 4-Plugins kompatibel ist. Das bedeutet, dass alle benutzerdefinierten Plugins oder Konfigurationen neu geschrieben werden müssen, um mit CKEditor 5 zu funktionieren.

Änderungen an der CKEditor 5-Konfiguration

Dazu gehören Änderungen an der Konfiguration der Symbolleiste, der Plugin-Verwaltung und anderen Einstellungen. Entwickler müssen ihre Konfigurationen an die neue Struktur anpassen.

Anpassungen und Erweiterbarkeit

Während CKEditor 5 erweiterte Anpassungs- und Erweiterungsmöglichkeiten bietet, ist der Ansatz ein anderer. Entwickler müssen sich mit den neuen Methoden vertraut machen, um den Editor effektiv zu erweitern und anzupassen und so eine effiziente TYPO3 Entwicklung sicherzustellen.

Sicherheitsverbesserungen

CKEditor 5 enthält verbesserte Sicherheitsfunktionen zum Schutz vor häufigen Schwachstellen, die mit Rich-Text-Editoren verbunden sind.

T3AI Co-Pilot, Teil der leistungsstarken T3AI TYPO3 AI Erweiterung, ist Ihr Assistent zur Vereinfachung des Content-Managements innerhalb von TYPO3 CMS. Mit speziellen Funktionen entwickelt, verbessert T3AI Co-Pilot Ihre Prozesse zur Inhaltserstellung, Übersetzung und Optimierung direkt im TYPO3 Rich Text Editor (RTE). Vom Erstellen neuer Inhalte über die präzise Übersetzung bis hin zur SEO-Optimierung hilft T3AI Co-Pilot, jeden Schritt zu optimieren und Ihre TYPO3-Erfahrung effizienter zu gestalten.

Da der CKEditor die YAML-Konfiguration umfasst, ist es unerlässlich, Vorkenntnisse über YAML-Dateien zu erwerben.

YAML (ein rekursives Akronym für "YAML Ain't Markup Language") ist eine von Menschen lesbare Serialisierungssprache für Daten. Sie wird häufig für Konfigurationsdateien und in Anwendungen verwendet, in denen Daten gespeichert oder übertragen werden.

Es ist sehr einfach, versuchen Sie Google mit einigen Beispielen, um das Konzept und die Syntax zu lernen.

"Wussten Sie?
Der RTE CKEditor wurde nicht mehr in PageTSConfig TypoScript konfiguriert, Alles wird über cool-YAML verwaltet."

Anstelle von etwas kompliziertem TypoScript entscheiden sich das TYPO3-Kernteam und die Community für berühmte gut strukturierte YAML-Konfigurationen.

  • CKEditor verwendet JavaScript für die Integration
  • TypoScript mit TSConfig ist etwas hart neue TYPO3 Integratoren und Entwickler
  • Neustart für eine neue Struktur zur Trennung von Verarbeitung und editorbezogener Konfiguration
  • Erlauben, dass Optionen erweitert werden (aber keine Bedingung oder nicht gesetzte Werte)

CKEditor hat Standardvoreinstellungen, um verschiedene Varianz einfach zu konfigurieren, Was ist voreingestellt?

  • Aussehen und Layout des Editors festlegen
  • Definieren Sie, welche Tags und Stile erlaubt sind
  • Definieren Sie, welche Plugins geladen werden sollen
  • Definieren der Datenbankverarbeitung RTE.proc

Voreinstellung: TYPO3-CKEditor-Voreinstellung

Minimal: TYPO3-CKEditor-Voreinstellung

Schritt 1. Gehen Sie zu System > Konfiguration
Schritt 2. Wählen Sie $GLOBALS['TYPO3_CONF_VARS'] (Globale Konfiguration)

Legen Sie ein YAML-Preset in Ihrem Sitepackage an, registrieren Sie es in der ext_localconf.php und wählen Sie es per Page TSconfig aus. Die offizielle Best Practice empfiehlt, die Core-Datei typo3/sysext/rte_ckeditor/Configuration/RTE/Default.yaml als Vorlage zu kopieren und die drei Core-Imports am Anfang der Datei zu behalten.

Die Systemextension rte_ckeditor gehört zum TYPO3-Core (Composer-Paket typo3/cms-rte-ckeditor). TYPO3 aktualisiert den mitgelieferten CKEditor 5 mit den Patch-Releases: TYPO3 v12.4.0 brachte CKEditor 5 v37 mit, v13.4.0 die v43, und die aktuellen Branches 13.4 und 14.3 setzen ckeditor5 v48 voraus (Build/package.json).

Greifen mehrere Einstellungen, gilt diese Reihenfolge: ein Preset für ein bestimmtes Feld im Page TSconfig, dann richtextConfiguration im TCA, dann das allgemeine Preset im Page TSconfig, dann "default" (Configuration Concepts).

MethodeFunktioniert inGeeignet fürZu beachten
Page TSconfig RTE.default.presetv11 bis v14Ein Preset für eine Website oder einen SeitenbaumDas Preset muss vorher registriert sein
Page TSconfig RTE.config.[table].[field].preset und .types.[type].presetv11 bis v14Unterschiedliche Editoren je Feld oder InhaltstypHier überschriebene YAML-Optionen ersetzen Arrays und können keine Booleans setzen
TCA richtextConfigurationv11 bis v14Felder Ihrer eigenen ExtensionEin Feld-Preset aus dem Page TSconfig hat Vorrang
PSR-14 AfterRichtextConfigurationPreparedEventv14Finale Konfiguration in PHP anpassenIn v13 nicht verfügbar

Die drei folgenden Schritte ergeben ein funktionierendes Preset. Kopieren Sie sie, ersetzen Sie my_sitepackage durch Ihren Extension-Key und leeren Sie alle Caches.

<?php
// EXT:my_sitepackage/ext_localconf.php
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['my_preset']
    = 'EXT:my_sitepackage/Configuration/RTE/MyPreset.yaml';
# EXT:my_sitepackage/Configuration/RTE/MyPreset.yaml
# TYPO3 v13.4 LTS und v14.3 LTS (CKEditor 5), mit 2 Leerzeichen einrücken
imports:
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Processing.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Base.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Plugins.yaml" }

editor:
  config:
    contentsCss:
      - "EXT:rte_ckeditor/Resources/Public/Css/contents.css"
      - "EXT:my_sitepackage/Resources/Public/Css/rte.css"

    toolbar:
      items:
        - style
        - heading
        - '|'
        - bold
        - italic
        - '|'
        - bulletedList
        - numberedList
        - blockQuote
        - '|'
        - link
        - insertTable
        - '|'
        - removeFormat
        - undo
        - redo
        - sourceEditing

    heading:
      options:
        - { model: 'paragraph', title: 'Paragraph' }
        - { model: 'heading2', view: 'h2', title: 'Heading 2' }
        - { model: 'heading3', view: 'h3', title: 'Heading 3' }

    style:
      definitions:
        - { name: "Lead", element: "p", classes: ['lead'] }
        - { name: "Muted", element: "span", classes: ['text-muted'] }

    htmlSupport:
      allowEmpty: ['i']
      allow:
        - { name: 'i', classes: [ 'fa-brands', 'fa-typo3' ] }
# EXT:my_sitepackage/Configuration/page.tsconfig
# oder: Seiteneigenschaften > Ressourcen > Page TSconfig
RTE.default.preset = my_preset

# Optional: kleinerer Editor nur für das Feld bodytext von "Text"-Elementen
RTE.config.tt_content.bodytext.types.text.preset = minimal

Toolbar-Einträge stehen als YAML-Liste unter editor.config.toolbar.items. Mit '|' trennen Sie Gruppen, mit '-' erzwingen Sie einen Zeilenumbruch. Einträge aus optionalen CKEditor-5-Paketen funktionieren erst, wenn Sie das Paket über importModules laden, so wie es die Core-Datei Full.yaml macht.

Toolbar-EintragFunktionIm Core-PresetZusätzlicher importModules-Eintrag
headingAuswahl für Absatz und Überschriften, Optionen in heading.optionsdefault, fullNein
styleStyle-Auswahl, Einträge in style.definitionsdefault, fullNein
bold, italicFett und kursivdefault, minimal, fullNein
underline, strikethroughUnterstrichen und durchgestrichenfullNein
subscript, superscript, softhyphenTief- und Hochstellung, weiches Trennzeichendefault, fullNein
bulletedList, numberedList, blockQuoteListen und Zitatedefault, fullNein
indent, outdentBlöcke einrücken, Klassen in indentBlockfullNein
alignmentTextausrichtung als CSS-Klassendefault, fullNein
linkTYPO3 Link-Browserdefault, fullNein
insertTableTabellen, Zellwerkzeuge in table.contentToolbardefault, fullNein
findAndReplace, specialCharacters, horizontalLineSuchen und Ersetzen, Sonderzeichen, horizontale Liniedefault, fullNein
removeFormat, undo, redoFormatierung entfernen, Rückgängig, Wiederholendefault, full (undo und redo auch in minimal)Nein
sourceEditing, selectAllHTML-Quelltextansicht, alles auswählensourceEditing: default, full; selectAll: fullNein
showBlocksZeigt Blockgrenzen anfull@ckeditor/ckeditor5-show-blocks
fontFamily, fontSize, fontColor, fontBackgroundColorSchriftoptionen (seit TYPO3 12.4.12)full@ckeditor/ckeditor5-font
textPartLanguageKennzeichnet die Sprache eines Textteilsfull@ckeditor/ckeditor5-language
highlightMarker- und Stiftfarbenfull@ckeditor/ckeditor5-highlight
fullscreenBearbeiten im Vollbild (seit TYPO3 13.4.16)full@ckeditor/ckeditor5-fullscreen

Quelle: die Core-Presets Default.yaml, Minimal.yaml und Full.yaml von TYPO3 13.4 und 14.3 sowie die Konfigurationsbeispiele von rte_ckeditor. Alle Toolbar-Optionen beschreibt die Toolbar-Dokumentation von CKEditor 5.

Schreiben Sie das Plugin als ES6-Modul, registrieren Sie es in Configuration/JavaScriptModules.php und laden Sie es mit editor.config.importModules. Alte CKEditor-4-Plugins auf Basis von CKEDITOR.plugins.add lassen sich nicht weiterverwenden.

Das folgende Minimalbeispiel folgt dem Timestamp-Plugin aus der TYPO3-Dokumentation. Es fügt einen Button "Timestamp" hinzu, der das aktuelle Datum und die Uhrzeit einfügt. Der Migrationsleitfaden von CKEditor 4 auf 5 erklärt die neuen Plugin-Konzepte.

Wenn Sie lieber fertige TYPO3 CKEditor Plugins nutzen, statt eigene zu schreiben: Die kostenlose Community Edition des CKEditor Pack, gemeinsam mit dem CKEditor-Team entwickelt, ergänzt Funktionen wie Vollbildmodus, Suchen und Ersetzen, Vorlagen und Wortzählung ohne Lizenzschlüssel.

// EXT:my_sitepackage/Resources/Public/JavaScript/Ckeditor/timestamp-plugin.js
import { Plugin } from '@ckeditor/ckeditor5-core';
import { ButtonView } from '@ckeditor/ckeditor5-ui';

export class Timestamp extends Plugin {
  static pluginName = 'Timestamp';

  init() {
    const editor = this.editor;

    // Button registrieren, damit er als Toolbar-Eintrag verfügbar ist
    editor.ui.componentFactory.add(Timestamp.pluginName, () => {
      const button = new ButtonView();

      button.set({
        label: 'Timestamp',
        withText: true
      });

      // Aktuelles Datum und Uhrzeit an der Cursorposition einfügen
      button.on('execute', () => {
        const now = new Date();
        editor.model.change(writer => {
          editor.model.insertContent(writer.createText(now.toString()));
        });
      });

      return button;
    });
  }
}
<?php
// EXT:my_sitepackage/Configuration/JavaScriptModules.php
return [
    'dependencies' => ['backend'],
    // Die Doku für TYPO3 v13.4 setzt diesen Tag, die Doku für v14.3 nicht mehr
    'tags' => [
        'backend.form',
    ],
    'imports' => [
        '@my-vendor/my-package/timestamp-plugin.js' => 'EXT:my_sitepackage/Resources/Public/JavaScript/Ckeditor/timestamp-plugin.js',
    ],
];
# EXT:my_sitepackage/Configuration/RTE/MyPreset.yaml
imports:
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Processing.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Base.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Plugins.yaml" }

editor:
  config:
    importModules:
      - { module: '@my-vendor/my-package/timestamp-plugin.js', exports: [ 'Timestamp' ] }
    toolbar:
      items:
        - bold
        - italic
        - '|'
        - clipboard
        - undo
        - redo
        - '|'
        - timestamp
  1. Bearbeiten Sie ein Textelement. Markieren Sie einen Satz und wählen Sie im Styles-Menü Lead text.
  2. Markieren Sie einen Link und wählen Sie Button link.
  3. Speichern, schließen und das Element erneut öffnen. Beide Styles müssen weiterhin angewendet sein.
  4. Öffnen Sie das Frontend und prüfen Sie das HTML: <p class="lead"> und <a class="btn">.

Ohne Ihr Preset zeigt der Editor die Standard-Toolbar. Mit Preset sehen Sie die kürzere Toolbar aus Schritt 1.

Verschwindet die Klasse beim Speichern: Die RTE-Verarbeitung entfernt sie. Prüfen Sie die Preset-Imports und ob die Style-Definition eine einfache Klasse nutzt. Bleibt sie erhalten, wirkt aber nicht: Die CSS-Regel fehlt im Frontend-Stylesheet.

  • Halten Sie die Toolbar kurz. Weniger Schaltflächen bedeuten weniger Gestaltungsfehler.
  • Bieten Sie nur die Überschriftenebenen an, die Ihr Design nutzt.
  • Entfernen Sie sourceEditing für Redakteure ohne HTML-Kenntnisse.

Die meisten CKEditor-Probleme in TYPO3 haben drei Ursachen: ein Preset, das nicht aktiv ist, ein Einrückungsfehler im YAML oder ein veralteter Cache. Prüfen Sie die Punkte in dieser Reihenfolge.

Die Toolbar oder ein Button wird nicht angezeigt

  • Prüfen Sie, ob Ihr Preset registriert ist: System > Configuration > $GLOBALS['TYPO3_CONF_VARS'] (Global Configuration) > RTE.
  • Prüfen Sie, welches Preset für das Feld gilt. Ein Feld-Preset im Page TSconfig hat Vorrang vor dem TCA und vor RTE.default.preset.
  • Rücken Sie mit zwei Leerzeichen ein und setzen Sie nach jedem Doppelpunkt ein Leerzeichen. YAML unterscheidet Groß- und Kleinschreibung.
  • Einträge wie fontSize, highlight oder fullscreen benötigen ihr Paket in importModules. Fehlt ein Eintrag, meldet CKEditor toolbarview-item-unavailable in der Browser-Konsole.
  • CKEditor-4-Schlüssel wie toolbarGroups, removeButtons und stylesSet haben in TYPO3 v12 bis v14 keine Wirkung. Schreiben Sie sie als toolbar.items und style.definitions neu.

Styles oder Editor-CSS fehlen

  • Die Style-Auswahl zeigt nur Einträge aus style.definitions. Die Dokumentation zu v14.3 empfiehlt, CSS-Klassen dort zu definieren statt in htmlSupport.allow.
  • Dateien in contentsCss müssen per fetch() abrufbar sein, weil TYPO3 das CSS im Browser mit einem Präfix versieht. Behalten Sie die Core-Datei contents.css in der Liste, wenn Sie deren Standard-Styling nutzen möchten.
  • Browser cachen dieses CSS. Ändern Sie nach jeder Anpassung einen Query-String wie ?v=2.
  • TYPO3 v14: contents.css passt sich an hellen und dunklen Modus an. Soll der Editor hell bleiben, verweisen Sie contentsCss auf eine eigene Datei.

Tags oder Attribute verschwinden beim Speichern

  • Erlauben Sie das Element im Editor mit htmlSupport.allow und prüfen Sie, ob die Processing-Regeln (allowTags in Processing.yaml) es behalten.
  • Entfernen Sie den Import von Processing.yaml nicht. Die Dokumentation warnt, dass damit Sicherheitsmaßnahmen entfallen.
  • Elemente, die das CKEditor-5-Schema nicht kennt, etwa svg oder Custom Elements, lassen sich nicht über htmlSupport erlauben.

Änderungen erscheinen gar nicht

Leeren Sie alle Caches, nachdem Sie YAML, Page TSconfig, ext_localconf.php oder JavaScriptModules.php geändert haben: Admin Tools > Maintenance > Flush TYPO3 and PHP Cache in v13, System > Maintenance in v14 oder vendor/bin/typo3 cache:flush auf der Kommandozeile. Laden Sie danach das Backend neu.

Sollen Redakteure Barrierefreiheitsprobleme schon beim Schreiben im CKEditor sehen? Lesen Sie unseren Beitrag zur Live-Barrierefreiheitsprüfung für TYPO3.

Wechsel von CKEditor 4 auf CKEditor 5?

Der kostenlose Upgrade-Leitfaden für TYPO3 (PDF mit 18 Seiten und Excel-Arbeitsblatt) zeigt den sicheren Weg von TYPO3 v11 bis v14, eine LTS-Version nach der anderen.

Upgrade-Leitfaden kostenlos laden

JavaScript-Code von CKEditor

CKEDITOR.editorConfig = function(config) {
    config.toolbarGroups = [
        {name: 'basicSyles', groups: ['basicStyles']}
    ];
    config.removeButtons := 'Underline,Strike';
}

YAML-Code des CKEditors für TYPO3

editor:
    config:
        toolbarGroups:
            - {name: basicSyles, groups: [basicStyles]}
        removeButtons:
            - Underline
            - Strike

Ja, natürlich!

Schritt 1. Zum Seitenmodul gehen, auf die Stammseite klicken.
Schritt 2. Bearbeiten Sie Ihre Seiteneigenschaften, gehen Sie zur Registerkarte Ressourcen und Seite TSConfig

Schritt 3. Konfigurieren Sie Ihre Voreinstellung, hier sind Beispiele.

Standard: CKEditor Voreinstellung

RTE {
    default.preset = default
}

Full: CKEditor Preset

RTE {
    default.preset = full
}

Minimal: CKEditor-Voreinstellung

RTE {
    default.preset = minimal
}

Ein Feld überschreiben

// Syntax: RTE.config.[tableName].[fieldName].preset
RTE {
    config {
        tt_content {
            bodytext.preset = myFavouritePreset
        }
    }
}

Override One Field: If Type Match

// Syntax: RTE.config.tt_content.bodytext.types.textmedia.preset = minimal
RTE {
    config {
        tt_content {
            bodytext {
                types {
                    textmedia.preset = myFavouritePreset
                }
            }
        }
    }
}

Nachrichten-Erweiterungsfeld überschreiben

RTE {
    config {
        tx_news_domain_model_news {
            bodytext.preset = minimal
        }
    }
}
removeButtons:
      - Anchor
      - Underline
      - Strike
      - Styles

Schritt 1. /typo3conf/ext_localconf.php

if (empty($GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets'][MyPreset])) {
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets'][MyPreset] = 'EXT:yourextension/Configuration/RTE/MyPreset.yaml';
}
# Add configuration for the editor
# For complete documentation see http://docs.ckeditor.com/#!/api/CKEDITOR.config
editor:
  config:
    # Include custom CSS
    contentsCss: "EXT:yourextension/Resources/Public/Css/rte.css"

Schritt 3. Weisen Sie Ihre benutzerdefinierte Voreinstellung dem CKEditor RTE zu, z.B. RTE.default.preset = MyPreset at PageTS.

Es gibt mehrere Optionen zur Durchführung von Schritt 3 (Zuweisung einer benutzerdefinierten Voreinstellung für das RTE) wie unten aufgeführt.

Option 1: Globale Anwendung mit PageTSConfig

# Page > Properties > Resources > PageTS field
RTE {
    default {
        preset = MyPreset
    }
}

Option 2: Einrichtung durch TCA

# yourextension/Configuration/TCA/tx_yourextension_domain_model_table.php
'content' => [ 
    'label' => 'YourLabel', 
    'config' => [ 
        'type' => 'text', 
        'cols' => 48, 
        'rows' => 5, 
        'enableRichtext' => true, 
        'richtextConfiguration' => 'minimal', 
    ], 
],

Option 3. Voreinstellung einer bestimmten Tabelle/Feld mit PageTSConfig zuweisen

# Example
RTE {
    config {
        tt_content {
            bodytext {
                preset = minimal
                types {
                    textmedia.preset = default
                    myfield.preset = full
                }
            }
        }
    }
}

In CKEditor wird jede Schaltfläche in einer Reihe von Symbolleistengruppen konfiguriert.

Beispiel:

# Add configuration for the editor
# For complete documentation see http://docs.ckeditor.com/#!/api/CKEDITOR.config
editor:
  config:
    toolbarGroups:
        - { name: clipboard, groups: [ clipboard, cleanup, undo ] }

Im obigen Beispiel enthält die Symbolleistengruppe der Zwischenablage drei Schaltflächen. Auf diese Weise können Sie Ihren bevorzugten Editor konfigurieren :)

Entdecken Sie die fantastische, auf der Benutzeroberfläche von CKEditor basierende Benutzeroberfläche, um jede Schaltfläche und Symbolleiste unter Toolbar Configurator zu erhalten.

Viele Leute fragen sich vielleicht, wie wir Bilder in CKEditor integrieren können. Im TYPO3-Kern ist eine solche Funktion mit CKEditor standardmäßig nicht verfügbar.

  • Gleiche Bildbehandlung wie rtehtmlarea (magische Bilder, übliche RTE TSConfig unterstützt)
  • Bildbrowser wie üblich in z.B. FAL-Dateiauswahl
  • Dialog zum Ändern von Breite, Höhe, Alt und Titel (Seitenverhältnis wird automatisch beibehalten)

Schritt 1. Installieren Sie die TYPO3-Erweiterung EXT:rte_ckeditor_image

Schritt 2. Konfiguration

#1 EXT:yourextension/ext_localconf.php

$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['default'] = 'EXT:yourextension/Configuration/RTE/MyPreset.yaml';
#2 EXT:yourextension/Configuration/RTE/MyPreset.yaml
imports:
  # Import default RTE config (for example)
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Default.yaml" }
  # Import the image plugin configuration
  - { resource: "EXT:rte_ckeditor_image/Configuration/RTE/Plugin.yaml" }
# Your PageTSConfig
editor:
  config:
    # RTE default config removes image plugin - restore it:
    removePlugins: null

Schritt 3. RTE-Konfigurationsvoreinstellung aktivieren

# Page TSConfig
RTE.default.preset = MyPreset

Schritt 4. (Optional) Konfiguration

Maximale Breite/Höhe
Die maximalen Abmessungen beziehen sich auf die Konfiguration für magische Bilder, die in Page TSConfig eingestellt werden müssen:

# Page TSConfig
RTE.default.buttons.image.options.magic {
    maxWidth = 1020  # Default: 300
    maxHeight = 800  # Default: 1000
}

Verwendung als Leuchtkasten mit fluid_styled_content

# Vorlagenkonstanten

styles.content.textmedia.linkWrap.lightboxEnabled = 1

Erlaubte Erweiterungen
Standardmäßig sind die Erweiterungen aus $TYPO3_CONF_VARS['GFX']['imagefile_ext'] erlaubt. Sie können dies jedoch für den CKEditor außer Kraft setzen, indem Sie in Ihrer YAML-Konfiguration folgendes hinzufügen:

editor:
  externalPlugins:
      typo3image:
        allowedExtensions: "jpg,jpeg,png"

1. Erweiterten Inhaltsfilter aktivieren/deaktivieren

# Add configuration for the editor
# For complete documentation see http://docs.ckeditor.com/#!/api/CKEDITOR.config
editor:
    config:
        allowedContent: true

Was ist ein Erweiterter Inhaltsfilter?

  • Nur Tags/Klassen/Stile, die konfiguriert werden, sollten beibehalten werden
  • Inhalt beim Bearbeiten und Einfügen filtern
  • Standardmäßig aktiviert
  • Macht die 'Processing'-Konfiguration in den meisten Fällen überflüssig 'RTE.proc'

2. format HTML tags:

Formatieren Sie die HTML-Tags, indem Sie die gewünschte Option aus einem Dropdown-Menü auswählen.

editor:
  config:
  	format_tags: "p;h1;h2;h3;h4;h5;pre;address;div"

3. Die Symbolleistengruppen

Die Option Symbolleistengruppen hilft Ihnen, das Layout und die Struktur der Symbolleisten im oberen Teil des Editors zu definieren.

editor:
   config:
 	toolbarGroups:
     	- { name: clipboard, groups: [clipboard, undo] }
     	- "/"
     	- { name: styles }

4 stylesSet

Verschiedene Stile zur Verfügung stellen, um den Text auf ansprechende Weise zu formatieren und anzupassen. Vielleicht möchten Sie das Dropdown-Menü "Stile" verwenden, um die Aufgabe zu erledigen.

editor:
  config:
     stylesSet:
  	- { name: "quote-style", element: "p", attributes: { class: "quote-style"}}
  	- { name: "Load More Button", element: "a", attributes: { class: "load-more"}}
  	- { name: "More Content", element: "div", attributes: { class: "more-content"}}

5. extraPlugins

editor:
  config:
    allowTags: 
      - address
      - label
justifyClasses:
      - text-left
      - text-center
      - text-right
      - text-justify
      - quote-style
extraPlugins:
      - justify

removePlugins:
      - image
removeButtons:
      - Anchor
      - Underline
      - Strike

6 InhaltCss

Mit der Funktion ContentsCSS können Sie verschiedene CSS-Stile zur direkten Verwendung und Anzeige in CKEditor definieren.

7. entfernenKnöpfe

RemoveButtons hilft bei der Entfernung einzelner Funktionen und Schaltflächen, die durch den Import von Base.yaml entstehen.

8. Buttons and Classes Configuration

buttons:
  link:
    url:
      properties:
        class:
          default: 'external-link'
    properties:
      class:
        allowedClasses: 'external-link'
classes:
  external-link:
    name: 'External Link'
classesAnchor:
  externalLink:
    class: 'external-link'
    type: 'url'
    target: '_blank'

Schaltfläche Probe hinzufügen

Schritt 1. /yourextension/Resources/Public/CkEditorPlugins/myplugin.js

100% risikofreie Geld-zurück-Garantie!

Wir freuen uns, dass Sie T3Planet kennenlernen möchten. Wenn diese Extensions in den nächsten 15 Tagen nicht das Richtige für Sie ist, melden Sie sich einfach bei uns! Wir erstatten Ihnen gerne 100% Ihres Geldes zurück.

Schritt 2. /yourextension/Configuration/RTE/MyPreset.yaml

# Load default processing options
imports:
    - { resource: "EXT:rte_ckeditor/Configuration/RTE/Default.yaml" }
editor:
    # Let's load our sample custom plugin
    externalPlugins:
        myplugin: { resource: "EXT:yourextension/Resources/Public/CkEditorPlugins/myplugin.js" }

Schritt 3. Register CKEditor Sample Custom Plugin

$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['MyPreset'] = 'EXT:yourextension/Configuration/RTE/MyPreset.yaml';

Schritt 4. Testfahrt mit RTE

RTE {
    default {
        preset = MyPreset
    }
}
# Create yourextension/Resources/Public/CkEditorPlugins/myplugin.js
'use strict';

(function ()) {
    CKEDITOR.plugins.add('example_plugin', {
        init: function (editor) {
            // Let's add CKEditor Icon
            // Note: Please put icon file at /Resources/Public/CkEditorPlugins/icons/mypreset.png
            icons: 'mypreset',
            
            // Add button to CKEditor
            editor.ui.addButton('MyPreset',{
                label: 'My Button',
                toolbar: 'basicStyles',
                command: 'openExampleModal'
            });

            // Execute CKEditor Command
            editor.addCommand('openExampleModal',{
                exec: openModal
            });
        }
    })
}

function openModal() {
    require([
        'TYPO3/CMS/Backend/Modal'
    ], function(Modal) {
        Modal.show(
            'Sample Plugin',
            'Hello'
        );
    })
}

Fortschrittliches AJAX-basiertes benutzerdefiniertes TYPO3 CKEditor-Plugin

# /yourextension/Configuration/RTE/MyPreset.yaml
# Let's configure AJAX route of TYPO3
editor:
    # Let's load our sample custom plugin
    externalPlugins:
        myplugin: { 
            resource: "EXT:yourextension/Resources/Public/CkEditorPlugins/myplugin.js" 
            route: "configsample_route"
        }

# yourextension/Resources/Public/CkEditorPlugins/myplugin.js

function openModal() {
    // Get AJAX URL
    var url = editor.config.myplugin.routeUrl;

    require([
        'TYPO3/CMS/Backend/Modal'
    ], function(Modal) {
        // Display modalbox
        Modal.cdvanced({
            type: Modal.types.iframe,
            title: 'Sample Plugin',
            content: url,
            size: Modal.sizes.large
        })
    })
}

Schritt 1. JS-Code einrichten

# Create yourextension/Resources/Public/CkEditorPlugins/myplugin.js

'use strict';
(function () {

	CKEDITOR.dtd.$removeEmpty.em = 0;
	CKEDITOR.dtd.$removeEmpty.i = 0;

	CKEDITOR.plugins.add('icon-envelope', {
		icons: 'iconenvelope',
		init: function (editor) {
			editor.ui.addButton( 'IconEnvelope', {
				label: 'Icon E-Mail',
				toolbar: 'insert',
				command: 'insertIconEnvelope'
			});

			editor.addCommand( 'insertIconEnvelope', {
				exec: function (editor) {
					var icon = editor.document.createElement('i');
					icon.setAttribute('class', 'fa fa-envelope');
					editor.insertElement(icon);
				}
			});
		}
	});

});

Step 2. Include in YAML Configuration

#  /yourextension/Configuration/RTE/MyPreset.yaml

# Load default processing options
imports:
    - { resource: "EXT:rte_ckeditor/Configuration/RTE/Processing.yaml" }
    - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Base.yaml" }
    - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Plugins.yaml" }

# Add configuration for the editor
# For complete documentation see http://docs.ckeditor.com/#!/api/CKEDITOR.config
editor:
  externalPlugins:
    icon-envelope: { resource: "EXT:mytheme/Resources/Public/CkEditorPlugins/icon-envelope/plugin.js" }

Code-Schnipsel TYPO3 CKEditor

Step 1. Search CKEditor plugin which you want to integrate into TYPO3 from ckeditor.com/cke4/addons/plugins/all

Step 2. Let's imagine you want to integrate this Codesnippet plugin ckeditor.com/cke4/addon/codesnippet

Step 3. Download & Unzip the plugin
Put the plugin at yourextension/Resources/Public/CKeditor/Plugins/codesnippet/

Step 4. Configuration/RTE/Plugin.yaml

editor:
   externalPlugins:
       codesnippet:
           resource: "EXT:yourextension/Resources/Public/CKeditor/Plugins/codesnippet/"

Schritt 5. Jede zusätzliche Konfiguration, die im Plugin erforderlich ist, prüfen Sie deren Dokumentation

Schritt 6. Löschen Sie den Cache! Sie sollten "Code Snippet einfügen" sehen können.

Youtube TYPO3 CKEditor

Schritt 1. Herunterladen & Entpacken-Plugin ckeditor.com/cke4/addon/youtube

Stellen Sie das Plugin unter yourextension/Resources/Public/CKeditor/Plugins/youtube/

Schritt 2. Configuration/RTE/Plugin.yaml

editor:
  externalPlugins:
    youtube: { resource: "EXT:mx_ext/Resources/Public/RTE/Plugins/youtube/plugin.js" }
  config:
    youtube_width: '550'
    extraAllowedContent: '*(*)[data-*]; iframe'

Schritt 3. Löschen Sie den Cache! Sie sollten "Youtube Video Button" sehen können.

Wortzählung TYPO3 CKEditor

Schritt 1. Herunterladen & Entpacken-Plugin https://ckeditor.com/cke4/addon/wordcount

Setzen Sie das Plugin auf yourextension/Resources/Public/CKeditor/Plugins/wordcount/

Schritt 2. Configuration/RTE/Plugin.yaml

# Register wordcount plugin for ckeditor
editor:
  externalPlugins:
    wordcount:
      resource: "EXT:rte_ckeditor_wordcount/Resources/Public/JavaScript/Plugins/wordcount/"

Schritt 3. Import in RTE-Voreinstellung

imports:
  - resource: { "EXT:rte_ckeditor_myplugin/Configuration/RTE/Plugin.yaml" }

editor:
  config:
    wordcount:
      showCharCount: true

Step 4. Clear the cache! You should be able to see the "WordCount” button.

Dieses Plugin ist im CKEditor vorinstalliert und überprüft, wie der Name schon sagt, die Rechtschreibung während der Eingabe. Sie müssen es jedoch für jeden Text neu aktivieren, aber Sie können es standardmäßig mit dem folgenden Codeschnipsel aktivieren.

editor:
  config:
    defaultContentLanguage: "de"
    defaultLanguage: "de"
    contentsLanguage: "de"
    language: "de"
    scayt_autoStartup: true # Spellcheck always on
    scayt_sLang: "de_DE" # spellcheck language
    wsc_lang: "de_DE"

Fantastische Symbole in TYPO3 CKEditor

Schritt 1. TYPO3-Erweiterung installieren rte_ckeditor_fontawesome

Schritt 2. TS Config

# For the default template to the CKE-Editor
RTE.default.preset = defaultFA4

# For the full template of CKE-Editor
RTE.default.preset = fullFA4

Schritt 3. TYPO3-Konstanten

# Include your font-awesome path
plugin.tx_ckeditor_fontawesome.css = {$path}

# Inlcude font-awesome through CDN
plugin.tx_ckeditor_fontawesome.css = https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css

Schritt 4. Importieren in Ihre RTE-Konfiguration
So fügen Sie dieses Plug-In in Ihre eigene RTE-Konfiguration ein. Importieren Sie die Config in Ihre Voreinstellung.

imports:
    - { resource: "EXT:rte_ckeditor_fontawesome/Configuration/RTE/PluginFA5.yaml" }

Im nächsten Schritt müssen Sie Ihre individuelle Symbolleisten-Konfiguration erweitern, um das anklickbare Symbol hinzuzufügen.

editor:
  config:
    toolbar:
        - [ 'Bold', 'Italic', .....]
        ...
        - [ 'ckeditor_fa5' ]

Leider bietet TYPO3 keine automatische Migration von der alten RTE htmlArea zum CKEditor.

Sie sollten es vorsichtig manuell migrieren, aber keine Sorge, es ist nicht so schwer. Denn die meisten sehen sich sehr ähnlich, also gehen Sie jede Konfiguration einzeln durch.

RTE htmlBereich SeiteTSConfig

RTE.default {
  showButtons(
    bold, italic, underline,
    left, center, right, justifyfull,
    orderedlist, unorderedlist, indent, outdent, 
         line, link, removeformat,
    copy, cut, paste, undo, redo     
  )
  toolbarOrder(
    bold, italic, underline, bar, 
    left, center, right, justifyfull,
    orderedlist, unorderedlist, bar, indent, outdent, linebreak,
         line, link, removeformat, bar,
    copy, cut, paste, bar, undo, redo      
  )
}

RTE CKE-Herausgeber YAML

editor:
  config:
    toolbar:
      - [ 'Bold', 'Italic', 'Underline', '-' ] 
      - [ 'JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock' ] 
      - [ 'NumberdList', 'BulletedList', '-', 'Indent', 'Outdent' ] 
      - '/'
      - [ 'HorizontalRule', 'Link', 'RemoveFormat', '-' ] 
      - [ 'Copy', 'Cut', 'Paste', '-' , 'Undo', 'Redo'] 
    extraPlugins:  
      - justify

Welche CKEditor-Version nutzen TYPO3 v13 und v14?

TYPO3 v13.4 LTS und v14.3 LTS nutzen beide CKEditor 5 über die Core-Extension rte_ckeditor. Die genaue CKEditor-5-Version ändert sich mit den TYPO3-Patch-Releases: v13.4.0 brachte CKEditor 5 v43 mit, die aktuellen Branches 13.4 und 14.3 setzen v48 voraus. CKEditor 4 war von TYPO3 v8 bis v11 im Einsatz.

Kann ich CKEditor-4-Plugins in TYPO3 v13 oder v14 weiterverwenden?

Nein. CKEditor 5 hat eine andere Plugin-Architektur, und die TYPO3-Dokumentation stellt klar, dass CKEditor-4-Plugins damit nicht kompatibel sind. Schreiben Sie jedes Plugin als ES6-Modul auf Basis der CKEditor-5-Klasse Plugin neu, registrieren Sie es in JavaScriptModules.php und laden Sie es über importModules. Prüfen Sie vorher, ob CKEditor 5 oder eine Extension die Funktion schon mitbringt.

Wie füge ich in TYPO3 v13 und v14 Bilder im CKEditor ein?

Der TYPO3-Core hat die Bildverwaltung im Rich-Text-Editor mit v10 entfernt, Sie benötigen daher eine Extension. EXT:rte_ckeditor_image (Composer-Paket netresearch/rte-ckeditor-image) unterstützt in Version 13.10 TYPO3 ab 13.4.21 sowie 14.3. Aktivieren Sie nach der Installation das Site Set netresearch/rte-ckeditor-image, das den Button insertimage und die Frontend-Ausgabe einrichtet.

Wo sehe ich, welche RTE-Presets verfügbar sind?

Öffnen Sie im Backend System > Configuration, wählen Sie $GLOBALS['TYPO3_CONF_VARS'] (Global Configuration) und klappen Sie RTE auf. Dort sehen Sie jeden registrierten Preset-Namen und die zugehörige YAML-Datei. Der Core registriert default, minimal und full. Extensions und Ihr Sitepackage können in ext_localconf.php weitere Presets ergänzen.

Können Redakteure den CKEditor im TYPO3-Formulareditor nutzen?

Ja, seit TYPO3 v14.2 und damit auch in v14.3 LTS. Der Formulareditor kann CKEditor 5 für Textarea-Felder verwenden, etwa für das Element StaticText, Checkbox-Labels mit Links und den Bestätigungs-Finisher. Integratoren aktivieren das in der Formular-YAML mit enableRichtext und wählen mit richtextConfiguration ein beliebiges registriertes RTE-Preset.

Kostenlose TYPO3-Leitfäden für Ihr Team

Leitfäden zu Upgrade, Barrierefreiheit, Mehrsprachigkeit und Relaunch für TYPO3-Projekte, kostenlos zum Download.

Alle kostenlosen TYPO3-Leitfäden ansehen

Danke für das Lesen eines langen Artikels.

Ich hoffe, Sie hatten Spaß und haben mehr über den coolen CKEditor mit unserem geliebten fantastischen TYPO3 CMS erfahren.

Was ist Ihre Lieblingsfunktion in CKEditor? Haben Sie Fragen zur Integration von CKEditor in TYPO3? Haben wir eine wichtige Funktion der Integration von CKEditor in TYPO3 verpasst?
Bitte zögern Sie nicht, Fragen, Feedback oder Probleme in das untenstehende Kommentarfeld zu schreiben. Wir werden Ihnen gerne zurückschreiben.

Und wenn du gespannt bist, wie KI die TYPO3-Welt verändert, wirf einen Blick ins TYPO3 KI Universe – dort treffen sich TYPO3 und KI, um Arbeitsabläufe zu vereinfachen und neue Ideen zu fördern.

Haben Sie eine glückliche Redaktion!

Souveräne TYPO3 KI: AI Foundation ist kostenlos und Open Source, sechs KI-Erweiterungen bauen darauf auf.

TYPO3 KI entdecken