CMS und API

WordPress-Implementierungsleitfaden.

Wählen Sie Widget oder API bewusst, behalten Sie die Originalseite als kanonische Quelle und veröffentlichen Sie Sprachversionen über Revisionen.

Aufgabe und Entscheidung klären

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

Wählen Sie Widget oder API bewusst, behalten Sie die Originalseite als kanonische Quelle und veröffentlichen Sie Sprachversionen über Revisionen.

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 Gutenberg-Workflow ordnet Ausgangsseiten, Prüfstatus, Cache-Schlüssel und Sprachnavigation zu. 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

Wählen Sie Widget, Plugin oder serverseitige API-Auslieferung

Nutzen Sie ein Widget, wenn schnelle Einführung wichtig ist, Quellseiten bereits stabile Kennungen besitzen und eine clientseitige Abhängigkeit vertretbar ist. Ein WordPress-Plugin eignet sich, wenn die Redaktion Erzeugung und Prüfung vollständig in der Administration erledigen soll. Serverseitige API-Auslieferung ist sinnvoll, wenn Sprachversionen indexierbar, zwischenspeicherbar, in Feeds verfügbar und auch ohne JavaScript gerendert sein müssen. Große Angebote verbinden häufig einen Plugin-Workflow mit serverseitiger Auslieferung.

Dokumentieren Sie die Wahl anhand von Redaktionskontrolle, Leistung, Barrierefreiheit, Suche, Fehlerverhalten, Datenfluss und Pflegeverantwortung. Die ursprüngliche Seite bleibt die maßgebliche Quelle. Eine Sprachversion erhält einen eigenen Beitrag oder strukturierten Datensatz, eine stabile Adresse, Prüfstatus und Quellrevisionsbezug. Speichern Sie Alternativinhalte nicht ausschließlich in einem unversionierten Zusatzfeld oder Browsercache, da Prüfung, Wiederherstellung und Nachweis sonst unzuverlässig sind.

MusterGeeignet fürWichtigste Kontrolle
WidgetSchnelle Ergänzung einer kontrollierten WebsiteBarrierefreier Rückfall und Fehlerzustand
Plugin-WorkflowRedaktion arbeitet vollständig in WordPressRollen, Nonces, Fähigkeiten und Revisionen
Serverseitige APIIndexierbare, zwischengespeicherte, belastbare SeitenWarteschlange, Invalidierung und Betriebsprozesse

Modellieren Sie Quellbeziehungen und Redaktionsstatus

Erstellen Sie einen Beitragstyp für Sprachversionen oder nutzen Sie eine mehrsprachige Struktur mit ausdrücklicher Quellbeziehung. Speichern Sie Quellbeitrag, Quellrevision, Zielsprache, Sprachmodus, Ergebniskennung, Glossarversion, Prüfstatus, Freigaben, veröffentlichte Revision und Prüfauslöser. Erhalten Sie nach Möglichkeit die Blockstruktur, damit Überschriften, Listen, Links, Tabellen und Hinweise semantisch bleiben und nicht in einem einzigen HTML-Feld verschwinden.

Definieren Sie Status für angefordert, in Erzeugung, Entwurf, Fachprüfung, Sprachprüfung, freigegeben, veröffentlicht, veraltet und fehlgeschlagen. Ordnen Sie jeden Übergang einer WordPress-Berechtigung zu und nicht nur einer sichtbaren Schaltfläche. Ein Generator darf einen Entwurf erstellen, aber nicht freigeben. Vergleichen Sie bei einer Quelländerung die aktuelle mit der freigegebenen Quellrevision und setzen Sie die Sprachversion auf veraltet oder prüfpflichtig. Veröffentlichen Sie keine Neuberechnung unbemerkt.

  1. 1

    Registrieren Sie Sprachversionsdatensatz und Metadaten mit Bereinigung und REST-Berechtigungen.

  2. 2

    Ordnen Sie unterstützte Gutenberg-Blöcke zu und definieren Sie das Verhalten unbekannter Blöcke.

  3. 3

    Konfigurieren Sie Rollen und erlaubte Statusübergänge.

  4. 4

    Erzeugen Sie eine eigene Revision und zeigen Sie den Unterschied zur Quelle.

  5. 5

    Veröffentlichen Sie erst nach den für das Inhaltsrisiko erforderlichen Freigaben.

Speichern Sie sicher zwischen und bieten Sie dauerhafte Sprachnavigation

Bilden Sie Cache-Schlüssel aus Website, Quellbeitrag, Quellrevision, Sprache, Sprachmodus und Renderer-Version. Invalidieren Sie die zugehörige Sprachseite, wenn sich ihre freigegebene Revision, die Quelle, ein geteilter Block oder eine relevante Terminologieregel ändert. Läuft die Verarbeitung asynchron, liefern Sie während der Prüfung des neuen Entwurfs die letzte freigegebene Version aus. Ersetzen Sie geprüfte Inhalte bei einem Ausfall niemals durch einen leeren Zustand.

Setzen Sie Sprachlinks als gewöhnliche serverseitig gerenderte Verweise mit eindeutigen Namen wie ‘Einfache Sprache’ und ‘Leichte Sprache’ um. Ergänzen Sie Rückverweise zur Quellseite und korrekte Metadaten für Sprachalternativen. Erhalten Sie bei einem Wechsel innerhalb der Seite den Tastaturfokus. Eine fehlende Version erklärt die Nichtverfügbarkeit und verweist zur Quelle, statt die Auswahl zu verstecken oder unbemerkt zurückzuleiten.

  • Cache-Schlüssel enthalten Quell- und Renderer-Version.

  • Die letzte freigegebene Seite bleibt bei API- und Warteschlangenausfall verfügbar.

  • Sprachlinks funktionieren ohne JavaScript und nutzen freigegebene Terminologie.

  • Kanonische und alternative Metadaten bilden die tatsächliche Beziehung ab.

  • Änderungen an geteilten Blöcken und Glossar erzeugen betroffene Prüfaufgaben.

Testen Sie Veröffentlichung und Wiederherstellung vollständig

Nutzen Sie eine Testumgebung mit repräsentativen Gutenberg-Blöcken, Zusatzfeldern, eingebetteten Formularen, wiederverwendbaren Blöcken und geschützten Beiträgen. Testen Sie Erzeugung, Rollenprüfung, Kommentare, geplante Veröffentlichung, Vorschau, Cache-Invalidierung, Quelländerung, Veraltungsstatus, Löschung, Wiederherstellung und Rücksetzung. REST-Endpunkte müssen unberechtigte Lese- und Schreibzugriffe ablehnen, Hintergrundaufträge brauchen gültige Nonces oder Serverzugangsdaten.

Definieren Sie vor dem Produktivgang Warteschlangenmonitoring, Fehlerverantwortung, Zugangsdatenwechsel, Plugin-Aktualisierungstests, Datenbanksicherung und ein sicheres Deaktivierungsverfahren. Die Abnahme verlangt korrektes Rendering auf üblichen Bildschirmgrößen, Tastatur- und Screenreader-Navigation, keine Layoutverschiebung durch späte Inhalte, gültige Überschriftenstruktur, nachvollziehbare Freigabe und Wiederherstellung der letzten freigegebenen Revision. Dokumentieren Sie unterstützte WordPress-, PHP-, Editor-, Mehrsprachigkeits- und Cache-Konfigurationen.

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