Seminar TYPO3 v14: Eigene Content-Elemente mit TCA und Fluid

Das Seminar behandelt die Entwicklung eigener Content-Elemente in TYPO3 v14 ohne unkontrollierte Speziallösungen. Von der fachlichen Felddefinition über die Backend-Bedienung bis zum barrierearmen Frontend-Rendering entsteht ein vollständig paketierter Baustein.

Die Inhalte sind auf einzelseminar mit hohem Praxisanteil ausgelegt. Theorie, Demonstration, geführte Konfiguration und kontrollierte Übungen greifen unmittelbar ineinander.

Lernziele

• Content-Elemente fachlich und technisch belastbar modellieren
• TCA-Felder, Paletten und Sichtbarkeitsregeln wartbar konfigurieren
• Assistent und Backend-Vorschau redaktionsgerecht gestalten
• Daten mit TypoScript und Data Processors aufbereiten
• Rendering, Mehrsprachigkeit, Workspaces und Migration testen

Inhaltsübersicht

1. Fachliches Modell und Datenfelder
2. TCA-Grundkonfiguration
3. Registrierung und Assistent
4. Backend-Vorschau und Bedienbarkeit
5. Datenverarbeitung mit TypoScript
6. Fluid-Ausgabe und Varianten
7. Lokalisierung, Workspaces und Rechte
8. Tests, Schemaänderungen und Übergabe

Kapitel 1: Fachliches Modell und Datenfelder

Inhaltsübersicht des Kapitels

• Inhaltsanforderungen zerlegen
• Datenhaltung bewusst auswählen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Inhaltsanforderungen zerlegen, Datenhaltung bewusst auswählen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 1.1: Inhaltsanforderungen zerlegen

Fachliche Ausarbeitung: Redaktionelle Aussage, Pflichtfelder, Varianten und Ausgabekontexte vor der technischen Umsetzung beschrieben. Praktische Umsetzung: Ein Feld- und Variantenmodell für einen konkreten Inhaltsbaustein erstellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 1.2: Datenhaltung bewusst auswählen

Fachliche Ausarbeitung: Standardfelder, zusätzliche tt_content-Felder und relationale Datensätze nach Wartbarkeit bewertet. Praktische Umsetzung: Für jedes Feld eine begründete Speicher- und Übersetzungsstrategie festgelegt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 2: TCA-Grundkonfiguration

Inhaltsübersicht des Kapitels

• Felder sicher definieren
• Formular logisch strukturieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Felder sicher definieren, Formular logisch strukturieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 2.1: Felder sicher definieren

Fachliche Ausarbeitung: Datentypen, Validierung, Standardwerte, Labels und erlaubte Werte im TCA konfiguriert. Praktische Umsetzung: Mehrere Feldtypen mit konsistenten Bezeichnern und sinnvollen Einschränkungen angelegt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 2.2: Formular logisch strukturieren

Fachliche Ausarbeitung: Paletten, Tabs, Abhängigkeiten und displayCond für eine übersichtliche Redaktion eingesetzt. Praktische Umsetzung: Ein kompaktes Bearbeitungsformular ohne überflüssige Felder aufgebaut. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 3: Registrierung und Assistent

Inhaltsübersicht des Kapitels

• Content-Typ registrieren
• Assistent redaktionsgerecht konfigurieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Content-Typ registrieren, Assistent redaktionsgerecht konfigurieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 3.1: Content-Typ registrieren

Fachliche Ausarbeitung: CType, Icon, Sprachlabel und Gruppierung im System eindeutig eingebunden. Praktische Umsetzung: Den neuen Typ in allen erforderlichen Konfigurationen konsistent registriert. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 3.2: Assistent redaktionsgerecht konfigurieren

Fachliche Ausarbeitung: Titel, Beschreibung, Gruppe und Standardwerte des Content-Element-Assistenten festgelegt. Praktische Umsetzung: Einen verständlichen Eintrag mit kontrollierter Vorauswahl erstellt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 4: Backend-Vorschau und Bedienbarkeit

Inhaltsübersicht des Kapitels

• Vorschau fachlich gestalten
• Fehlbedienung reduzieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Vorschau fachlich gestalten, Fehlbedienung reduzieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 4.1: Vorschau fachlich gestalten

