TYPO3 Rich Text Editor RTE: Vollständiger Leitfaden für Redakteure, Adminis und Entwickler

Der TYPO3 Rich Text Editor (RTE) ist das Bearbeitungswerkzeug, mit dem Sie Website-Inhalte im TYPO3-Backend formatieren können, ohne HTML schreiben zu müssen. Er hilft Redakteuren dabei, Überschriften, Links, Listen, Tabellen und grundlegende Textformatierungen hinzuzufügen, während die Inhalte strukturiert und einfacher zu verwalten bleiben.

TYPO3 Rich Text Editor RTE: Vollständiger Leitfaden für Redakteure, Adminis und Entwickler

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?

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

Ü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

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

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

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

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

Quellcode-Ansicht
  • 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

Best Practices für RTE-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.

  • enableRichtext ist nicht aktiviert
  • keine gültige richtextConfiguration zugewiesen
  • Feld ist nicht als type => text definiert
  • 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

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

Sven Thelemann

Kommentare und Antworten

×

Name ist erforderlich!

Geben Sie einen gültigen Namen ein

Gültige E-Mail ist erforderlich!

Gib eine gültige E-Mail Adresse ein

Kommentar ist erforderlich!

* These fields are required.

Sei der erste der kommentiert