Seminar CrafterCMS – Templated Sites mit FreeMarker und Groovy

Dieses praxisorientierte Seminar verbindet fachliche Einordnung, nachvollziehbare Konfigurationsschritte und kontrollierte Übungen an einer durchgängigen CrafterCMS-Laborumgebung. Eine serverseitig gerenderte, redaktionell bearbeitbare und produktionsnahe Site wird mit klarer Trennung von Modell, Controller und Darstellung entwickelt.

Inhaltsverzeichnis

1. Zielsetzung
2. 1. Projektstruktur und Rendering-Fluss
3. 2. FreeMarker-Grundlagen und sichere Ausgabe
4. 3. Komponenten, Navigation und Medien
5. 4. Groovy Controller und Services
6. 5. Experience Builder, Formulare und Suche
7. 6. Performance, Sicherheit und Deployment
8. Praxisprojekt und Qualitätssicherung
9. Zielgruppe und Voraussetzungen
10. Didaktik und Arbeitsweise

Zielsetzung

Eine serverseitig gerenderte, redaktionell bearbeitbare und produktionsnahe Site wird mit klarer Trennung von Modell, Controller und Darstellung entwickelt. Die einzelnen Arbeitsschritte werden jeweils mit einem definierten Ausgangszustand, einem erwarteten Prüfergebnis und einer dokumentierten Korrekturmöglichkeit durchgeführt.

Seminarinhalte

1. Projektstruktur und Rendering-Fluss

Content-Modell, Controller, Templates, Assets und Laufzeit werden in einer klaren Projektarchitektur angeordnet. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Seitentypen und Template-Verantwortung zuordnen. Prüfpunkt: Jede Seite besitzt einen eindeutigen Renderer.
2. Schritt 2: Layouts, Komponenten und gemeinsame Makros strukturieren. Prüfpunkt: Wiederverwendung ist vorbereitet.
3. Schritt 3: Datenfluss von Crafter Engine zum Template nachvollziehen. Prüfpunkt: Verfügbare Modelle sind bekannt.
4. Schritt 4: Fehlerseiten und Fallback-Template definieren. Prüfpunkt: Unbekannte Inhalte führen nicht zum unkontrollierten Abbruch.
5. Schritt 5: Projektkonventionen dokumentieren. Prüfpunkt: Team kann konsistent entwickeln.

2. FreeMarker-Grundlagen und sichere Ausgabe

Variablen, Bedingungen, Schleifen, Funktionen und Escape-Regeln werden an echten Content-Daten eingesetzt. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Content-Modell im Template auslesen. Prüfpunkt: Felder werden korrekt dargestellt.
2. Schritt 2: Bedingte und wiederholte Bereiche implementieren. Prüfpunkt: Optionale und listenartige Inhalte funktionieren.
3. Schritt 3: Makros für wiederkehrende Darstellung erstellen. Prüfpunkt: Duplizierter Template-Code wird reduziert.
4. Schritt 4: HTML-Escaping und kontrollierte Rich-Text-Ausgabe prüfen. Prüfpunkt: Ausgabe ist gegen unerwartete Eingaben abgesichert.
5. Schritt 5: Template-Fehler provozieren und diagnostizieren. Prüfpunkt: Fehlerweg ist bekannt.

3. Komponenten, Navigation und Medien

Wiederverwendbare Inhaltsbausteine werden mit Hierarchie, Navigation und performanten Assets verbunden. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Komponenten-Template für Text, Medien und Teaser erstellen. Prüfpunkt: Strukturierte Inhalte sind wiederverwendbar.
2. Schritt 2: Container und verschachtelte Komponenten rendern. Prüfpunkt: Komposition entspricht dem Modell.
3. Schritt 3: Navigation aus Site-Struktur ableiten. Prüfpunkt: Aktiver Pfad und Hierarchie stimmen.
4. Schritt 4: Responsive Medienvarianten einbinden. Prüfpunkt: Bilder werden passend ausgeliefert.
5. Schritt 5: Fehlende Referenz kontrolliert behandeln. Prüfpunkt: Seite bleibt stabil.

