Revisionen

Überblick

Seitenrevisionen sind seitenbezogene redaktionelle Sicherheits-Snapshots.

Sie sind dafür ausgelegt, Inhalt und Struktur einer einzelnen Seite wiederherzustellen, ohne diese Aufgabe als vollständiges Backup oder als Site-Transfer zu behandeln.

Shared-Slot-Revisionen sind separate, sitebezogene redaktionelle Sicherheits-Snapshots für wiederverwendbare Shared-Slot-Inhalte.

Beide Revisionstypen können neben dem Snapshot selbst auch kompakte Audit-Metadaten mitführen:

  • Referenz auf den handelnden Benutzer, wenn ein realer Admin-Benutzer bekannt ist
  • source wie admin, console, project_import, system oder restore
  • event wie page_created, page_updated, workflow_changed, block_created, block_updated, block_deleted, block_reordered, slot_changed oder revision_restored

Ältere Revisionen besitzen diese Metadaten möglicherweise nicht. Die Admin-Oberfläche zeigt solche Zeilen als Not recorded an, statt zu raten.

Was erfasst wird

Revisions-Snapshots umfassen:

  • Kernfelder der Seite
  • Seitenübersetzungen
  • Seiten-Slots
  • Blockbaum der Seite
  • Blockübersetzungszeilen
  • Medien-ID-Referenzen

Bei Seitenübersetzungen enthält der Snapshot sprachabhängige (Locale) SEO-Override-Felder als Teil des redaktionellen Übersetzungszustands. Beim Wiederherstellen einer Seitenrevision werden diese Seiten-SEO-Werte zusammen mit lokalisierten Namens-, Slug- und Pfaddaten wiederhergestellt.

Automatische Erfassungspunkte

Revisionen werden automatisch erstellt, wenn sich diese Bereiche ändern:

  • Seitenfelder und Standardübersetzung
  • Workflow-Status
  • Seitenübersetzungsdatensätze
  • Slot-Struktur
  • Erstellen, Aktualisieren, Löschen und Sortieren von Blöcken

Wenn möglich, hält der Revisionseintrag auch fest, wer die Änderung ausgelöst hat und welche Art von Workflow sie erzeugt hat.

Wiederherstellungsverhalten

Die Wiederherstellung erfolgt direkt (in place) auf der aktuellen Seite.

Wenn eine Revision wiederhergestellt wird:

  1. wird zuerst eine frische Sicherheitsrevision vor der Wiederherstellung erstellt
  2. wird der ausgewählte Revisions-Snapshot auf die aktuelle Seite angewendet
  3. wird ein neuer Revisionseintrag nach der Wiederherstellung aufgezeichnet und mit der Quellrevision verknüpft

So bleiben sowohl der vorherige Live-Zustand als auch der wiederhergestellte Zustand in der Revisionshistorie erhalten.

Shared-Slot-Revisionen

Shared-Slot-Revisionen sind bewusst von Seitenrevisionen getrennt.

  • Sie sind sitebezogen und an einen Shared Slot gebunden.
  • Sie erfassen Shared-Slot-Metadaten sowie den wiederverwendbaren Shared-Slot-Blockbaum, einschließlich verschachtelter Struktur, Übersetzungszeilen und Medienreferenzen.
  • Sie erfassen keine unabhängigen redaktionellen Seiten, die auf den Shared Slot verweisen.
  • Sie speichern keine Seiten-Slot-Zuweisungen als Teil des Shared-Slot-Revisions-Snapshots.
  • Sie tragen dasselbe kompakte Muster aus Akteur-, Quellen- und Ereignis-Metadaten wie Seitenrevisionen, sofern der Aufrufer es bereitstellen kann.

Wiederherstellungsverhalten für Shared Slots

Die Wiederherstellung erfolgt direkt (in place) auf dem aktuellen Shared Slot.

Wenn eine Shared-Slot-Revision wiederhergestellt wird:

  1. wird zuerst eine frische Sicherheitsrevision vor der Wiederherstellung erstellt
  2. wird der ausgewählte Shared-Slot-Snapshot auf den aktuellen Shared Slot angewendet
  3. wird ein neuer Revisionseintrag nach der Wiederherstellung aufgezeichnet und mit der Quellrevision verknüpft
  4. bleibt die Shared-Slot-id gleich, und bestehende page_slots.shared_slot_id-Referenzen bleiben intakt

Da Shared Slots wiederverwendbare Referenzen sind, kann die Wiederherstellung eines Shared Slots jede Seite betreffen, die diesen Shared Slot derzeit verwendet.

Zugriffsregeln

  • super_admin: kann Revisionen ansehen und wiederherstellen
  • site_admin: kann Revisionen innerhalb zugewiesener Sites ansehen und wiederherstellen
  • editor: kann Revisionen innerhalb zugewiesener Sites ansehen, aber nicht wiederherstellen

Dasselbe Zugriffsmuster gilt für Shared-Slot-Revisionen.

Revisionen im Vergleich zu anderen Wiederherstellungswerkzeugen

Revisionen

  • seitenbezogene redaktionelle Wiederherstellung
  • fokussiert auf Inhalt und Struktur einer einzelnen Seite
  • Shared-Slot-Revisionen sind separat und fokussieren sich auf Metadaten und Blockbaum eines einzelnen wiederverwendbaren Shared Slots

Backup / Wiederherstellung

  • Wiederherstellung auf Umgebungsebene
  • stellt die aktuelle Datenbank und die Uploads aus einem Backup-Archiv wieder her

Export / Import

  • Site-Portabilität zwischen Installationen
  • wird verwendet, um die Inhalte einer Site als Paket zu übertragen

Diese Werkzeuge sind bewusst getrennt und sollten nicht als Ersatz füreinander behandelt werden.