Wenn Sie schon einmal Inhalte in TYPO3 eingefügt und sich gefragt haben, warum sie schlicht, eingeschränkt oder anders als erwartet aussehen, ist der Grund einfach: Nicht jedes TYPO3-Feld ist ein Rich-Text-Feld. Einige Felder sind lediglich einfache Textfelder, während andere für die Verwendung des RTE konfiguriert sind.
In modernen TYPO3-Versionen wird der RTE von rte_ckeditor und CKEditor 5 unterstützt und bietet Redakteuren eine vertraute Schreibumgebung, die Word oder Google Docs ähnelt. Die verfügbaren Schaltflächen, Formatierungsoptionen und zulässigen Stile hängen jedoch davon ab, wie die TYPO3 Website von Administratoren oder Integratoren konfiguriert wurde.
Dieser Leitfaden behandelt die Nutzung des TYPO3 RTE für Redakteure, Admins und Entwickler. Sie erfahren, was der RTE ist, wo er angezeigt wird, wie Sie ihn für saubere Website-Inhalte verwenden, wie die Konfiguration funktioniert und wie Sie häufige TYPO3 RTE-Probleme beheben.
Was ist der TYPO3 Rich Text Editor?

Der TYPO3 RTE hilft Redakteuren dabei, Inhalte direkt im Backend zu formatieren, während die finale Website-Ausgabe durch TYPO3-Konfiguration und Frontend-Styling gesteuert wird.
Was der TYPO3 RTE macht
- Der TYPO3 Rich Text Editor (RTE) ist das Backend-Tool, das zum Formatieren von Rich-Text-Feldern verwendet wird, ohne HTML schreiben zu müssen.
- Er hilft Redakteuren dabei, strukturierte Inhalte mit Überschriften, Absätzen, fett/kursivem Text, Listen, Links, Tabellen, E-Mail-Links und Anker-Links zu erstellen.
Warum einige TYPO3-Felder einfach aussehen
TYPO3 zeigt Rich-Text-Optionen nur an, wenn ein Feld dafür konfiguriert ist.
- Einige Felder sind einfache Textfelder.
- Einige Felder öffnen die vollständige RTE-Toolbar.
- Ob der RTE erscheint, hängt von der TYPO3-Konfiguration ab.
CKEditor 5 in modernem TYPO3
Modernes TYPO3 verwendet CKEditor 5 für eine sauberere und flexiblere Bearbeitungserfahrung.
- Modernes TYPO3 nutzt rte_ckeditor mit CKEditor 5.
- Admins und Integratoren steuern die Toolbar-Buttons, Formatierungsoptionen und verfügbaren Styles.
Warum der RTE wichtig ist
Ein gut konfigurierter RTE macht Inhalte leichter bearbeitbar, ohne inkonsistente Designentscheidungen zuzulassen.
- Der RTE hält Website-Inhalte sauber, strukturiert, einfacher bearbeitbar und über Seiten hinweg konsistent.
- Redakteure übernehmen Schreiben und Formatierung.
- TYPO3-Konfiguration, Frontend-CSS und Website-Designregeln steuern das finale Live-Erscheinungsbild.
TYPO3 RTE im Jahr 2026: CKEditor 5, TYPO3 v14 LTS und Versionshinweise
Die TYPO3 RTE-Konfiguration sollte basierend auf der aktuellen Version der Website, dem Support-Status und der CKEditor-Kompatibilität geplant werden.
Aktueller Versionskontext
- Stand Mai 2026 sollte moderne TYPO3 RTE-Dokumentation CKEditor 5 als Grundlage annehmen.
- TYPO3 v14 LTS ist der aktuelle Fokus für neue TYPO3-Projekte.
- TYPO3 v13 LTS bleibt relevant für bestehende Websites, die noch nicht migriert wurden.
- TYPO3 v12 ist jetzt Legacy, da der kostenlose Community-Support am 30. April 2026 beendet wurde.
Warum das für RTE-Setup wichtig ist
Das RTE-Verhalten kann sich bei TYPO3 Upgrades ändern, besonders bei Custom-Konfigurationen oder Editor-Berechtigungen.
- Toolbar-Einstellungen, YAML-Presets, Page TSconfig und benutzerdefinierte CKEditor-Integrationen sollten überprüft werden.
- Extension-Kompatibilität vor dem Upgrade prüfen.
- Backend-Bearbeitung, eingefügter Inhalt, Links, Tabellen und Frontend-Darstellung nach der Migration testen.
- Ältere CKEditor-4-basierte Setups sollten nicht mehr als Best Practice betrachtet werden.
Praktische Empfehlung
Neue und bestehende TYPO3-Projekte sollten RTE-Einstellungen basierend auf der Projektversion und dem Upgrade-Pfad wählen.
- Für neue Projekte sollte TYPO3 v14 LTS priorisiert werden.
- Für bestehende Projekte sollte geprüft werden, ob die Website auf v13, v14 oder einer älteren Version läuft.
- Für TYPO3 v12-Websites sollte ein Upgrade geplant oder ELTS-Support genutzt werden, anstatt sich auf kostenlosen Community-Support zu verlassen.
Für wen dieser Leitfaden gedacht ist
Verschiedene TYPO3-Nutzer arbeiten unterschiedlich mit dem RTE – von alltäglicher Inhaltspflege bis hin zu Konfiguration und Entwicklung.
Für Content-Redakteure
- Hilft Redakteuren beim Formatieren von Text, Erstellen von Links, Verwenden von Überschriften, Erstellen von Listen/Tabellen, Bereinigen eingefügter Inhalte, Vermeiden fehlerhafter Formatierungen und beim Vorschauen von Inhalten vor der Veröffentlichung.
Für Admins und Integratoren
- Hilft Admins und Integratoren beim Verwalten von RTE-Presets, Toolbar-Buttons, YAML-Konfiguration, Page TSconfig, erlaubten CSS-Klassen, Link-Browser-Optionen, Editor-Berechtigungen und sauberem HTML-Output.
Für Entwickler
- Hilft Entwicklern zu verstehen, wie Rich-Text-Felder aktiviert werden, wie benutzerdefinierte Felder RTE-Konfiguration nutzen, wie CKEditor 5 Integrationen beeinflusst, warum Backend- und Frontend-Ausgabe unterschiedlich sein kann und was bei TYPO3-Upgrades zu prüfen ist.
Hauptziel dieses Leitfadens
Ein gut konfigurierter TYPO3 RTE sollte die Bearbeitung für Nutzer einfach machen und gleichzeitig die Website sauber, konsistent und wartbar halten.
- Der Leitfaden erklärt sowohl die Nutzung als auch die Konfiguration des TYPO3 RTE.
- Ein guter RTE sorgt für saubere, konsistente, editorfreundliche, upgrade-sichere und designkonforme Inhalte.
Wo der RTE in TYPO3 erscheint
Der RTE erscheint nur in TYPO3-Feldern, die für Rich-Text-Bearbeitung konfiguriert sind.
Häufige Einsatzorte
- Text-Content-Elemente
- Text & Media Elemente
- Benutzerdefinierte Backend-Felder
- Ausgewählte Formular-Textbereiche in neueren TYPO3-Versionen
RTE vs. Plain-Text-Felder
- RTE-aktivierte Felder zeigen eine Formatierungs-Toolbar.
- Plain-Text-Felder erlauben nur einfachen Text.
- Deshalb unterstützen einige TYPO3-Felder Links, Listen und Styling, während andere dies nicht tun.
TYPO3 RTE vs Plain-Text-Feld vs Content-Element
TYPO3 verwendet unterschiedliche Feldtypen für unterschiedliche Inhaltsanforderungen, daher hängt die richtige Wahl davon ab, ob Inhalt Formatierung, Struktur oder Layout-Steuerung benötigt.
Anwendungsfall | Beste TYPO3-Option | Warum | Häufiger Fehler |
Einfacher Text ohne Formatierung | Plain-Text-Feld | Hält Eingaben sauber und eingeschränkt | Erwartung, dass Links, Listen oder Fett funktionieren |
Formatierter Fließtext | RTE-aktiviertes Feld | Ermöglicht Überschriften, Links, Listen und grundlegendes Styling | Zu viel manuelles Styling |
Text mit Bildern oder Medien | Text & Media Content-Element | Hält Layout responsiv und wartbar | Bilder direkt im RTE einfügen |
Seitenabschnitte, Karten, Spalten oder Layouts | Dedizierte Content-Elemente | Hält Design konsistent mit dem Website-Template | Layouts im RTE bauen |
Datenpräsentation | Tabelle im RTE oder Tabellen-Element | Organisiert strukturierte Daten | Tabellen für Layout statt Daten nutzen |
Ein Plain-Text-Feld ist nur für einfache Eingaben gedacht, während ein RTE-aktiviertes Feld Redakteuren Formatierungswerkzeuge zur Verfügung stellt. Für Layout, Medien oder komplexe Seitenabschnitte sind TYPO3 Content-Elemente in der Regel die bessere Wahl.
Alltägliche Bearbeitung im TYPO3-RTE
Der TYPO3 RTE bietet Redakteuren grundlegende Werkzeuge, um Inhalte klar zu strukturieren, ohne HTML zu verwenden.
Überschriften, Absätze und Inline-Formatierung

