Seminar Wagtail: Grundlagen für Entwickler

Das Seminar führt von der Projektanlage über Seitenmodelle, StreamField und Templates bis zu Suche, Tests und einem produktionsnahen Mini-Projekt.

Inhaltsübersicht

1. Projektsetup und Systemverständnis
2. Seitenmodelle und Seitenbaum
3. Editor-Panels und Validierung
4. Templates, Kontext und Navigation
5. StreamField und wiederverwendbare Blocks
6. Bilder, Dokumente, Snippets und Settings
7. Suche, Formulare und einfache Integrationen
8. Tests und produktionsnahes Mini-Projekt

Seminarprofil

Die Inhalte verbinden fachliche Einordnung, geführte Demonstrationen und eigenständige Übungen. Jeder Themenblock baut auf den vorherigen Arbeitsschritten auf; Konfigurationen und Implementierungen werden unmittelbar anhand definierter Qualitätskriterien überprüft. Drei Tage sind erforderlich, um die zentralen Konzepte mit ausreichender Übungszeit zu verbinden und ein durchgängiges Projekt mit Modellierung, Darstellung, Redaktion und Tests aufzubauen.

Zielgruppe und Voraussetzungen

Zielgruppe: Python- oder Django-Entwickler, die Wagtail strukturiert erlernen und eigenständig redaktionelle Websites entwickeln sollen.

Voraussetzungen: Sichere Python-Grundlagen, Basiswissen zu HTML und relationalen Datenbanken; erste Django-Erfahrung ist vorteilhaft, aber nicht zwingend.

Seminarinhalte

Kapitel 1: Projektsetup und Systemverständnis

Das Kapitel ordnet Projektsetup und Systemverständnis in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Virtuelle Umgebung, Abhängigkeiten und Projektstruktur; 2. Django- und Wagtail-Komponenten im Zusammenspiel; 3. Datenbank, Migrationen und Entwicklungsserver; 4. Admin-Zugang und erste Systemprüfung

1. Schritt 1: Virtuelle Umgebung, Abhängigkeiten und Projektstruktur fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Django- und Wagtail-Komponenten im Zusammenspiel in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Datenbank, Migrationen und Entwicklungsserver in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Admin-Zugang und erste Systemprüfung durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 2: Seitenmodelle und Seitenbaum

Das Kapitel ordnet Seitenmodelle und Seitenbaum in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Page-Vererbung und eigene Felder; 2. Erlaubte Eltern- und Unterseitentypen; 3. Migration, Erstellung und Veröffentlichung; 4. Abfrage von Seiten und spezifischen Modellen

1. Schritt 1: Page-Vererbung und eigene Felder fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Erlaubte Eltern- und Unterseitentypen in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Migration, Erstellung und Veröffentlichung in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Abfrage von Seiten und spezifischen Modellen durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 3: Editor-Panels und Validierung

Das Kapitel ordnet Editor-Panels und Validierung in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Content Panels und strukturierte Eingabemasken; 2. Hilfetexte, Pflichtfelder und Standardwerte; 3. Eigene Validierungsregeln; 4. Vorschau und redaktionelle Fehlerrückmeldung

1. Schritt 1: Content Panels und strukturierte Eingabemasken fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Hilfetexte, Pflichtfelder und Standardwerte in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Eigene Validierungsregeln in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Vorschau und redaktionelle Fehlerrückmeldung durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 4: Templates, Kontext und Navigation

Das Kapitel ordnet Templates, Kontext und Navigation in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Template-Vererbung und Blockstruktur; 2. get_context und kontextbezogene Daten; 3. Menüs, Breadcrumbs und aktive Zustände; 4. Fehlerseiten und robuste Fallbacks

1. Schritt 1: Template-Vererbung und Blockstruktur fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: get_context und kontextbezogene Daten in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Menüs, Breadcrumbs und aktive Zustände in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Fehlerseiten und robuste Fallbacks durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 5: StreamField und wiederverwendbare Blocks

Das Kapitel ordnet StreamField und wiederverwendbare Blocks in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. StructBlock, ListBlock und ChoiceBlock; 2. Verschachtelung und redaktionelle Leitplanken; 3. Block-Templates und Darstellung; 4. Migration und Weiterentwicklung von Blockstrukturen

1. Schritt 1: StructBlock, ListBlock und ChoiceBlock fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Verschachtelung und redaktionelle Leitplanken in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Block-Templates und Darstellung in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Migration und Weiterentwicklung von Blockstrukturen durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 6: Bilder, Dokumente, Snippets und Settings

Das Kapitel ordnet Bilder, Dokumente, Snippets und Settings in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. Bildauswahl und Renditions; 2. Dokumente und Downloads; 3. Wiederverwendbare Snippets; 4. Site-spezifische Einstellungen

1. Schritt 1: Bildauswahl und Renditions fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Dokumente und Downloads in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Wiederverwendbare Snippets in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Site-spezifische Einstellungen durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 7: Suche, Formulare und einfache Integrationen

Das Kapitel ordnet Suche, Formulare und einfache Integrationen in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. search_fields und grundlegende Suchabfragen; 2. Formularseiten und Einsendungen; 3. Eigene Dienste und externe Datenquellen; 4. Fehlerbehandlung und sichere Konfiguration

1. Schritt 1: search_fields und grundlegende Suchabfragen fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Formularseiten und Einsendungen in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Eigene Dienste und externe Datenquellen in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Fehlerbehandlung und sichere Konfiguration durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.

Kapitel 8: Tests und produktionsnahes Mini-Projekt

Das Kapitel ordnet Tests und produktionsnahes Mini-Projekt in den Gesamtzusammenhang ein und überführt die vier Teilthemen in einen nachvollziehbaren Arbeitsablauf.

Inhaltsverzeichnis des Kapitels: 1. PageTestCase und Modelltests; 2. Tests für Templates, Berechtigungen und Formulare; 3. Abschlussprojekt mit mehreren Seitentypen; 4. Code-Review, Qualitätscheck und Betriebsübergabe

1. Schritt 1: PageTestCase und Modelltests fachlich und technisch einordnen, Abhängigkeiten erfassen und eindeutige Akzeptanzkriterien festlegen.
2. Schritt 2: Tests für Templates, Berechtigungen und Formulare in einem nachvollziehbaren Projektaufbau implementieren und nach jedem Teilschritt funktional prüfen.
3. Schritt 3: Abschlussprojekt mit mehreren Seitentypen in den Gesamtprozess integrieren, typische Fehlerbilder gezielt auslösen und systematisch beheben.
4. Schritt 4: Code-Review, Qualitätscheck und Betriebsübergabe durch automatisierte Tests, Review-Regeln und wartbare Projektdokumentation stabilisieren.