Seminar TYPO3 v14: TypoScript Grundlagen und fortgeschrittene Konfiguration

Das Seminar vermittelt TypoScript als Konfigurationssprache für das Frontend-Rendering in TYPO3 v14. Die Inhalte reichen vom Objektbaum über Site-Set-basierte Dateistrukturen bis zu Menüs, Datenverarbeitung, Bedingungen und systematischer Fehlersuche.

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

Lernziele

• TypoScript-Syntax und Objektbaum sicher lesen und schreiben
• Konfiguration in Site Sets und Dateien modular organisieren
• PAGE, FLUIDTEMPLATE und Standardinhalte kontrolliert rendern
• Bedingungen, Menüs und Data Processors zielgerichtet einsetzen
• Konfiguration debuggen, absichern und leistungsfähig halten

Inhaltsübersicht

1. Syntax und Objektbaum
2. Dateistruktur und Site Sets
3. Seitenobjekt und Fluid-Rendering
4. Inhalte und Datensätze lesen
5. stdWrap und Datenfunktionen
6. Bedingungen und Varianten
7. Menüs und Data Processing
8. Debugging und Konfigurationsanalyse
9. Performance, Sicherheit und Wartbarkeit

Kapitel 1: Syntax und Objektbaum

Inhaltsübersicht des Kapitels

• Zuweisungen und Operatoren verstehen
• Konfiguration lesen und prüfen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Zuweisungen und Operatoren verstehen, Konfiguration lesen und prüfen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 1.1: Zuweisungen und Operatoren verstehen

Fachliche Ausarbeitung: Pfade, Werte, Kopieren, Referenzieren, Löschen und mehrzeilige Werte im Objektbaum unterschieden. Praktische Umsetzung: Eine kleine Konfiguration mit mehreren Operatoren nachvollziehbar aufgebaut. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 1.2: Konfiguration lesen und prüfen

Fachliche Ausarbeitung: Reihenfolge, Überschreibungen und resultierender Objektbaum systematisch verfolgt. Praktische Umsetzung: Eine fehlerhafte Konfiguration bis zur wirksamen Zeile zurückverfolgt. 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: Dateistruktur und Site Sets

Inhaltsübersicht des Kapitels

• TypoScript modular ablegen
• Site Set als Provider verwenden
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt TypoScript modular ablegen, Site Set als Provider verwenden. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 2.1: TypoScript modular ablegen

Fachliche Ausarbeitung: Setup, Konstanten, Imports und funktionale Teilbereiche in eine klare Dateistruktur überführt. Praktische Umsetzung: Eine verstreute Konfiguration in nachvollziehbare Module gegliedert. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 2.2: Site Set als Provider verwenden

Fachliche Ausarbeitung: Set-Abhängigkeiten, settings.definitions und TypoScript-Provider miteinander verbunden. Praktische Umsetzung: Eine Konfiguration über ein Site Set aktiviert und parametrisiert. 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: Seitenobjekt und Fluid-Rendering

Inhaltsübersicht des Kapitels

• PAGE-Objekt aufbauen
• FLUIDTEMPLATE anbinden
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt PAGE-Objekt aufbauen, FLUIDTEMPLATE anbinden. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 3.1: PAGE-Objekt aufbauen

Fachliche Ausarbeitung: Seitentyp, Metadaten, Header-Daten und Ausgabegrundlage im PAGE-Objekt definiert. Praktische Umsetzung: Eine minimale, vollständige Frontend-Ausgabe erstellt. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 3.2: FLUIDTEMPLATE anbinden

Fachliche Ausarbeitung: Template-, Layout- und Partial-Pfade sowie übergebene Variablen konfiguriert. Praktische Umsetzung: Ein Fluid-Seitenlayout mit klaren Datenübergaben gerendert. 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: Inhalte und Datensätze lesen

Inhaltsübersicht des Kapitels

• Content-Rendering einordnen
• Datensätze gezielt abfragen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Content-Rendering einordnen, Datensätze gezielt abfragen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 4.1: Content-Rendering einordnen

Fachliche Ausarbeitung: Zusammenspiel von tt_content, Fluid Styled Content und eigenem Rendering nachvollzogen. Praktische Umsetzung: Standardinhalte in definierte Seitenbereiche eingebunden. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 4.2: Datensätze gezielt abfragen