4. Groovy Controller und Services

Datenaufbereitung und Integrationslogik werden aus Templates in testbare Controller und Services verlagert. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Controller für einen Seitentyp anlegen. Prüfpunkt: Template erhält ein vorbereitetes Modell.
2. Schritt 2: Content, Suche oder externen Service anbinden. Prüfpunkt: Daten werden serverseitig zusammengeführt.
3. Schritt 3: Eingaben validieren und Fehler in sichere Zustände überführen. Prüfpunkt: Ungültige Anfragen werden kontrolliert behandelt.
4. Schritt 4: Caching und wiederverwendbaren Service einsetzen. Prüfpunkt: Logik ist performant und wartbar.
5. Schritt 5: Controller mit Unit- und Integrationstest absichern. Prüfpunkt: Verhalten ist reproduzierbar.

5. Experience Builder, Formulare und Suche

Redaktionelle In-Context-Bearbeitung und dynamische Funktionen werden in die templated Site integriert. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Template mit Bearbeitungsmetadaten instrumentieren. Prüfpunkt: Redaktion kann Felder im Kontext auswählen.
2. Schritt 2: Container für zulässige Komponenten konfigurieren. Prüfpunkt: Visuelle Komposition folgt dem Modell.
3. Schritt 3: Formular mit Validierung und serverseitiger Verarbeitung umsetzen. Prüfpunkt: Eingaben werden sicher verarbeitet.
4. Schritt 4: Suchabfrage und Ergebnisliste integrieren. Prüfpunkt: Inhalte sind auffindbar.
5. Schritt 5: Preview- und Live-Verhalten vergleichen. Prüfpunkt: Entwurf und Veröffentlichung sind getrennt.

6. Performance, Sicherheit und Deployment

Rendering wird gemessen, gehärtet, automatisiert getestet und kontrolliert ausgeliefert. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Ladezeit und teure Template- oder Serviceaufrufe messen. Prüfpunkt: Engpässe sind sichtbar.
2. Schritt 2: Caching und Datenzugriff gezielt optimieren. Prüfpunkt: Verbesserung ist quantifiziert.
3. Schritt 3: Eingabe-, Ausgabe- und Berechtigungstests durchführen. Prüfpunkt: Sicherheitsgrundlagen sind verifiziert.
4. Schritt 4: Build- und Deployment-Paket erzeugen. Prüfpunkt: Auslieferung ist reproduzierbar.
5. Schritt 5: Smoke-Test und Rollback in Zielumgebung ausführen. Prüfpunkt: Release ist kontrolliert.

Praxisprojekt und Qualitätssicherung

Eine templated Site mit Layouts, Komponenten, Navigation, Suche, Formularverarbeitung, Experience-Builder-Unterstützung und automatisierten Tests wird erstellt und bereitgestellt. Die Übung wird mit einer Abnahmeliste abgeschlossen, die Funktionsprüfung, Fehlerfall, Dokumentation und reproduzierbaren Wiederanlauf umfasst.

Zielgruppe und Voraussetzungen

Zielgruppe: Web- und JVM-Entwicklung, Full-Stack-Entwicklung, Content Engineering und Lösungsarchitektur.

Voraussetzungen: Kenntnisse in HTML, CSS, JavaScript, Template-Systemen und grundlegender Programmierung; CrafterCMS Content-Modellierungskenntnisse.

Didaktik und Arbeitsweise

Kurze Fachimpulse wechseln mit Demonstrationen, geführten Konfigurationsschritten, eigenständigen Übungen, negativen Testfällen und strukturierten Auswertungen. Ergebnisse werden in Checklisten, Mappingtabellen, Testfällen oder Runbooks festgehalten, damit die erarbeiteten Verfahren im Projekt- und Betriebsalltag wiederholbar bleiben.