- Verwende Überschriften, um Inhalte in klare Abschnitte zu gliedern.
- Verwende Absätze für normalen Fließtext.
- Verwende Fett für wichtige Hervorhebungen und Kursiv für spezielle Begriffe.
- Unterstreichen vermeiden, außer es ist Teil des definierten Styles.
- Enter für neuen Absatz.
- Shift + Enter für Zeilenumbruch.
- Wenn das Content-Element bereits ein Header-Feld hat, keine zusätzliche Hauptüberschrift im RTE verwenden.
Interne, externe, E-Mail- und Anker-Links

- Verwende interne Links, um andere TYPO3-Seiten zu verknüpfen.
- Verwende externe Links für andere Websites.
- Verwende E-Mail-Links, wenn Besucher jemanden direkt kontaktieren sollen.
- Verwende Anker-Links, um Leser zu einem bestimmten Abschnitt auf derselben Seite zu führen.
- Überprüfe immer vor der Veröffentlichung, ob alle Links korrekt funktionieren.
Aufzählungen und nummerierte Listen

- Verwende Aufzählungen für verwandte Punkte.
- Verwende nummerierte Listen für Schritte oder Prozesse.
- Listen kurz halten für bessere Lesbarkeit.
Tabellen für strukturierte Daten

- Verwende Tabellen nur, wenn die Informationen Zeilen und Spalten benötigen.
- Füge Zellen nur hinzu, entferne oder verbinde sie nur, wenn es die Klarheit verbessert.
- Verwende Tabellen nicht, um Seitenlayouts zu erstellen.
- Platziere keine Bilder in Tabellen; nutze stattdessen dedizierte TYPO3 Content-Elemente.
Sonderzeichen

