CMS und API

Drupal-Implementierungsleitfaden.

Nutzen Sie Drupal-Revisionen, Content Moderation und Berechtigungen, um Erstellung, Fachprüfung und Veröffentlichung zu trennen.

Aufgabe und Entscheidung klären

Dieser Leitfaden macht Drupal-Implementierungsleitfaden zu einem prüfbaren Arbeitsablauf. Er verbindet fachliche Entscheidungen, Zuständigkeiten, Nachweise und Abnahme, damit das Ergebnis dauerhaft im Betrieb funktioniert.

Nutzen Sie Drupal-Revisionen, Content Moderation und Berechtigungen, um Erstellung, Fachprüfung und Veröffentlichung zu trennen.

Praktischer Ablauf

  1. 1

    Erfassen Sie Quelltypen, Kennungen, Felder, Sprachen, Verantwortliche und Veröffentlichungsstatus.

  2. 2

    Wählen Sie das Auslieferungsmuster nach Volumen, Latenz, redaktioneller Kontrolle und Fehlertoleranz.

  3. 3

    Ordnen Sie den Quelldatensatz einer getrennten Sprachversion mit stabiler Verknüpfung zu.

  4. 4

    Ergänzen Sie Authentifizierung, Idempotenz, Wiederholung, Cache-Invalidierung, Protokollierung und Zugriffssteuerung.

  5. 5

    Testen Sie Veröffentlichung, Quelländerung, fehlende Ergebnisse, Rollback, Tastaturbedienung und Monitoring vor dem Start.

Beispiel oder Werkzeug

Ein moderierter Inhaltstyp zeigt Felder, Rollen, Revisionen, Auslieferung und Rollback. Dokumentieren Sie im Werkzeug außerdem Ausgangslage, Verantwortlichkeit, Entscheidung, Nachweis, offenen Punkt und Freigabedatum. Verwenden Sie eine reale Seite oder einen realen Vorgang, damit das Team Abhängigkeiten, Ausnahmefälle und die spätere Pflege erkennt.

PrüfpunktEintragAbnahmekriterium
AusgangslageBeobachteter Ist-ZustandQuelle und Datum vorhanden
EntscheidungGewählte Option mit BegründungRisiko und Zielgruppe berücksichtigt
NachweisTest, Dokument oder MesswertPrüfbar und versionsbezogen
FreigabeName, Rolle und DatumAlle Pflichtkriterien erfüllt

Erstellen Sie ein Inhaltsmodell mit vollständiger Herkunft

Erstellen Sie einen Inhaltstyp für verständliche Sprache oder eine strukturierte Entität mit Verweis auf die maßgebliche Quelle. Erfassen Sie Quellrevisionskennung, Sprache, Sprachmodus, Ergebniskennung, Prüfstatus, Glossarversion, Risikostufe, Freigaben und nächsten Prüfauslöser. Nutzen Sie Paragraphs oder strukturierte Felder für Überschriften, Listen, Links, Hinweise, Downloads und Kontakte. Ein einziges unbeschränktes Rich-Text-Feld erschwert Feldprüfung, Wiederverwendung und sichere Darstellung.

Wählen Sie bewusst zwischen Drupals Übersetzungsbeziehung und einer getrennten verbundenen Entität. Die Standardübersetzung eignet sich, wenn Feldstruktur und Redaktionsablauf gleich bleiben. Eine getrennte Entität ist sicherer, wenn die verständliche Version Quellfelder verbindet, neu ordnet oder erklärt und eine eigene Moderation benötigt. In beiden Fällen bleibt die Quellrevision für die Transformation unveränderlich. Bei einer späteren Abweichung wird der Status veraltet sichtbar.

EntscheidungGeeignet wennErforderliche Kontrolle
InhaltsübersetzungStruktur und Ablauf bleiben gleichRevisionsübersetzung und Moderation sind geprüft
Verbundene EntitätStruktur, Verantwortung oder Prüfung unterscheidet sichAusdrücklicher Quellverweis und gegenseitige Navigation
Paragraph-ZuordnungQuelle enthält wiederverwendbare strukturierte BlöckeUnbekannter Bundle-Typ blockiert oder kennzeichnet die Erzeugung

Trennen Sie Erstellung, Fachprüfung und Veröffentlichung

Konfigurieren Sie Content-Moderation-Status wie angefordert, in Erzeugung, Entwurf, Fachprüfung, Sprachprüfung, freigegeben, veröffentlicht, veraltet und fehlgeschlagen. Definieren Sie Übergänge für eigene Rollen und sichern Sie diese mit Drupal-Berechtigungen und Access Handlern. Das API-Integrationskonto darf Entwürfe erstellen und aktualisieren, aber weder freigeben noch veröffentlichen. Eine Fachprüfung darf die eigene risikoreiche Erzeugung nur freigeben, wenn die dokumentierte Risikoregel dies erlaubt.

Aktivieren Sie Revisionen und stellen Sie sicher, dass Transformation, Kommentarlösung, Statusübergang und neue Quellanbindung jeweils eine Revision mit Person und Zeitpunkt erzeugen. Eine Prüfansicht zeigt Quelle und Entwurf, Unterschiede, Warnungen, Links und gerendertes Ergebnis. Ändert sich die Quelle, kennzeichnen Sie aktiven Entwurf und veröffentlichte Version und blockieren die Veröffentlichung, bis die Abweichung gelöst ist.

  1. 1

    Konfigurieren Sie Entitätsfelder, Validierung, Revisionen und Quellbeziehung.

  2. 2

    Erstellen Sie Moderationsstatus und rollenspezifische Übergänge.

  3. 3

    Erzeugen Sie den Entwurf über einen beschränkten Queue Worker.

  4. 4

    Prüfen Sie Fachlichkeit und Sprache an einer eindeutig benannten Revision.

  5. 5

    Veröffentlichen und indexieren Sie mit vollständigem Quell- und Freigabenachweis.

