Seminar Enonic XP 8 – Admin Tools und Content Studio Erweiterungen

Das Seminar behandelt die Entwicklung eigener Verwaltungsoberflächen und redaktioneller Erweiterungen für Enonic XP 8. Im Mittelpunkt steht ein wartbares Erweiterungsmodell, das Benutzeroberfläche, serverseitige Logik, Berechtigungen und Datenzugriff klar trennt.

Ausgehend von einem lauffähigen EDK-Projekt entsteht schrittweise ein Admin Tool mit ergänzenden Content-Studio-Erweiterungen. Jede Funktion wird gegen reale Rollen, Fehlerfälle, Upgrade-Anforderungen und Deployment-Prozesse geprüft.

Inhaltsübersicht

1. Erweiterungsarchitektur und Anwendungsfälle
2. EDK-Projekt und Build-Struktur
3. Admin Tool und Navigation
4. Serverlogik mit Universal APIs
5. Oberflächen mit Web Components
6. Context Panels und redaktioneller Kontext
7. Custom Selectors und Datenquellen
8. Live View und Vorschauintegration
9. IAM, Rechte und Auditierbarkeit
10. Tests, Paketierung und Betrieb

Lernziele

• Erweiterungspunkte von Admin Tools und Content Studio technisch einordnen
• serverseitige TypeScript-Funktionen und Universal APIs sauber kapseln
• Web Components für isolierte und wiederverwendbare Oberflächen einsetzen
• Custom Selectors, Context Panels und Live-View-Erweiterungen entwickeln
• Berechtigungen, Tests, Paketierung und Upgrade-Fähigkeit absichern

Praxisorientierte Lernschritte

1. Erweiterungsarchitektur und Anwendungsfälle

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Admin Tools, sichtbare Menüeinträge und eingebettete Erweiterungen voneinander abgrenzen
2. Schritt 2: redaktionelle und administrative Use Cases als Rollen- und Datenfluss modellieren
3. Schritt 3: eine Zielarchitektur mit Frontend, Universal API und Plattformbibliotheken festlegen

2. EDK-Projekt und Build-Struktur

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: ein TypeScript-Projekt aus einem geeigneten Starter aufsetzen und lokal ausführen
2. Schritt 2: Ressourcen, Abhängigkeiten, Build-Artefakte und Anwendungskonfiguration strukturieren
3. Schritt 3: Entwicklungs-, Test- und Produktionsparameter nachvollziehbar trennen

3. Admin Tool und Navigation

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Tool-Descriptor, Titel, Symbolik und Menüplatzierung definieren
2. Schritt 2: eine belastbare Startansicht mit Zustands- und Fehlerbehandlung aufbauen
3. Schritt 3: Navigation, Deep Links und Benutzerkontext kontrolliert verarbeiten

4. Serverlogik mit Universal APIs

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: API-Manifest und Mounting für den administrativen Kontext entwerfen
2. Schritt 2: HTTP-Funktionen mit Eingabeprüfung, Statuscodes und Problemantworten implementieren
3. Schritt 3: Plattformbibliotheken für Content, Repositories und Identitäten sicher anbinden

5. Oberflächen mit Web Components

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Komponentenstruktur, Ereignisse, Eigenschaften und interne Zustände planen
2. Schritt 2: Oberflächen gegen fremde Styles und Skripte isolieren
3. Schritt 3: Ladezustände, Validierungsfehler und Berechtigungsgrenzen sichtbar machen

6. Context Panels und redaktioneller Kontext

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: einen Panel-Anwendungsfall aus Inhalt, Projekt und Benutzerrolle ableiten
2. Schritt 2: Kontextdaten serverseitig ermitteln und auf das erforderliche Minimum reduzieren
3. Schritt 3: Aktionen mit Rückmeldung, Fehlerpfad und Aktualisierung des Editors verbinden

7. Custom Selectors und Datenquellen

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Such-, Filter- und Paging-Anforderungen für Auswahldaten festlegen
2. Schritt 2: eine abgesicherte Datenquelle mit stabilen IDs und lesbaren Bezeichnungen implementieren
3. Schritt 3: leere Treffer, Berechtigungswechsel und große Datenmengen testen

8. Live View und Vorschauintegration

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Vorschauzustände und editorbezogene Parameter ermitteln
2. Schritt 2: eine Erweiterung für visuelle Rückmeldung oder fachliche Prüfungen integrieren
3. Schritt 3: Aktualisierung, Zeitüberschreitung und nicht verfügbare Frontends kontrolliert behandeln

9. IAM, Rechte und Auditierbarkeit

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: benötigte Rollen, Principals und Service Accounts minimal festlegen
2. Schritt 2: Zugriffe in API und Oberfläche unabhängig voneinander prüfen
3. Schritt 3: sicherheitsrelevante Aktionen mit nachvollziehbaren Auditdaten versehen

10. Tests, Paketierung und Betrieb

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Unit-, API- und Oberflächentests für Kernpfade und Fehlerfälle definieren
2. Schritt 2: Build, Versionskennzeichnung und Installation reproduzierbar automatisieren
3. Schritt 3: Upgrade-Checkliste, Monitoringpunkte und Rückfallverfahren dokumentieren

Zielgruppe und Vorkenntnisse

Zielgruppe: TypeScript- und Webentwickler, Enonic-Entwickler, technische Architekten sowie Teams, die Content Studio oder die XP-Administration projektspezifisch erweitern.

Vorkenntnisse: Sichere Kenntnisse in TypeScript, HTML, CSS und HTTP; Grundkenntnisse der Enonic-XP-App-Struktur, des EDK und der Content- beziehungsweise Node-Bibliotheken.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar durch Demonstrationen, strukturierte Konfigurations- oder Implementierungsschritte und kontrollierte Fehlerfälle vertieft. Jede Übung besitzt definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen. Dadurch bleiben die erarbeiteten Abläufe für Projekt- und Betriebsstandards nachvollziehbar.