- Verwende die Sonderzeichen-Funktion für Symbole wie ©, ®, akzentuierte Buchstaben oder andere Zeichen, die nicht auf deiner Tastatur verfügbar sind.
- Dies sorgt für konsistente Symbole und verhindert das Kopieren aus unzuverlässigen Quellen.
Quellcode-Ansicht und wann sie genutzt wird

- Verwende die Quellcode-Ansicht nur, wenn die Schaltfläche verfügbar ist und du den zugrunde liegenden HTML-Code überprüfen musst.
- Sie kann dabei helfen, unerwünschte Tags, fehlerhafte Formatierungen oder aus Word und anderen Editoren eingefügten Code zu erkennen.
- Die meisten Redakteure benötigen die Quellcode-Ansicht nur selten, und der Zugriff hängt von der RTE-Konfiguration der Website ab.
TYPO3 RTE Best Practices für saubere Website-Inhalte

Sauberer RTE-Content hängt von Struktur, Konsistenz und kontrollierter Formatierung ab, nicht davon, mehr visuelles Styling im Editor hinzuzufügen.
Saubere Struktur verwenden
- Verwende echte Überschriften, um Inhalte in Abschnitte zu gliedern.
- Erstelle keine falschen Überschriften mit Fettschrift.
- Halte Absätze kurz und leicht lesbar.
- Verwende Fett nur zur wichtigen Hervorhebung.
- Vermeide Unterstreichungen, außer sie sind Teil des freigegebenen Website-Styles.
Konsistente Formatierung beibehalten
- Füge keine unnötigen Farben, Schriftarten oder manuelles Styling hinzu.
- Folge dem Website-Template statt eigene Styles im RTE zu erstellen.
- Verwende beschreibende Linktexte statt vager Texte wie „hier klicken“.
- Verwende Tabellen nur für echte Daten mit Zeilen und Spalten.
- Vorschau der Seite vor der Veröffentlichung prüfen (Desktop und Mobile).
Inhalte sorgfältig einfügen
- „Als Plain Text einfügen“ verwenden beim Kopieren aus Word, Google Docs oder anderen Websites.
- Entferne zusätzliche Abstände, kaputte Listen, ungewöhnliche Schriftarten oder versteckte Styles vor der Veröffentlichung.
Diese RTE-Fehler vermeiden
- Keine komplexen Layouts im RTE erstellen.
- Keine Tabellen für Layouts verwenden.
- Keine benutzerdefinierten Schriftarten, Farben, Abstände oder Größen erzwingen.
- Keine Bilder direkt einfügen, außer das TYPO3-Setup unterstützt dies.
- Keine formatierten Inhalte ohne Bereinigung einfügen.
- Keine Raw-Embeds, Scripts oder eigenes HTML hinzufügen, außer es wurde von Admins freigegeben.
TYPO3 RTE-Konfigurationsgrundlagen
Die TYPO3 RTE-Konfiguration steuert, welche Toolbar-Buttons Redakteure sehen, welche Stile sie verwenden können und wie Rich-Text-Inhalte gespeichert werden.
Wo die RTE-Konfiguration liegt
RTE-Einstellungen werden in der Regel von Admins, Integratoren oder Entwicklern verwaltet über:
- YAML-Dateien
- Page TSconfig
- Sitepackage-Dateien
- TCA-Feldkonfiguration
RTE-Presets und YAML
TYPO3 kann unterschiedliche RTE-Presets verwenden, abhängig von Redakteursrolle und Inhaltstyp. Ein einfacher Redakteur benötigt nur grundlegende Buttons, während fortgeschrittene Nutzer mehr Optionen brauchen.
Beispiel für ein einfaches YAML-Toolbar-Setup:
editor:
config:
toolbar:
items:
- heading
- bold
- italic
- link
- bulletedList
- numberedList
- undo
- redo
Registrierung eines Custom-Presets
Ein Custom-Preset kann im Sitepackage registriert werden, damit das Setup wartbar bleibt.
$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['custom_default'] =
'EXT:site_package/Configuration/RTE/CustomDefault.yaml';
Dann wird es per Page TSconfig zugewiesen:
RTE.default.preset = custom_default
Bewährte Verfahren
Halte die Toolbar auf die wirklich benötigten Optionen beschränkt. Verwende kleinere Presets für reguläre Redakteure und erweiterte Presets nur für Nutzer, die mehr Kontrolle benötigen.
So aktivierst du den RTE für eigene TYPO3-Felder
Ein benutzerdefiniertes TYPO3-Feld zeigt den Rich Text Editor nur dann an, wenn das Feld als Textfeld konfiguriert ist und die Rich-Text-Bearbeitung aktiviert wurde.
Grundlegende TCA-Konfiguration
Verwende type => text, aktiviere Rich Text und weise das passende RTE-Preset zu.
'custom_rte_text' => [
'label' => 'Custom rich text',
'config' => [
'type' => 'text',
'enableRichtext' => true,
'richtextConfiguration' => 'custom_default',
'cols' => 40,
'rows' => 15,
],
],
Wann kein RTE verwendet werden sollte
Nicht jedes Feld benötigt Formatierung.
- Vermeide RTE für kurze Labels, SEO-Titel, Metadatenfelder, technische Werte und einfache Formulareingaben.
- Nutze Plain-Text-Felder, wenn Inhalte einfach und kontrolliert bleiben müssen.
Warum ein Feld als Plain Text angezeigt wird
Wenn der RTE nicht angezeigt wird, ist die Feldkonfiguration möglicherweise unvollständig.
enableRichtextist nicht aktiviert- keine gültige
richtextConfigurationzugewiesen - Feld ist nicht als
type => textdefiniert - Custom-Preset ist nicht registriert
- YAML- oder TSconfig-Fehler
- Benutzerrechte verhindern RTE-Zugriff
So passt du die TYPO3 RTE-Toolbar an
Die Toolbar sollte nur die Funktionen enthalten, die Redakteure im Arbeitsablauf benötigen.
Einrichtung der Basis-Symbolleiste