Erhalten Sie Cache-Fähigkeit und Barrierefreiheit

Vergeben Sie Cache-Tags für Quellentität, Quellrevisionsbeziehung, Sprachentität, verknüpfte Paragraphs und Medien, Glossarkonfiguration und Renderer. Nutzen Sie Cache-Kontexte für Sprache und berechtigte Zugriffsunterschiede, aber machen Sie öffentliche Seiten nicht vom persönlichen Erzeugungsstatus abhängig. Invalidieren Sie betroffene Seiten durch Entitätsänderung oder Warteschlangenabschluss und zeigen Sie während der Prüfung weiter die letzte freigegebene Revision.

Rendern Sie Sprachnavigation als gewöhnliche Links über Drupal-Routing und sprachabhängige URL-Erzeugung. Ergänzen Sie Quellrücklinks, Alternativmetadaten, Breadcrumbs und Sitemap-Einträge. Prüfen Sie Überschriftenstruktur, Linkzweck, Fokusreihenfolge, Statusmeldungen und Formularfehler in der endgültigen Gestaltung. Bereinigen Sie API-Ergebnisse über erlaubte strukturierte Felder und Drupals Rendering. Markieren Sie erzeugtes HTML nicht allein deshalb als sicher, weil es von einem vertrauenswürdigen Server stammt.

  • Cache-Tags umfassen Quelle, Sprachversion, Komponenten, Medien, Glossar und Renderer.

  • Warteschlangenverarbeitung kann weder veröffentlichen noch das letzte freigegebene Ergebnis vorzeitig entfernen.

  • Sprachrouten und Quelllinks funktionieren ohne JavaScript.

  • Textformate und Render Arrays verhindern unsicheres Markup.

  • Die Suche indexiert nur die freigegebene Revision und entfernt stillgelegte Routen.

Belegen Sie Berechtigungen, Revisionen und Wiederherstellung

Kernel- und Funktionstests prüfen Feldvalidierung, Zugriff, Moderationsübergänge, Revisionserstellung, Erkennung veralteter Quellen, Queue-Wiederholung, Cache-Invalidierung, Routenzugriff und Darstellung aller unterstützten Komponenten. Testen Sie Drupal Cron und externe Queue Runner einschließlich paralleler Worker und wiederholter Aufträge. Browsertests durchlaufen den vollständigen Redaktionsablauf mit jeder Rolle sowie die Frontend-Nutzung ausschließlich per Tastatur.

Veröffentlichen Sie mit Configuration Management, Update Hooks, Zugangsdatenwechsel, Queue-Übersichten, Fehlerwiederholung, sparsamer Protokollierung, Datenbanksicherung und Rücksetzungsanleitung. Importieren Sie die Konfiguration in eine produktionsnahe Umgebung und bestätigen Sie bestehende Bundles, Übersetzungen, Berechtigungen und Views. Die Abnahme umfasst Wiederherstellung einer früheren freigegebenen Revision, Cache- und Index-Neuaufbau sowie korrekte öffentliche Adressen und Prüfdatensätze.

Rollen, Nachweise und Freigabe

Trennen Sie Erstellung und Veröffentlichung. Eine erfolgreiche Antwort ist ein Entwurf, keine Freigabe. Speichern Sie Quellkennung und Version, Verarbeitungseinstellungen, Ergebniskennung, Prüfstatus, freigebende Person und Veröffentlichungszeit. Wenn sich die Quelle ändert, öffnen Sie die Sprachversion erneut zur Prüfung, statt freigegebene Inhalte still zu ersetzen.

Betrieb und Pflege

Nach der Veröffentlichung endet die Arbeit nicht. Verknüpfen Sie die Sprachversion oder Konfiguration mit ihrer Quelle, überwachen Sie Qualitäts- und Betriebskennzahlen und definieren Sie konkrete Prüfauslöser. Dazu gehören Quelländerungen, Rechtsänderungen, neue Zielgruppenanforderungen, wiederkehrende Supportfragen, technische Änderungen und Vorfälle. Ein klarer Eigentümer bewertet den Auslöser, öffnet bei Bedarf eine neue Revision und dokumentiert die erneute Freigabe.

Checkliste für die Freigabe

  • Die Integration verwendet stabile Quellkennungen.

  • Zugangsdaten liegen serverseitig und werden rotiert.

  • Zeitüberschreitung, Wiederholung und Ratenbegrenzung sind definiert.

  • Wiederholte Anfragen sind idempotent.

  • Erstellte Inhalte gelangen in einen Prüfstatus.

  • Quelländerungen invalidieren oder öffnen die Version erneut.

  • Die Sprachnavigation funktioniert mit Tastatur und assistiven Techniken.

  • Das Monitoring erfasst Fehler, Warteschlangen, Latenz und veraltete Inhalte.

Maßgebliche Quellen

  1. Simple8 API documentation
  2. Simple8 delivery patterns
  3. Web Content Accessibility Guidelines (WCAG) 2.2

Leitfaden praktisch einsetzen

Testen Sie Simple8 mit repräsentativen Inhalten und planen Sie mit der Checkliste einen kontrollierten Produktivprozess.

Eigenen Text testen