Fachliche Ausarbeitung: CONTENT, RECORDS und Query-Eigenschaften nach Einsatzzweck ausgewählt. Praktische Umsetzung: Eine gefilterte Datensatzliste mit Sortierung und Begrenzung ausgegeben. 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: stdWrap und Datenfunktionen

Inhaltsübersicht des Kapitels

• Werte verarbeiten
• Kontextdaten bewusst nutzen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Werte verarbeiten, Kontextdaten bewusst nutzen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 5.1: Werte verarbeiten

Fachliche Ausarbeitung: Feldzugriff, Fallbacks, Bedingungen, Formatierung und Verkettung mit stdWrap umgesetzt. Praktische Umsetzung: Mehrere Rohwerte zu einer kontrollierten Ausgabe kombiniert. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 5.2: Kontextdaten bewusst nutzen

Fachliche Ausarbeitung: Seitendaten, Register, Request-Kontext und Site-Einstellungen nach Verfügbarkeit eingesetzt. Praktische Umsetzung: Eine kontextabhängige Ausgabe ohne globale Nebenwirkungen erstellt. 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: Bedingungen und Varianten

Inhaltsübersicht des Kapitels

• Bedingungen klar formulieren
• Überschreibungen begrenzen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Bedingungen klar formulieren, Überschreibungen begrenzen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 6.1: Bedingungen klar formulieren

Fachliche Ausarbeitung: Site, Sprache, Seite, Umgebung und Request-Merkmale als Bedingungen verwendet. Praktische Umsetzung: Mehrere Varianten mit eindeutigem Gültigkeitsbereich umgesetzt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 6.2: Überschreibungen begrenzen

Fachliche Ausarbeitung: Verschachtelte Bedingungen, Rücksetzung und Reihenfolge auf Wartbarkeit geprüft. Praktische Umsetzung: Eine schwer verständliche Bedingungskette in getrennte Module überführt. 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: Menüs und Data Processing

Inhaltsübersicht des Kapitels

• Menüdaten erzeugen
• Daten für Fluid aufbereiten
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Menüdaten erzeugen, Daten für Fluid aufbereiten. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 7.1: Menüdaten erzeugen

Fachliche Ausarbeitung: MenuProcessor, Ebenen, aktive Zustände, Ausschlüsse und Sonderseiten konfiguriert. Praktische Umsetzung: Eine mehrstufige Navigation mit konsistenten Zuständen vorbereitet. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 7.2: Daten für Fluid aufbereiten

Fachliche Ausarbeitung: FilesProcessor, DatabaseQueryProcessor und weitere Prozessoren kombiniert. Praktische Umsetzung: Komplexe Rohdaten in eine klare Template-Struktur transformiert. 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: Debugging und Konfigurationsanalyse

Inhaltsübersicht des Kapitels

• Wirksame Konfiguration untersuchen
• Fehlerbilder unterscheiden
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Wirksame Konfiguration untersuchen, Fehlerbilder unterscheiden. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 8.1: Wirksame Konfiguration untersuchen

Fachliche Ausarbeitung: Template-Analyzer, Objektbrowser, Cache und Importreihenfolge in fester Reihenfolge geprüft. Praktische Umsetzung: Einen vorgegebenen Rendering-Fehler systematisch lokalisiert. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 8.2: Fehlerbilder unterscheiden

Fachliche Ausarbeitung: Syntaxfehler, leere Daten, falscher Kontext und überschreibende Konfiguration voneinander abgegrenzt. Praktische Umsetzung: Mehrere typische Fehlerfälle mit dokumentiertem Diagnoseweg behoben. 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 9: Performance, Sicherheit und Wartbarkeit

Inhaltsübersicht des Kapitels

• Unnötige Arbeit vermeiden
• Projektregeln festlegen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Unnötige Arbeit vermeiden, Projektregeln festlegen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 9.1: Unnötige Arbeit vermeiden

Fachliche Ausarbeitung: Wiederholte Abfragen, große Datenmengen, uncachbare Bereiche und komplexe Bedingungen bewertet. Praktische Umsetzung: Eine ineffiziente Konfiguration gemessen und vereinfacht. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 9.2: Projektregeln festlegen

Fachliche Ausarbeitung: Benennung, Dateigrenzen, Kommentare, Settings und verbotene Muster als Standard dokumentiert. Praktische Umsetzung: Eine wartbare TypoScript-Konvention für ein Team erstellt. 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.

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.