Lernseite · Inhaltselemente und Rich-Text-Editor
Inhalte gestalten mit Inhaltselementen und dem Rich-Text-Editor
Inhaltselemente sind die Bausteine jeder TYPO3-Seite: Überschriften, Texte, Bilder, Videos, Download-Listen und Plugins. Auf dieser Seite begleitest du die Redakteurin Lena von der Stadtbibliothek Weidenau. Sie bereitet die Seite „Veranstaltungen“ für eine Lesung im März vor. Dafür braucht sie einen Ankündigungstext mit Foto der Autorin, ein Video-Interview, das Programmheft als PDF und eine Liste weiterer Termine. Ihr Kollege Tom ist Integrator und betreut die Technik der Website. Danach weißt du, wie du Inhaltselemente anlegst, bearbeitest und sicher mit dem Rich-Text-Editor arbeitest.
Ein neues Inhaltselement anlegen
Inhalte bearbeitest du fast immer im Modul Content > Layout. Bis TYPO3 13 hieß das Hauptmodul Web und das Modul Page. Lena wählt im Seitenbaum die Seite „Veranstaltungen“. Rechts sieht sie die Inhaltsbereiche der Seite. In jedem Bereich steht der Knopf „+ Create new content“. Ein Klick öffnet den Assistenten „New Page Content“.
- Im Seitenbaum die Seite wählen.
- Im gewünschten Bereich auf „+ Create new content“ klicken.
- Im Assistenten einen Reiter und darin den Elementtyp wählen.
- Das Formular ausfüllen, zum Beispiel Überschrift und Text.
- Speichern und schließen.
Der Assistent sortiert die Typen in Reiter. Welche Reiter und Typen du siehst, hängt von der Installation und deinen Rechten ab. Fortgeschrittene Redakteure oder Administratoren sehen oft mehr Gruppen und Typen. Fehlt dir ein Typ, liegt das meist an den Rechten deiner Gruppe.
Die wichtigsten Elementtypen
Im Reiter „Typical page content“ liegen die Elemente für normale Seiten. Dazu gehören „Header Only“ für eine reine Überschrift, „Regular Text Element“ für Text, „Text & Images“, „Text & Media“ und „Images Only“. „Text & Media“ ist das meistgenutzte Element. Es verbindet Überschrift, Text und Medien wie Bilder, Videos oder Audio. Lena wählt es für den Ankündigungstext.
Der Reiter „Lists“ enthält strukturierte Elemente wie „Bullet List“, „Table“ und „File Links“. File Links zeigt eine Liste verlinkter Dateien zum Herunterladen, etwa PDFs. Die Dateien wählt man aus dem Modul Media oder lädt sie dabei hoch. Lena nutzt File Links für das Programmheft.
Weitere Reiter sehen meist nur fortgeschrittene Benutzer:
- Unter „Form elements“ liegen das Formular und das Anmeldeformular für Website-Benutzer.
- Unter „Menu“ liegen Menüs und Listen von Seitenlinks in verschiedenen Formen.
- Unter „Plugins“ liegen Plugins aus installierten Extensions.
- Unter „Special elements“ liegen „Plain HTML“, „Divider“ und „Insert records“.
Divider setzt eine waagerechte Trennlinie. Plain HTML gibt HTML-Code aus, den du selbst eintippst. TYPO3 gibt diesen Code ungeprüft aus, und er umgeht die Vorlagen der Website. Fehlerhaftes Markup kann die ganze Seite zerstören. Deshalb ist Plain HTML meist nur für erfahrene Redakteure freigeschaltet, und du setzt es zurückhaltend ein.
Insert records zeigt vorhandene Elemente an einer anderen Stelle an, ohne sie zu kopieren. Es ist also eine Referenz. Die Bibliothek hat einen Teaser „Jetzt Ausweis beantragen“, der auf zehn Seiten erscheinen soll. Tom legt ihn einmal an, und auf jeder Seite verweist ein Insert-records-Element darauf. Ändert Lena den Text des Originals, ändert sich jede Einbindung mit. Danach kann es nötig sein, den Cache der betroffenen Seiten zu leeren.
Überschriften mit Bedeutung
Fast jedes Element hat oben die Felder für die Überschrift. Ins Feld Header schreibt Lena „Lesung mit Mara Lindqvist“. Darunter steht das Auswahlfeld Type. Dort wählst du die Überschriftenebene, also ob die Überschrift eine Hauptüberschrift, eine Unterüberschrift oder eine noch tiefere Ebene ist. Zur Wahl stehen der Standardwert, die Layouts 1 bis 5 und „Hidden“.
Die Ebene folgt der Bedeutung, nicht dem Design. Wähle sie so, dass die Gliederung der Seite stimmt. Eine Unterüberschrift im Abschnitt „Programm“ bekommt also eine tiefere Ebene als der Abschnitt selbst. Screenreader und Suchmaschinen lesen aus diesen Ebenen die Struktur der Seite. Wie groß oder farbig eine Überschrift aussieht, regelt das Design der Website. Wählst du eine Ebene nur wegen der Schriftgröße, stimmt die Struktur nicht mehr.
Die Einstellung „Hidden“ blendet nur die Überschrift im Frontend aus. Das Element selbst bleibt sichtbar. Im Backend bleibt die Überschrift als Titel erhalten, so erkennst du das Element im Layout-Modul wieder.
Bearbeiten, speichern und den Typ wechseln
Ein vorhandenes Element öffnest du über das Stift-Symbol am Element. Seit TYPO3 14.2 öffnet sich das Formular im Layout-Modul standardmäßig in einem seitlichen Panel. Die Seite bleibt dabei im Hintergrund sichtbar. Oben im Panel stehen der Titel des Elements und die Knöpfe zum Speichern und Schließen. Mit „Expand“ wechselst du ins volle Formular. Wer das Panel nicht mag, schaltet es in den Benutzereinstellungen mit der Option „Use quick editing for records in the Layout module“ ab.
Im Formular änderst du alles, wofür du Rechte hast. Manche Felder sehen nur fortgeschrittene Redakteure oder Administratoren.
TYPO3 speichert nicht automatisch. Du musst selbst auf Speichern klicken. Verlässt du ein geändertes Formular über das Backend, fragt TYPO3 nach, ob du speichern willst. Schließt du aber das Browserfenster oder nutzt den Zurück-Knopf des Browsers, kommt keine Rückfrage. Dann sind die Änderungen weg.
Manchmal lässt sich ein Element nicht speichern. Dafür gibt es zwei typische Ursachen:
- Ein Pflichtfeld ist leer.
- Ein Feld enthält einen unzulässigen Wert, zum Beispiel Buchstaben in einem Zahlenfeld.
Liegt das betroffene Feld in einem anderen Reiter, bemerkst du es nicht sofort. Schau also alle Reiter durch.
Du kannst auch den Typ eines vorhandenen Elements ändern. Dazu wählst du im Feld „Type“ oben im Formular einen anderen Elementtyp. Weil der neue Typ andere Felder hat, lädt das Formular nach einer Rückfrage neu. Dabei geht nichts verloren. Die bisherigen Inhalte bleiben im Hintergrund gespeichert.
Lena speichert ohne Fehlermeldung, aber im Frontend bleibt alles alt. Dafür gibt es mehrere mögliche Gründe:
- Der Browser-Cache zeigt noch die alte Fassung.
- Der Seiten-Cache von TYPO3 liefert noch die alte Seite aus.
- Die Änderung wurde wegen eines Fehlers doch nicht gespeichert.
- Die Website arbeitet mit Workspaces. Dann ist die Änderung erst nach der Veröffentlichung live.
Hilft das Leeren des Caches nicht, fragst du den Administrator.
Verstecken, verschieben, kopieren und retten
Ein Element, das noch nicht fertig ist oder später wieder gebraucht wird, versteckst du. Dafür gibt es am Element einen Knopf zum Verstecken. Dasselbe geht im Reiter „Access“ des Formulars und im Kontextmenü. Ein verstecktes Element bleibt erhalten, erscheint aber nicht im Frontend. Mit demselben Knopf machst du es wieder sichtbar. Den Text zu löschen, wäre dagegen der falsche Weg.
Zum Verschieben ziehst du das Element mit der Maus in einen der hervorgehobenen Bereiche der Seite. Lässt du es auf einer Seite im Seitenbaum los, wandert es auf diese Seite. Hältst du beim Ziehen die Taste Strg gedrückt, entsteht stattdessen eine Kopie. Auf dem Mac nimmst du dafür die Taste Alt. Kopieren geht auch über das Kontextmenü: kopieren und an der Zielstelle einfügen.
Kopien sind standardmäßig versteckt. So erscheint eine Kopie nicht aus Versehen auf der Website. Gibt es auf der Zielseite schon ein Element mit derselben Überschrift, hängt TYPO3 außerdem den Zusatz „(copy 1)“ an, bei weiteren Kopien mit höherer Zahl. Das passiert zum Beispiel, wenn du auf derselben Seite kopierst. Du aktivierst sie bewusst, wenn sie fertig ist. Integratoren können dieses Verhalten abschalten.
Hat Lena ein Element versehentlich gelöscht, gibt es zwei Wege zurück. Das Modul Content > Recycler stellt gelöschte Elemente und sogar ganze Seiten wieder her. Dafür muss der Recycler installiert sein, und sie braucht die Rechte. Hat sie keinen Zugriff, hilft die Seitenhistorie. Im Kontextmenü der Seite im Seitenbaum wählt sie „History/Undo“. Dort sieht sie jede Änderung mit Unterschieden und kann sie rückgängig machen, auch eine Löschung.
Zwei Personen können nicht sinnvoll gleichzeitig am selben Element arbeiten. Öffnet Lena ein Element, an dem Tom gerade sitzt, zeigt TYPO3 einen Warnhinweis. Er nennt den Benutzer und seit wann er das Element bearbeitet. TYPO3 führt Änderungen nie zusammen. Wer zuletzt speichert, überschreibt die Änderungen der anderen Person.
Bilder einbinden und anpassen
Elemente wie „Text & Images“, „Text & Media“ und „Images Only“ haben einen Reiter „Images“ oder „Media“. Im Reiter „Images“ klickt Lena auf „Add image“. Ein Dateiauswahl-Fenster öffnet sich. Lena wählt links im Ordnerbaum einen Ordner und darin das Foto der Autorin. Beim nächsten Mal öffnet das Fenster wieder den zuletzt genutzten Ordner. Das Suchfeld findet Dateien nach Namen, auch in Unterordnern. Ein neues Bild kann sie dort auch hochladen.
Dabei ist wichtig: Die Datei liegt im Modul Media. Im Inhaltselement steht nur eine Verwendung dieser Datei. Deshalb kannst du Dateien in Media in andere Ordner verschieben, ohne dass sich die Website ändert. Eine Datei, die noch irgendwo verwendet wird, lässt sich aber nicht löschen.
Unter dem Vorschaubild klappt ein kleiner Pfeil die Metadaten auf, darunter Beschreibung, Alternativtext und Link. Diese Angaben kommen aus den Metadaten der Datei in Media. Du musst sie also nicht in jedem Element neu eingeben. Im Element kannst du sie für diese eine Stelle überschreiben. Die Metadaten der Datei bleiben dabei unverändert und gelten für alle anderen Verwendungen weiter.
Zwei Felder verwechselt man leicht:
- Der Alternativtext ersetzt das Bild, wenn es nicht gesehen wird, etwa für Screenreader. Er ist meist unsichtbar und muss die Information des Bildes transportieren.
- Die Beschreibung, im Formular Description, ist für alle sichtbar. Sie steht meist unter dem Bild und ergänzt es mit Zusatzinformationen.
Mit dem Image Cropper schneidest du ein Bild für dieses Element zu. Je nach Konfiguration gibt es feste Seitenverhältnisse, etwa für verschiedene Geräte. Der Ausschnitt gilt nur für diese Verwendung. Das Original in Media bleibt unverändert, und TYPO3 legt dafür keine neue Datei an. Andere Elemente zeigen das Bild weiter vollständig oder mit ihrem eigenen Ausschnitt.
Unter dem Bild folgen weitere Bereiche:
- Unter „Media Adjustments“ stehen Breite und Höhe in Pixeln sowie ein Rahmen. Die Felder sind optional. Bleiben sie leer, berechnet TYPO3 die Größe selbst. Manche Site Packages, etwa das Bootstrap Package, blenden diese Felder aus und passen die Bilder ohnehin an.
- Unter „Gallery Settings“ legst du fest, wo die Bilder zum Text stehen. Mehrere Bilder ordnet TYPO3 standardmäßig in Spalten an, zwei nebeneinander. Mit „Number of Columns“ änderst du das.
- Unter „Media Behavior“ schaltet „Enlarge on Click“ eine Großansicht ein. Ein Klick zeigt das Bild dann vergrößert an. Ohne weitere Einstellung öffnet es sich in einem eigenen Fenster, viele Websites zeigen es in einer Lightbox. Das Original bleibt dabei unverändert.
Videos einbetten
Für Videos und Audio nimmst du „Text & Media“. Es kann mehr als „Text & Images“, das nur stehende Bilder zeigt. Im Reiter „Media“ gibt es zwei Knöpfe:
- „Add media file“ bindet eine hochgeladene Datei aus Media ein oder lädt eine neue hoch.
- „Add media by URL“ bindet ein Video von einer Plattform wie YouTube oder Vimeo ein. Du fügst einfach die Adresse des Videos ein.
Unter der Auswahl stehen die erlaubten Dateiendungen und Plattformen. Welche es gibt, hängt von der Konfiguration und installierten Extensions ab. Mit „Autoplay“ startet ein Video, sobald die Seite lädt.
Lena will das Interview selbst hochladen, doch der Upload bricht ab. Die maximale Upload-Größe ist aus Sicherheitsgründen begrenzt. Dann bittet sie den Administrator, das Video hochzuladen. Oder sie stellt es auf eine Videoplattform und bettet es von dort ein.
Bei externen Plattformen ist der Datenschutz wichtig. Ein eingebettetes YouTube-Video kann schon beim Laden der Seite Daten an Dritte übertragen. Das kann Datenschutzgesetze berühren. Frag deshalb die Datenschutzbeauftragte oder die Rechtsabteilung. Oft ist eine Lösung mit Einwilligung vor dem Laden nötig, eine sogenannte Zwei-Klick-Lösung. Dann lädt das Video erst, wenn Besucher zustimmen. Solche Lösungen installiert der Integrator als Extension.
Der Rich-Text-Editor
Das Textfeld in „Text & Media“ ist ein Rich-Text-Editor, kurz RTE. Er bearbeitet formatierten Text mit Auszeichnungen wie fett, Listen, Überschriften und Links. Die Bedienung ähnelt einem Textverarbeitungsprogramm. Hinter dem RTE steckt in TYPO3 14 CKEditor 5. Ihn bindet die System-Extension rte_ckeditor ein.
Kurz zur Geschichte: Vor TYPO3 8 war der Editor HtmlArea Standard. Mit TYPO3 8 wurde CKEditor 4 Standard, mit TYPO3 12 kam der Wechsel auf CKEditor 5.
Welche Knöpfe die Werkzeugleiste zeigt, legt die Konfiguration der Installation fest. TYPO3 bringt die Presets minimal, default und full mit. Integratoren können eigene anlegen. Deshalb sieht der Editor nicht überall gleich aus. Das Default-Preset bietet unter anderem Fett und Kursiv, Listen mit Punkten oder Nummern, Links, Tabellen, Sonderzeichen und einen Knopf zum Entfernen von Formatierungen.
Im Menü „Heading“ bietet das Default-Preset Paragraph, Heading 2, Heading 3 und vorformatierten Text an. Heading 1 fehlt mit Absicht. Die Hauptüberschrift kommt aus dem Header des Elements oder der Seite.
Manche Auszeichnungen tragen Bedeutung, andere nur Aussehen. Strong, also fett, markiert wichtige Stellen. Emphasis, also kursiv, markiert eine Betonung. Beides werten Screenreader und Suchmaschinen aus. Eine rote Schrift oder eine große Schrift im Fließtext tragen dagegen keine Bedeutung. Für Überschriften nimmst du echte Überschriftenebenen.
Tastenkürzel sparen Zeit. Unter Windows macht Strg + B den markierten Text fett, Strg + I kursiv. Auf dem Mac nimmst du Cmd statt Strg.
Lena kopiert den Pressetext des Verlags aus einem Textverarbeitungsprogramm. Er bringt fremde Schriftarten und Stile mit. Der Editor bereinigt beim Einfügen schon vieles. Für übrige Formatierungen markiert sie den Text und klickt „Remove Format“. Danach formatiert sie mit den Stilen der Website.
Zwei Zeichen sind normalerweise unsichtbar. Der RTE hebt sie beim Bearbeiten farbig hervor, damit du siehst, wo sie stehen:
- Ein geschütztes Leerzeichen, englisch Non-breaking space, hält zwei Wörter in derselben Zeile zusammen. Zwischen „10“ und „kg“ bricht die Zeile dann nie um. Unter Windows und Linux fügst du es mit Strg + Shift + Leertaste ein.
- Ein weiches Trennzeichen, englisch Soft hyphen, markiert eine mögliche Trennstelle in einem Wort. Ein Bindestrich erscheint nur, wenn das Wort sonst nicht in die Zeile passt. Das Kürzel ist Strg + Shift + Minus, außerdem gibt es einen Knopf dafür.
Auf dem Mac nimmst du für beide Zeichen Alt statt Strg. Die farbige Markierung siehst du nur im Backend. Auf der Website wirken die Zeichen nur auf den Zeilenumbruch.
Links setzen und entfernen
Für einen Link markierst du den Text und klickst auf das Link-Symbol. Schneller geht es mit Strg + K, auf dem Mac Cmd + K. Das Kürzel öffnet den Link-Dialog aber nur, wenn der Cursor im Editor steht. Außerhalb des Editors öffnet dieselbe Kombination die Live-Suche des Backends.
Es erscheint der Link Browser. Seine Reiter zeigen, wohin ein Link führen kann:
- Auf eine Seite der Website, im Reiter „Page“.
- Auf eine Datei oder einen Ordner, zum Beispiel ein PDF.
- Auf eine externe URL, im Reiter „External URL“.
- Auf eine E-Mail-Adresse oder eine Telefonnummer.
Im Reiter „Page“ wählst du die Seite im Seitenbaum. Du kannst dort auch direkt ein Inhaltselement dieser Seite wählen. TYPO3 erzeugt dann einen Link mit Anker, also mit einem Rautezeichen und der Nummer des Elements. Der Browser springt beim Klick direkt zu diesem Element. Lena verlinkt so aus dem Ankündigungstext auf den Abschnitt „Anfahrt“ der Seite „Kontakt“.
- Im Link Browser den Reiter „External URL“ öffnen.
- Die Adresse ins Feld „URL“ eintragen.
- Unter „Target“ bei Bedarf „New window“ wählen.
- Mit „Set Link“ den Link setzen und das Fenster schließen.
Einen Link entfernst du so: Setz den Cursor irgendwo in den verlinkten Text. Es erscheint ein kleines Popover mit dem Knopf „Unlink“. Ein Klick entfernt den Link, der Text bleibt stehen.
Extensions und Plugins
Extensions erweitern eine TYPO3-Installation um Funktionen, etwa News, Veranstaltungskalender oder Formulare. Auch viele Kernfunktionen sind selbst System-Extensions, zum Beispiel Formulare, Weiterleitungen oder das Dashboard. Installiert, eingerichtet und aktualisiert werden Extensions vom Integrator oder Administrator, nicht von Redakteuren. Bei der Bibliothek kümmert sich Tom darum.
Viele Extensions bringen ein Plugin mit. Ein Plugin ist ein Inhaltselement, das Inhalte einer Extension im Frontend ausgibt. Du fügst es wie jedes andere Element ein. Plugins findest du im Assistenten im Reiter „Plugins“. Diesen Reiter gibt es nur, wenn eine installierte Extension dort ein Plugin anbietet und du die Rechte dafür hast. Fehlt er, liegt es an einem dieser beiden Gründe. Dann hilft der Integrator.
Nach dem Einfügen stellst du das Plugin im Reiter „Plugin“ des Elements ein. Beim Formular wählst du dort die Formulardefinition, beim Anmeldeformular zum Beispiel die User Storage Page, also den Ordner mit den Website-Benutzern.
Formulare selbst entstehen im Modul Content > Forms. Oft legen Integratoren sie dort vorab an, etwa ein Kontaktformular. Lena fügt dann im Reiter „Form elements“ das Element „Form“ ein und wählt im Reiter „Plugin“ die passende Formulardefinition aus.
Welche Einstellungen ein Plugin hat, steht im Handbuch der Extension, die es mitbringt. Viele Extensions dokumentieren sich auf docs.typo3.org.
Das Wichtigste in Kürze
- Neue Elemente legst du in Content > Layout mit „+ Create new content“ an. Der Assistent zeigt nur Typen, für die du Rechte hast.
- „Text & Media“ ist das meistgenutzte Element. File Links liegt unter Lists, Plain HTML, Divider und Insert records unter Special elements.
- Insert records verweist auf ein Original, eine Kopie ist ein eigenes Element. Kopien sind zunächst versteckt, bei gleicher Überschrift auf der Zielseite tragen sie „(copy 1)“ im Titel.
- Die Überschriftenebene folgt der Bedeutung. „Hidden“ blendet nur die Überschrift im Frontend aus.
- TYPO3 speichert nicht automatisch. Ein leeres Pflichtfeld oder ein unzulässiger Wert verhindern das Speichern. Ein Typwechsel löscht keine Inhalte.
- Bei gleichzeitiger Bearbeitung warnt TYPO3, und wer zuletzt speichert, gewinnt. Gelöschtes holst du über den Recycler oder „History/Undo“ zurück.
- Metadaten und Ausschnitt gelten je Verwendung, die Datei in Media bleibt unverändert. Mehrere Bilder stehen standardmäßig zu zweit nebeneinander.
- Videos kommen per „Add media file“ oder „Add media by URL“. Bei YouTube denkst du an Datenschutz und Einwilligung.
- Der RTE ist CKEditor 5. Seine Knöpfe hängen vom Preset ab.
- Strg + K setzt im Editor einen Link, „Unlink“ im Popover entfernt ihn. Der Link Browser kennt Seiten, Elemente, Dateien, Ordner, URLs, E-Mail und Telefon.
- Extensions installiert der Integrator. Plugins stellst du im Reiter „Plugin“ ein, Hilfe steht im Handbuch der Extension.
Begriffe
- Insert records
- Ein Element, das vorhandene Elemente anzeigt, ohne sie zu kopieren.
- Überschriftenebene
- Die Stufe einer Überschrift in der Gliederung der Seite, unabhängig vom Aussehen.
- Metadaten
- Angaben zu einer Datei wie Alternativtext und Beschreibung, die du je Element überschreiben kannst.
- Alternativtext
- Eine Textfassung, die das Bild ersetzt, wenn es nicht gesehen wird.
- Rich-Text-Editor
- Ein Editor für formatierten Text, in TYPO3 14 CKEditor 5.
- Preset
- Eine gespeicherte Konfiguration des Rich-Text-Editors, etwa minimal, default oder full.
- Link Browser
- Das Fenster, in dem du das Ziel eines Links wählst.
- Geschütztes Leerzeichen
- Ein Leerzeichen, an dem die Zeile nie umbricht.
- Weiches Trennzeichen
- Eine mögliche Trennstelle, die nur bei Bedarf einen Bindestrich zeigt.
- Plugin
- Ein Inhaltselement, das Inhalte einer Extension im Frontend ausgibt.