Seminar Sulu Admin-UI entwickeln und anpassen

Das Seminar vermittelt die strukturierte Entwicklung eigener Bereiche in der Sulu-Administration. Im Mittelpunkt stehen Ressourcen, Listen, Formulare, Navigation, Sicherheitskontexte und projektspezifische React-Erweiterungen.

Inhaltsverzeichnis

• Zielgruppe
• Voraussetzungen
• Lernziele
• Lernfelder
• Praxisprojekt Schritt für Schritt
• Qualitätskontrollen
• Empfohlene Anschlussseminare

Zielgruppe

PHP- und Symfony-Entwickelnde, Full-Stack-Entwickelnde sowie technische Verantwortliche für projektspezifische Sulu-Backends.

Voraussetzungen

Sichere PHP-Kenntnisse, Grundkenntnisse in Symfony, REST und JavaScript; React-Grundlagen sind hilfreich. Eine lauffähige Sulu-3.x-Entwicklungsumgebung wird vorausgesetzt.

Lernziele

• Erweiterungspunkte der Sulu-Administration sicher einordnen
• eigene Ressourcen mit Listen- und Formularansichten bereitstellen
• Navigation, Berechtigungen und Übersetzungen konsistent konfigurieren
• projektspezifische Feldtypen, Aktionen und Auswahlkomponenten umsetzen
• Admin-Frontend, APIs und Tests als zusammenhängende Funktion ausliefern

Lernfelder

Lerneinheit 1: Architektur der Admin-Anwendung

• Zusammenspiel von Symfony-Backend, Metadaten und React-Frontend
• Ressourcen, Views, Routen und Registry-Mechanismen
• Entwicklungswerkzeuge, Cache-Zustände und Build-Prozess

Lerneinheit 2: Domänenmodell und Ressourcenvertrag

• Abgrenzung zwischen Content, Konfiguration und eigener Doctrine-Entität
• Resource-Key, Identifier, Repository und Service-Schicht
• Datenvalidierung, Übersetzbarkeit und Lebenszyklusregeln

Lerneinheit 3: REST-Endpunkte und Serialisierung

• Listen-, Detail-, Erstellungs-, Änderungs- und Löschoperationen
• Request-Validierung, Fehlerantworten und Pagination
• Berechtigungsprüfung und stabile API-Verträge

Lerneinheit 4: Listenkonfiguration

• Spalten, Datentypen, Sortierung und Filter
• Toolbar-Aktionen, Massenoperationen und gespeicherte Ansichten
• Verknüpfung von Listenzeilen mit Detailansichten

Lerneinheit 5: Formularkonfiguration

• XML-Formulare, Tabs, Sections und Pflichtfelder
• Sichtbarkeitsbedingungen, Validierung und abhängige Felder
• Speicherlogik, Fehlermeldungen und Änderungszustände

Lerneinheit 6: Admin-Klasse und Navigation

• Registrierung von Views und Navigationspunkten
• Hierarchien, Icons, Routenparameter und Breadcrumbs
• Security-Kontexte und rollenabhängige Sichtbarkeit

Lerneinheit 7: Auswahl- und Referenzfelder

• Single- und Multi-Selection für eigene Ressourcen
• Autocomplete, Display-Properties und Suchparameter
• Referenzprüfung und Verhalten bei gelöschten Datensätzen

Lerneinheit 8: Eigene React-Komponenten

• Aufbau eines projektspezifischen Feldtyps
• Registrierung, Props, Zustandsmodell und Fehlerdarstellung
• Kompatibilität mit Formularmetadaten und Übersetzungen

Lerneinheit 9: Aktionen, Toolbar und Vorschau

• Benutzerdefinierte Aktionen mit Bestätigung und Rückmeldung
• Aktionsverfügbarkeit anhand Zustand und Berechtigung
• Anbindung von Preview- oder Sekundäransichten

Praxisprojekt Schritt für Schritt

Als durchgängige Übung entsteht einen administrierbaren Produktkatalog mit eigener Ressource, Listenansicht, Formular, Berechtigungen und Auswahlfeld.

1. Schritt 1: Ausgangslage, Rollen, Systemgrenzen und Abnahmekriterien für einen administrierbaren Produktkatalog mit eigener Ressource, Listenansicht, Formular, Berechtigungen und Auswahlfeld festhalten.
2. Schritt 2: Den Lernbereich „Architektur der Admin-Anwendung“ konfigurieren und mit einem Positivfall prüfen.
3. Schritt 3: Den Lernbereich „REST-Endpunkte und Serialisierung“ umsetzen und mit realistischen Testdaten verbinden.
4. Schritt 4: Den Lernbereich „Listenkonfiguration“ durch einen Negativfall und eine Korrektur absichern.
5. Schritt 5: Den Lernbereich „Admin-Klasse und Navigation“ analysieren und die benötigten Artefakte festlegen.
6. Schritt 6: Den Lernbereich „Auswahl- und Referenzfelder“ konfigurieren und mit einem Positivfall prüfen.
7. Schritt 7: Den Lernbereich „Aktionen, Toolbar und Vorschau“ umsetzen und mit realistischen Testdaten verbinden.
8. Schritt 8: Die Teilkonfigurationen zu einem durchgängigen Anwendungsszenario verbinden und Abhängigkeiten sichtbar dokumentieren.
9. Schritt 9: Berechtigungs-, Locale-, Publikations- und Fehlerfälle mit einer standardisierten Prüfliste ausführen.
10. Schritt 10: Den erreichten Stand als Konfigurationsübersicht, Betriebscheckliste und priorisierte nächste Ausbaustufe festhalten.

Qualitätskontrollen

• Fachliche Anforderungen, Systemgrenzen und Verantwortlichkeiten sind eindeutig dokumentiert.
• Konfigurationen und Implementierungen sind reproduzierbar, versionierbar, vollständig und eigenständig beschrieben.
• Positiv-, Negativ-, Berechtigungs-, Locale- und Fehlerfälle sind nachvollziehbar geprüft.
• Betriebs-, Sicherheits-, Performance- und Wartungsaspekte sind passend zum Thema berücksichtigt.
• Die nächsten Vertiefungsschritte sind nach Risiko und Nutzen priorisiert.

Empfohlene Anschlussseminare

• Sulu Entwicklung eigener Bundles und Erweiterungen
• Sulu API- und Headless-Integration
• Sulu Automatisierte Tests und Qualitätssicherung