Fachliche Ausarbeitung: Relevante Felder, Statusinformationen und Varianten kompakt im Seitenmodul dargestellt. Praktische Umsetzung: Eine Backend-Vorschau mit klarer Erkennbarkeit des Inhaltszustands umgesetzt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 4.2: Fehlbedienung reduzieren

Fachliche Ausarbeitung: Pflichtangaben, Hilfetexte, erlaubte Werte und sinnvolle Defaults auf typische Redaktionsfehler abgestimmt. Praktische Umsetzung: Mehrere Fehlerszenarien mit einem Redaktionskonto geprüft und korrigiert. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 5: Datenverarbeitung mit TypoScript

Inhaltsübersicht des Kapitels

• Rendering-Konfiguration modularisieren
• Daten gezielt aufbereiten
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Rendering-Konfiguration modularisieren, Daten gezielt aufbereiten. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 5.1: Rendering-Konfiguration modularisieren

Fachliche Ausarbeitung: CType-Auswahl, FLUIDTEMPLATE und dateibasierte Konfiguration in das Sitepackage eingeordnet. Praktische Umsetzung: Eine getrennte und importierbare Rendering-Konfiguration erstellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 5.2: Daten gezielt aufbereiten

Fachliche Ausarbeitung: ContentObjectDataProcessor, FilesProcessor, DatabaseQueryProcessor und eigene Prozessoren nach Bedarf verglichen. Praktische Umsetzung: Rohdaten in eine für Fluid klare und dokumentierte Datenstruktur überführt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 6: Fluid-Ausgabe und Varianten

Inhaltsübersicht des Kapitels

• Template semantisch aufbauen
• Darstellungsvarianten kontrollieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Template semantisch aufbauen, Darstellungsvarianten kontrollieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 6.1: Template semantisch aufbauen

Fachliche Ausarbeitung: Layouts, Partials, Escaping und nachvollziehbare Variablennamen für das Content-Element eingesetzt. Praktische Umsetzung: Ein semantisches Frontend-Template mit wiederverwendbaren Partials erstellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 6.2: Darstellungsvarianten kontrollieren

Fachliche Ausarbeitung: Layout-Varianten, optionale Felder, leere Zustände und responsive Medienausgabe behandelt. Praktische Umsetzung: Mehrere Varianten ohne duplizierte Geschäftslogik gerendert. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 7: Lokalisierung, Workspaces und Rechte

Inhaltsübersicht des Kapitels

• Übersetzungsverhalten prüfen
• Versionierung und Berechtigungen absichern
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Übersetzungsverhalten prüfen, Versionierung und Berechtigungen absichern. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 7.1: Übersetzungsverhalten prüfen

Fachliche Ausarbeitung: Feldverhalten, Sprachkopplung und redaktionelle Übersetzung für alle eigenen Felder bewertet. Praktische Umsetzung: Das Element in zwei Sprachen angelegt, geändert und synchronisiert. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 7.2: Versionierung und Berechtigungen absichern

Fachliche Ausarbeitung: Workspace-Verhalten, erlaubte Felder und Gruppenrechte für den neuen CType geprüft. Praktische Umsetzung: Freigabe, Vorschau und Veröffentlichung mit mehreren Rollen getestet. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 8: Tests, Schemaänderungen und Übergabe

Inhaltsübersicht des Kapitels

• Rendering und Datenmodell testen
• Migration und Dokumentation vorbereiten
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Rendering und Datenmodell testen, Migration und Dokumentation vorbereiten. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 8.1: Rendering und Datenmodell testen

Fachliche Ausarbeitung: TCA, Datenverarbeitung, Ausgabe, leere Werte und fehlerhafte Eingaben mit geeigneten Tests abgedeckt. Praktische Umsetzung: Eine reproduzierbare Testreihe für Backend und Frontend erstellt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 8.2: Migration und Dokumentation vorbereiten

Fachliche Ausarbeitung: Datenbankschema, Upgrade-Pfade, Versionsgrenzen und Redaktionshinweise dokumentiert. Praktische Umsetzung: Das Content-Element als releasefähigen Sitepackage-Baustein übergeben. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Didaktischer Aufbau

Jeder Themenblock beginnt mit einer Einordnung, wird am System demonstriert und anschließend praktisch umgesetzt. Übungen bauen aufeinander auf, sodass am Ende eine zusammenhängende, prüfbare TYPO3-Konfiguration oder ein vollständiger redaktioneller Arbeitsablauf vorliegt.