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.
Wie konfiguriert man den CKEditor in TYPO3?
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,removeButtonsoderstylesSetfunktionieren in CKEditor 5 nicht. - Der Core bringt drei Presets mit:
default,minimalundfull. Aktiv ist "default", solange Sie kein anderes Preset wählen. - Neue Presets werden in
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']in derext_localconf.phpregistriert. 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:
htmlSupportim Editor und die Processing-Regeln ausProcessing.yamlbeim 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
AfterRichtextConfigurationPreparedEventerlaubt Ä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
Was ist CKEditor?
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
Was macht CKEditor in TYPO3 CMS?
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
Sind Sie neu bei CKEditor?
Kein Problem, probieren Sie diese kurze Demo jetzt selbst aus
ckeditor.com/ckeditor-4/demo/#article
Was sind die Funktionen von CKEditor in TYPO3?
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
Warum TYPO3 von htmlArea RTE auf CKEditor umgestiegen ist?
- 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
Warum TYPO3 von htmlArea RTE zu CKEditor gewechselt ist
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.
CKEditor für TYPO3-Redakteure
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.
Was sind die großen Änderungen in TYPO3 >= v8 mit CKEditor?
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.
Brauchen Sie RTE-Hilfe? Der T3AI TYPO3 AI Co-Pilot ist da!
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.
Oh, Sie wissen es nicht, was ist YAML?
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.
Warum TYPO3 YAML wählen?
"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)
Was sind die Voreinstellungen von CKEditor in TYPO3?
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
Wie konfiguriert man CKEditor 5 in TYPO3 v13 und v14?
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).
| Methode | Funktioniert in | Geeignet für | Zu beachten |
|---|---|---|---|
Page TSconfig RTE.default.preset | v11 bis v14 | Ein Preset für eine Website oder einen Seitenbaum | Das Preset muss vorher registriert sein |
Page TSconfig RTE.config.[table].[field].preset und .types.[type].preset | v11 bis v14 | Unterschiedliche Editoren je Feld oder Inhaltstyp | Hier überschriebene YAML-Optionen ersetzen Arrays und können keine Booleans setzen |
TCA richtextConfiguration | v11 bis v14 | Felder Ihrer eigenen Extension | Ein Feld-Preset aus dem Page TSconfig hat Vorrang |
PSR-14 AfterRichtextConfigurationPreparedEvent | v14 | Finale Konfiguration in PHP anpassen | In 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 Welche Toolbar-Einträge gibt es im TYPO3 CKEditor 5?
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-Eintrag | Funktion | Im Core-Preset | Zusätzlicher importModules-Eintrag |
|---|---|---|---|
heading | Auswahl für Absatz und Überschriften, Optionen in heading.options | default, full | Nein |
style | Style-Auswahl, Einträge in style.definitions | default, full | Nein |
bold, italic | Fett und kursiv | default, minimal, full | Nein |
underline, strikethrough | Unterstrichen und durchgestrichen | full | Nein |
subscript, superscript, softhyphen | Tief- und Hochstellung, weiches Trennzeichen | default, full | Nein |
bulletedList, numberedList, blockQuote | Listen und Zitate | default, full | Nein |
indent, outdent | Blöcke einrücken, Klassen in indentBlock | full | Nein |
alignment | Textausrichtung als CSS-Klassen | default, full | Nein |
link | TYPO3 Link-Browser | default, full | Nein |
insertTable | Tabellen, Zellwerkzeuge in table.contentToolbar | default, full | Nein |
findAndReplace, specialCharacters, horizontalLine | Suchen und Ersetzen, Sonderzeichen, horizontale Linie | default, full | Nein |
removeFormat, undo, redo | Formatierung entfernen, Rückgängig, Wiederholen | default, full (undo und redo auch in minimal) | Nein |
sourceEditing, selectAll | HTML-Quelltextansicht, alles auswählen | sourceEditing: default, full; selectAll: full | Nein |
showBlocks | Zeigt Blockgrenzen an | full | @ckeditor/ckeditor5-show-blocks |
fontFamily, fontSize, fontColor, fontBackgroundColor | Schriftoptionen (seit TYPO3 12.4.12) | full | @ckeditor/ckeditor5-font |
textPartLanguage | Kennzeichnet die Sprache eines Textteils | full | @ckeditor/ckeditor5-language |
highlight | Marker- und Stiftfarben | full | @ckeditor/ckeditor5-highlight |
fullscreen | Bearbeiten 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.
Wie fügt man in TYPO3 ein eigenes CKEditor-5-Plugin hinzu?
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 Den Ablauf testen
- Bearbeiten Sie ein Textelement. Markieren Sie einen Satz und wählen Sie im Styles-Menü Lead text.
- Markieren Sie einen Link und wählen Sie Button link.
- Speichern, schließen und das Element erneut öffnen. Beide Styles müssen weiterhin angewendet sein.
- Ö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.
Tipps für Redakteure
- Halten Sie die Toolbar kurz. Weniger Schaltflächen bedeuten weniger Gestaltungsfehler.
- Bieten Sie nur die Überschriftenebenen an, die Ihr Design nutzt.
- Entfernen Sie
sourceEditingfür Redakteure ohne HTML-Kenntnisse.
Häufige Fehler und Fehlerbehebung
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,highlightoderfullscreenbenötigen ihr Paket inimportModules. Fehlt ein Eintrag, meldet CKEditortoolbarview-item-unavailablein der Browser-Konsole. - CKEditor-4-Schlüssel wie
toolbarGroups,removeButtonsundstylesSethaben in TYPO3 v12 bis v14 keine Wirkung. Schreiben Sie sie alstoolbar.itemsundstyle.definitionsneu.
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 inhtmlSupport.allow. - Dateien in
contentsCssmüssen perfetch()abrufbar sein, weil TYPO3 das CSS im Browser mit einem Präfix versieht. Behalten Sie die Core-Dateicontents.cssin 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.csspasst sich an hellen und dunklen Modus an. Soll der Editor hell bleiben, verweisen SiecontentsCssauf eine eigene Datei.
Tags oder Attribute verschwinden beim Speichern
- Erlauben Sie das Element im Editor mit
htmlSupport.allowund prüfen Sie, ob die Processing-Regeln (allowTagsin 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
svgoder Custom Elements, lassen sich nicht überhtmlSupporterlauben.
Ä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.
CKEDITOR.editorConfig = function(config) {
config.toolbarGroups = [
{name: 'basicSyles', groups: ['basicStyles']}
];
config.removeButtons := 'Underline,Strike';
} editor:
config:
toolbarGroups:
- {name: basicSyles, groups: [basicStyles]}
removeButtons:
- Underline
- Strike Schritt 3. Konfigurieren Sie Ihre Voreinstellung, hier sind Beispiele.
Standard: CKEditor Voreinstellung
RTE {
default.preset = default
} RTE {
default.preset = full
} RTE {
default.preset = minimal
} // Syntax: RTE.config.[tableName].[fieldName].preset
RTE {
config {
tt_content {
bodytext.preset = myFavouritePreset
}
}
} // Syntax: RTE.config.tt_content.bodytext.types.textmedia.preset = minimal
RTE {
config {
tt_content {
bodytext {
types {
textmedia.preset = myFavouritePreset
}
}
}
}
} RTE {
config {
tx_news_domain_model_news {
bodytext.preset = minimal
}
}
} removeButtons:
- Anchor
- Underline
- Strike
- Styles Wie kann ich meine eigene CKEditor-Voreinstellung in TYPO3 konfigurieren?
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
}
} # yourextension/Configuration/TCA/tx_yourextension_domain_model_table.php
'content' => [
'label' => 'YourLabel',
'config' => [
'type' => 'text',
'cols' => 48,
'rows' => 5,
'enableRichtext' => true,
'richtextConfiguration' => 'minimal',
],
], # Example
RTE {
config {
tt_content {
bodytext {
preset = minimal
types {
textmedia.preset = default
myfield.preset = full
}
}
}
}
} Konfigurieren über die ToolbarGroups von CKEditor
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.
Wie können wir Bilder in CKEditor TYPO3 zulassen?
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 # 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
} 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" Verschiedene Optionen des CKEditors in TYPO3 verwalten
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'
editor:
config:
format_tags: "p;h1;h2;h3;h4;h5;pre;address;div" editor:
config:
toolbarGroups:
- { name: clipboard, groups: [clipboard, undo] }
- "/"
- { name: styles } 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"}} 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.
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' Wie können Sie eine eigene TYPO3 Extension in CKEditor TYPO3 integrieren?
Schaltfläche Probe hinzufügen
# 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" } $GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['MyPreset'] = 'EXT:yourextension/Configuration/RTE/MyPreset.yaml'; 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'
);
})
} # /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
})
})
} # 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);
}
});
}
});
}); # /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" } 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.
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' 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/" imports:
- resource: { "EXT:rte_ckeditor_myplugin/Configuration/RTE/Plugin.yaml" }
editor:
config:
wordcount:
showCharCount: true 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" Beliebte TYPO3-CKEditor-Erweiterungen
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 # 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' ] Möchten Sie RTE htmlArea zu CKEditor in TYPO3 migrieren?
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
)
} editor:
config:
toolbar:
- [ 'Bold', 'Italic', 'Underline', '-' ]
- [ 'JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock' ]
- [ 'NumberdList', 'BulletedList', '-', 'Indent', 'Outdent' ]
- '/'
- [ 'HorizontalRule', 'Link', 'RemoveFormat', '-' ]
- [ 'Copy', 'Cut', 'Paste', '-' , 'Undo', 'Redo']
extraPlugins:
- justify Weitere Fragen zum TYPO3 CKEditor
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.
Einpacken!
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
Wolfgang Weber
Brand & Communication LeadWolfgang Weber gestaltet TYPO3 mit Leidenschaft und Fachwissen. Als TYPO3-Enthusiast beim T3Planet Shop hat er an TYPO3-Projekten mitgewirkt, die Websites schneller und sicherer machen. Abseits von TYPO3 findet man ihn wahrscheinlich beim Erkunden lokaler Cafés oder beim Fußball.
More From Author