Admin Aktivitätsprotokoll

Über die Erweiterung

Sobald mehrere Personen Zugriff auf Ihre Shopware-Administration haben, stellt sich unweigerlich die Frage: Wer hat was wann geändert? Ohne ein lückenloses Protokoll bleiben Fehler ungeklärt, Verantwortlichkeiten unklar und Compliance-Anforderungen unerfüllt. Das Admin Aktivitätsprotokoll schließt diese Lücke – automatisch, ohne Konfigurationsaufwand und DSGVO-konform.

Ihre Vorteile auf einen Blick

• Vollständiger Audit-Trail – alle Änderungen in der Administration lückenlos dokumentiert
• Vor-/Nachher-Werte für jedes geänderte Feld – sehen Sie genau, was sich verändert hat
• Login-Tracking – erfolgreiche und fehlgeschlagene Anmeldeversuche im Blick
• DSGVO-Konformität – revisionssicheres Protokoll gemäß Art. 5 Abs. 2 DSGVO

Protokollierung & Änderungsverfolgung

Automatische CRUD-Protokollierung

Jede Anlage, Änderung und Löschung an konfigurierten Entitäten wird automatisch erfasst – inklusive Zeitstempel und Benutzer-Attribution. Standardmäßig werden Produkte, Bestellungen, Kunden, Kategorien und Medien protokolliert. Sie können den Entitätsumfang jederzeit über die Plugin-Konfiguration anpassen und aus insgesamt 11 Entitätstypen wählen.

Vor-/Nachher-Wertverfolgung

Für jede Änderung werden die konkreten Feldwerte vor und nach der Modifikation gespeichert. So sehen Sie nicht nur, dass ein Produkt geändert wurde, sondern welcher Preis von welchem Wert auf welchen Wert geändert wurde – lückenlos und nachvollziehbar.

Statusübergangs-Protokollierung

Statuswechsel bei Bestellungen, Lieferungen und Zahlungen werden automatisch erfasst und dem verantwortlichen Benutzer zugeordnet. Lieferstatus- und Zahlungsstatusübergänge erscheinen dabei direkt im Protokoll der übergeordneten Bestellung – so haben Sie alle bestellbezogenen Statusänderungen an einem Ort.

Login-Protokollierung

Erfolgreiche Anmeldungen und fehlgeschlagene Login-Versuche werden automatisch im Aktivitätsprotokoll festgehalten – inklusive Benutzername und Zeitstempel. Passwörter oder andere Anmeldedaten werden dabei niemals gespeichert oder verarbeitet.

Integrationsattribution

API-Schreibvorgänge durch OAuth-Integrationen (z. B. ERP- oder PIM-Anbindungen) werden mit dem Namen der Integration attributiert. Im Protokoll erscheint ein „Integration"-Badge, sodass Sie automatisierte Schreibvorgänge sofort von manuellen Änderungen unterscheiden können.

Intelligente Deduplizierung

Wenn dieselbe Entität mehrfach innerhalb einer einzigen Anfrage gespeichert wird (z. B. durch automatische Folgeoperationen), fasst das Plugin alle Änderungen zu einem einzigen übersichtlichen Protokolleintrag zusammen – mit den Nettowerten der Änderungen.

Übersicht & Analyse

Aktivitätslog-Ansicht

Eine dedizierte Seite unter Einstellungen → Erweiterungen → Aktivitätsprotokoll bietet eine durchsuchbare, filterbare Übersicht aller Protokolleinträge. Filtern Sie nach Entitätstyp, Aktion, Benutzer und Zeitraum. Klicken Sie auf einen Eintrag, um die konkreten Feldänderungen im Detailmodal einzusehen.

Verlaufsmodal direkt auf Detailseiten

Ein „Verlauf"-Button erscheint direkt in der Toolbar von Produkt-, Bestell-, Kunden- und anderen Detailseiten. So sehen Sie die vollständige Änderungshistorie der jeweiligen Entität, ohne die aktuelle Seite verlassen zu müssen.

Dashboard-Widget

Das „Letzte Aktivitäten"-Widget auf dem Admin-Dashboard zeigt Ihnen die 10 aktuellsten Protokolleinträge auf einen Blick – inklusive direkter Verlinkung zu den betroffenen Entitäten.

Intelligente Anzeigenamen

Statt kryptischer UUIDs sehen Sie aussagekräftige Namen: Produkttitel, Bestellnummern, Kundennamen. Diese werden zum Zeitpunkt der Änderung gespeichert und bleiben auch nach einer späteren Löschung der Entität lesbar.

Entity Deep-Linking

Entitätsnamen im Protokoll sind direkt verlinkt. Klicken Sie auf eine Bestellung oder ein Produkt, um sofort zur entsprechenden Detailseite zu springen – ohne manuelle Navigation.

CSV-Export

Exportieren Sie die aktuell gefilterten Protokolleinträge als CSV-Datei (UTF-8 mit BOM, Semikolon-Trennzeichen) für externe Auditoren oder zur Archivierung. Bis zu 50.000 Einträge pro Export, mit einem Eintrag pro geändertem Feld für maximale Nachvollziehbarkeit.

Konfiguration & Verwaltung

Aufbewahrungszeitraum

Konfigurieren Sie, wie lange Protokolleinträge aufbewahrt werden: 30, 60, 90, 180 oder 365 Tage – oder unbegrenzt. Ein täglicher Scheduled Task bereinigt abgelaufene Einträge automatisch.

Entitätsumfang

Wählen Sie über eine Multi-Select-Konfiguration genau, welche der 11 verfügbaren Entitätstypen protokolliert werden sollen. Änderungen am Entitätsumfang wirken sich sofort aus – ohne Cache-Leerung oder Neustart.

Systemaktionen

Mit dem Schalter „Systemaktionen protokollieren" steuern Sie, ob Schreibvorgänge durch CLI-Befehle, Scheduled Tasks und API-Integrationen im Protokoll erscheinen. Standard: aktiviert.

Entwickler-Erweiterungs-API

Das Plugin bietet eine öffentliche PHP-Extension-API: Dritthersteller-Plugins können eigene Entitäten für das Aktivitätsprotokoll registrieren, indem sie TrackableEntityProviderInterface implementieren und den entsprechenden Service-Tag setzen. Benutzerdefinierte Entitäten erscheinen automatisch in der Konfiguration und werden vollständig in der Protokollierung erfasst.

Technische Details

• Shopware-Kompatibilität: Version 1.x.x für Shopware 6.6 · Version 2.x.x für Shopware 6.7
• PHP: 8.2+
• Keine externen Dienste – vollständig self-contained, keine Drittanbieter-APIs
• Keine Storefront-Auswirkungen – ausschließlich Administration
• Eigener Log-Kanal (keine Nutzung des Standard-Loggers)
• Deinstallation respektiert die Option „Benutzerdaten behalten"