Verwalte die Toolbar-Buttons im RTE-YAML-Preset. Behalte die gängigen Optionen wie Überschriften, Fett, Kursiv, Links, Listen, Rückgängig und Wiederholen bei.
editor:
config:
toolbar:
items:
- heading
- bold
- italic
- link
- bulletedList
- numberedList
- undo
- redo
Rollenbasierte Toolbars
Verschiedene Redaktionsteams können unterschiedliche Voreinstellungen verwenden.
- Einfache Toolbar für reguläre Redakteure
- Erweiterte Toolbar für Admins oder Power-User
- Zuweisung über Page TSconfig oder Feldkonfiguration:
RTE.default.preset = editor_basic
RTE.config.tt_content.bodytext.preset = editor_advanced
Erweiterte Toolbar-Optionen
Füge erweiterte Funktionen nur hinzu, wenn sie den Bearbeitungsworkflow unterstützen.
- Aktiviere die Quellcode-Bearbeitung nur für geschulte Benutzer.
- Füge den Vollbildmodus für längere Inhalte hinzu.
- Aktiviere die Wortanzahl nur dort, wo redaktionelle Vorgaben oder Begrenzungen relevant sind.
Links im TYPO3 RTE konfigurieren
Links benötigen eine klare Konfiguration, da Redakteure sie häufig verwenden und eine fehlerhafte Link-Verwaltung SEO, Barrierefreiheit und Nutzererfahrung beeinträchtigen kann.
TYPO3 Link Browser verwenden
Der TYPO3 Link Browser bietet Redakteuren eine kontrollierte Möglichkeit, verschiedene Link-Typen zu erstellen:
- Interne Seitenlinks
- Externe Website-Links
- E-Mail-Links
- Datei-Links
- Anker-Links
editor:
config:
toolbar:
items:
- heading
- bold
- italic
- link
- bulletedList
- numberedList
Freigegebene Link-Styles hinzufügen
Link-Klassen sollten aus dem freigegebenen Design-System der Website stammen.
- Verwende Klassen für Button-Links, Pfeil-Links oder hervorgehobene Links.
- Erlaube Redakteuren nicht, eigenständig zufällige Link-Styles zu erstellen.
RTE.default.proc.allowedClasses := addToList(btn-primary, btn-secondary, arrow-link)
editor:
config:
style:
definitions:
- { name: 'Primary Button Link', element: 'a', classes: [ 'btn-primary' ] }
- { name: 'Arrow Link', element: 'a', classes: [ 'arrow-link' ] }
Besseren Linktext schreiben
Guter Linktext sollte erklären, wohin der Nutzer weitergeleitet wird.
- Verwende beschreibende Texte wie „TYPO3 Upgrade Services ansehen“.
- Vermeide vage Texte wie „hier klicken“ oder „mehr lesen“, wenn sie ohne Kontext stehen.
- Halte Linktexte nützlich für Leser, Suchmaschinen und Screenreader.
Erlaubtes HTML, CSS-Klassen und Content-Cleanup
Diese Konfiguration legt fest, welches HTML, welche CSS-Klassen und welche eingefügten Formatierungen erlaubt sind, bevor RTE-Inhalte gespeichert und im Frontend gerendert werden.
Erlaubtes HTML steuern
Verwende htmlSupport, um nur das Markup zu erlauben, das Redakteure tatsächlich benötigen.
editor:
config:
htmlSupport:
allow:
- { name: 'p', attributes: false, classes: false, styles: false }
- { name: 'h2', attributes: false, classes: false, styles: false }
- { name: 'h3', attributes: false, classes: false, styles: false }
- { name: 'a', attributes: true, classes: true, styles: false }
Zulässige CSS-Klassen definieren
Erlaube nur Klassen, die bereits im Frontend-Designsystem existieren.
RTE.default.proc.allowedClasses := addToList(btn-primary, btn-secondary, table-striped, arrow-link)
Inline-Styles entfernen
Unerwünschte Inline-Styles aus eingefügten oder tabellenbasierten Inhalten entfernen.
RTE.default.proc.entryHTMLparser_db.tags.table.fixAttrib.style.unset = 1
RTE.default.proc.entryHTMLparser_db.tags.table.fixAttrib.width.unset = 1
RTE.default.proc.entryHTMLparser_db.tags.table.fixAttrib.height.unset = 1
Eingefügten Inhalt sauber halten
Eingefügter Inhalt sollte keine versteckten Formatierungen aus Word, Google Docs oder anderen Websites enthalten.
- Bei Bedarf „Als Plain Text einfügen“ verwenden
- Unnötige Tags, Klassen und Inline-Styles entfernen
- Frontend nach der Bereinigung in der Vorschau prüfen
Backend-Vorschau vs. Frontend-Ausgabe
Der TYPO3 Backend-Editor dient der Inhaltserstellung, während die Live-Website Frontend-CSS, Templates und TYPO3-Verarbeitung für das finale Design nutzt.
Warum Unterschiede entstehen können
- Die RTE-Vorschau zeigt eine Bearbeitungsansicht, nicht das exakte Frontend-Layout.
- Schriftarten, Abstände, Farben und responsives Verhalten werden durch das CSS der Website gesteuert.
- TYPO3 kann gespeicherte RTE-Inhalte außerdem beim Rendern im Frontend transformieren oder bereinigen.
Was Redakteure tun sollten
- RTE für Struktur, nicht für Designentscheidungen nutzen
- Frontend-Vorschau vor Veröffentlichung prüfen
- Links, Tabellen, Abstände und mobile Darstellung kontrollieren
Bilder, Medien und Embeds im TYPO3 RTE
Bilder und Medien benötigen korrektes Layout, Responsivität und Barrierefreiheit, daher sollten sie meist außerhalb des RTE-Textfelds verarbeitet werden.
Empfohlener Ansatz
- Dedizierte TYPO3 Content-Elemente für Bilder, Videos, Medienblöcke und Embeds verwenden
- Text & Media Elemente nutzen, wenn Text und visuelle Inhalte kombiniert werden sollen
- Bilder nur dann im RTE verwenden, wenn das TYPO3-Setup dies explizit unterstützt und steuert
Warum das wichtig ist
- Bilder innerhalb von RTE-Text können Layout-, Mobile- und Barrierefreiheitsprobleme verursachen.
- Tabellen sollten nicht verwendet werden, um Bilder zu platzieren oder auszurichten.
- Dedizierte Content-Elemente machen Medien einfacher zu verwalten, zu stylen und responsiv zu halten.
Häufige TYPO3 RTE-Probleme und Lösungen
Die meisten TYPO3-RTE-Probleme entstehen durch Konfiguration, Berechtigungen, eingefügte Formatierungen oder Unterschiede zwischen Backend-Bearbeitung und Frontend-Darstellung.
Problem | Wahrscheinliche Ursache | Umsetzbare Lösung |
RTE wird nicht geladen | Fehlerhafte YAML, Cache-Problem oder Backend-Konfigurationsproblem | YAML-Syntax prüfen, TYPO3-Caches leeren und Backend-Benutzerkonfiguration zurücksetzen |
Fehlende Toolbar-Buttons | Toolbar-Optionen sind durch Preset oder Benutzerrolle eingeschränkt | Zugewiesenes RTE-Preset und Redakteursberechtigungen prüfen |
Source-Ansicht fehlt | Quellcode-Bearbeitung ist für dieses Setup deaktiviert | Nur für geschulte Benutzer aktivieren, falls erforderlich |
Eingefügter Inhalt sieht fehlerhaft aus | Versteckte Formatierungen aus Word, Google Docs oder anderen Websites | „Als Plain Text einfügen“ verwenden oder Formatierung vor Veröffentlichung entfernen |
Eigene Styles werden nicht angezeigt | CSS-Klassen sind nicht erlaubt oder nicht im RTE geladen | Erlaubte Klassen und RTE-Content-CSS-Konfiguration prüfen |
Links funktionieren nicht | Falscher Linktyp, fehlerhaftes Ziel oder Problem im Link Browser | Link über TYPO3 Link Browser neu erstellen und testen |
Tabellen sehen im Frontend anders aus | Frontend-CSS steuert Tabellenstyling | Seite in der Vorschau prüfen und nur freigegebene Tabellen-Styles verwenden |
YAML-Änderungen werden nicht übernommen | Preset nicht registriert, Cache nicht geleert oder falscher Pfad | Preset-Registrierung prüfen, Dateipfad kontrollieren und Caches leeren |
RTE funktioniert für Admin, aber nicht für Editor | Unterschiedliche Rollen- oder Rechtekonfiguration | Backend-Benutzerrechte und zugewiesene RTE-Konfiguration vergleichen |
CKEditor-Plugin nach Upgrade fehlerhaft | Altes Plugin ist nicht mit CKEditor 5 kompatibel | Plugin-Kompatibilität prüfen und veraltete CKEditor-4-Integrationen ersetzen |
TYPO3 RTE und CKEditor 5 Migrationshinweise
Ältere TYPO3-RTE-Setups müssen möglicherweise überprüft werden, da CKEditor 5 die Funktionsweise von Editor-Plugins, Konfiguration und benutzerdefinierten Integrationen verändert hat.
Wichtige Prüfungen
- CKEditor-4-Plugins funktionieren nicht automatisch mit CKEditor 5.
- Überprüfe alte YAML-Dateien und Page TSconfig-Einstellungen.
- Teste benutzerdefinierte CKEditor-Plugins vor dem Einsatz in der Produktion.
- Prüfe, wie sich eingefügtes HTML nach der Migration verhält.
- Vergleiche die Backend-Bearbeitung mit der Frontend-Darstellung.
- Stelle sicher, dass alle TYPO3 Extensions, die vom RTE-Verhalten abhängen, die Ziel-TYPO3 version unterstützen.
Migrationspriorität
- Beginne mit der Toolbar und den Presets.
- Danach prüfe erlaubte Klassen, Link-Verwaltung, Tabellenverhalten und die Bereinigung eingefügter Inhalte.
- Teste anschließend reale Redakteurs-Workflows, damit Konfigurationsprobleme vor der Veröffentlichung erkannt werden.
Finale TYPO3 RTE-Checkliste
Verwende diese Checkliste vor der Veröffentlichung von Inhalten und bei der Überprüfung des RTE-Setups für Redakteure.
Redakteurs-Checkliste | Admin-/Integrator-Checkliste |
Überschriftenreihenfolge ist korrekt. | Das richtige RTE-Preset ist ausgewählt. |
Links sind getestet. | Die Toolbar ist nach Redakteursrolle vereinfacht. |
Eingefügter Inhalt ist bereinigt. | Erlaubte CSS-Klassen sind definiert. |
Tabellen werden nur für echte Daten verwendet. | Der TYPO3 Link Browser ist konfiguriert. |
Keine unerwünschten Inline-Styles vorhanden. | Unsichere Inline-Styles werden entfernt. |
Bilder oder Medien verwenden die richtigen TYPO3 Content-Elemente. | Frontend-Ausgabe wird getestet. |
Frontend-Vorschau ist geprüft. | Redakteursregeln sind dokumentiert. |
Mobile Ansicht wird vor der Veröffentlichung geprüft. | RTE-Konfiguration wird nach TYPO3-Upgrades erneut getestet. |
Zusammenfassung
Ein gut konfigurierter TYPO3 RTE hilft Redakteuren dabei, saubere und strukturierte Inhalte zu erstellen, während die Formatierung im Einklang mit dem Designsystem der Website bleibt.
Der RTE ist für alltägliche Aufgaben wie das Schreiben von Texten, das Hinzufügen von Links, das Erstellen von Listen, die Nutzung von Tabellen und das Bereinigen eingefügter Inhalte nützlich. Er sollte jedoch für die Inhaltsstruktur verwendet werden, nicht zum Erstellen von Layouts oder zum Erzwingen eigener Designstile.
Für beste Ergebnisse sollten Redakteure einfache Formatierungsregeln befolgen, Inhalte im Frontend in der Vorschau prüfen und vermeiden, Bilder oder komplexe Layouts direkt im RTE einzufügen. Admins und Integratoren sollten die Toolbar-Optionen kontrolliert halten, freigegebene Styles definieren und das Setup nach TYPO3-Upgrades überprüfen.
Wenn der RTE korrekt konfiguriert ist, werden TYPO3-Inhalte einfacher zu bearbeiten, konsistenter über alle Seiten hinweg und langfristig sicherer zu pflegen.
Ein strukturierter Start für TYPO3-Projekte
Nutzen Sie diesen Leitfaden, um typische Fehler zu vermeiden und Ihr TYPO3-Projekt von Anfang an auf ein solides Fundament zu stellen.
FAQs
Der TYPO3 RTE Rich Text Editor ist der Editor im TYPO3-Backend, mit dem Inhalte formatiert werden können, ohne HTML schreiben zu müssen. Er ermöglicht Redakteuren das Hinzufügen von Überschriften, Links, Listen, Tabellen und grundlegenden Textformatierungen.
Nicht ganz. Der TYPO3 RTE ist die Rich-Text-Bearbeitungsfunktion innerhalb von TYPO3, während CKEditor die zugrunde liegende Editor-Technologie ist, die diese Funktion bereitstellt.
Ja. Moderne TYPO3-Versionen nutzen rte_ckeditor mit CKEditor 5 für die Rich-Text-Bearbeitung.
Bei benutzerdefinierten Feldern muss das Feld in der Regel als Textfeld konfiguriert sein, enableRichtext aktiviert haben und eine gültige richtextConfiguration zugewiesen bekommen.
Einige Schaltflächen können fehlen, weil das zugewiesene RTE-Preset, die Benutzerberechtigungen oder die Page TSconfig-Konfiguration bestimmte Funktionen einschränken.
Neue Projekte sollten in der Regel TYPO3 v14 LTS bevorzugen. TYPO3 v13 LTS bleibt jedoch weiterhin eine sinnvolle Wahl für bestehende Projekte, die noch nicht für eine Migration bereit sind.
Ansprechpartner für Internetagentur und TYPO3 Projekte
Sven Thelemann
Servicepartner - Deutschland

Sei der erste der kommentiert