Zum Inhalt

Installation – Admin-Aktivitätsprotokoll

Voraussetzungen

Anforderung Wert
Shopware-Version 6.6.x oder 6.7.x
Hosting Self-Hosted oder Shopware Cloud
Datenbank MariaDB 10.4+ oder MySQL 8.0+
Symfony-Scheduler / Messenger-Worker aktiv (für automatische Aufbewahrungs-Bereinigung)

Variante A — Shopware Store

  1. Admin → Erweiterungen → Store öffnen
  2. Nach „Admin-Aktivitätsprotokoll" oder „KommoraAdminActivityLog" suchen
  3. Hinzufügen klicken
  4. Aktivieren klicken

→ Detail: Installation via Store

Variante B — ZIP-Upload

  1. ZIP von Kommora beziehen oder aus dem Store-Account herunterladen
  2. Admin → Erweiterungen → Meine Erweiterungen → ⊕ Erweiterung hochladen
  3. ZIP-Datei auswählen, Upload
  4. Aktivieren klicken

→ Detail: Installation via ZIP

Nach der Aktivierung

  1. Migration läuft automatisch — Tabelle kommora_activity_log wird angelegt
  2. Erfassung startet sofort — ab diesem Zeitpunkt werden alle Admin-Schreib-Operationen, Login-Versuche und Plugin-Lifecycle-Events protokolliert
  3. Cache leeren: bin/console cache:clear
  4. Standard-Konfiguration prüfen: Plugin-Konfig öffnen — Aufbewahrungsdauer (Default 365 Tage), IP-/User-Agent-Erfassung (Default aus). Details siehe Konfiguration
  5. DSGVO-Verzeichnis aktualisieren — siehe DSGVO-Hinweise
Wichtig: vor Aktivierung Datenschutz-Aspekte klären

Auch wenn das Plugin DSGVO-konform per Default konfiguriert ist (keine IP, kein User-Agent, sensitive Felder maskiert), erhebst du mit der Aktivierung personenbezogene Daten der Admin-User. Du solltest:

  • die Aktivierung im Verarbeitungsverzeichnis dokumentieren (Art. 30 DSGVO)
  • betroffene Admin-User über die Protokollierung informieren (Art. 13 DSGVO — z. B. via Onboarding-Dokument)
  • bei Bedarf den Betriebsrat einbeziehen (BDSG § 87 Abs. 1 Nr. 6)
  • die Aufbewahrungsfrist angemessen wählen — 365 Tage ist Default, je nach Branche / Audit-Anforderung anpassen

Scheduled-Task-Aktivierung prüfen

Die automatische Aufbewahrungs-Bereinigung läuft als Scheduled Task:

bin/console scheduled-task:list
# kommora_activity_log.purge muss als „registered" gelistet sein

Wenn kein Messenger-Worker aktiv ist, wird der Task nicht ausgeführt — Bereinigung passiert dann nicht automatisch. Workaround: regelmäßiger Cron-Aufruf via:

*/15 * * * * bin/console scheduled-task:run --time-limit=60

ACL-Berechtigung setzen

Damit Admin-User das Modul sehen können, brauchen sie die neue Permission kommora_activity_log:read:

  1. Admin → Einstellungen → System → Benutzer & Rechte → Rollen
  2. Die gewünschte Rolle öffnen
  3. Unter „Andere" den Permission-Eintrag „Aktivitätsprotokoll lesen" aktivieren
  4. Speichern

Ohne diese Permission erscheint das Modul nicht im linken Admin-Menü.

Update

Bei einem Update werden Migrations automatisch ausgeführt. Cache wird automatisch geleert. Theme-Rebuild ist nicht erforderlich (kein Storefront-Touch).

→ Detail: Plugin-Updates

Deinstallation

  1. Admin → Erweiterungen → Meine Erweiterungen → Admin-Aktivitätsprotokoll → Deinstallieren
  2. Beim Dialog „Daten beim Deinstallieren behalten?":
    • Nein → Tabelle kommora_activity_log wird vollständig gelöscht, alle Log-Einträge verloren. System-Config + Scheduled-Task-Definition werden ebenfalls entfernt.
    • Ja → Tabelle bleibt erhalten, kann bei Re-Installation wieder genutzt werden.
DSGVO-Hinweis bei Deinstallation

Wenn du das Plugin deinstallierst und die Daten nicht behältst, werden alle Log-Einträge unwiederbringlich gelöscht. Wenn du sie für Audit-Zwecke aufbewahren musst, vor der Deinstallation einen Export machen.

Weiter