# 4. Benutzung

## Aktivitätsprotokoll

Das Aktivitätsprotokoll finden Sie unter **Einstellungen → Erweiterungen → Aktivitätsprotokoll**.

![Aktivitätsprotokoll-Listenansicht mit Filtern und Benutzer-Avataren](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-de297d6095344123b137026f6dfe87ab6c56c7ef%2F1.png?alt=media)

### Einträge verstehen

Jeder Protokolleintrag enthält:

| Spalte                 | Beschreibung                                                                                                                                                       |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Datum/Uhrzeit**      | Zeitstempel der Änderung                                                                                                                                           |
| **Benutzer**           | Benutzer-Avatar und Name des Admin-Benutzers, der die Änderung vorgenommen hat; bei API-Integrationen erscheint der Integrationsname mit einem „Integration"-Badge |
| **Entitätstyp**        | Art der geänderten Entität (z. B. Produkt, Bestellung)                                                                                                             |
| **Entitäts-ID / Name** | Lesbarer Name der Entität (z. B. Produkttitel, Bestellnummer) mit direktem Link zur Detailseite                                                                    |
| **Aktion**             | Art der Änderung: `created`, `updated`, `deleted`, `login_success`, `login_failed`                                                                                 |

### Filtern und Suchen

Verwenden Sie die Filterleiste oberhalb der Liste, um Einträge einzugrenzen:

* **Entitätstyp** – filtern Sie nach einer bestimmten Entitätsart
* **Aktion** – filtern Sie nach der Art der Änderung
* **Benutzer** – filtern Sie nach einem bestimmten Admin-Benutzer oder einer Integration
* **Datumsbereich** – schränken Sie den Zeitraum ein

Die Volltextsuche durchsucht Entitätsname, Entitäts-ID und Benutzername.

### Feldänderungen einsehen

Klicken Sie auf das Kontextmenü (drei Punkte) einer Zeile und wählen Sie **Details anzeigen**, um ein Modal mit den feldebenigen Vor-/Nachher-Werten zu öffnen.

![Detailmodal mit Vor-/Nachher-Werten für eine Produktänderung](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-21bb68769e540d0522cb7a6f1116a48c7e9fca84%2F2.png?alt=media)

Das Modal zeigt für jeden geänderten Wert:

* **Feld** – Name des geänderten Feldes
* **Alter Wert** – Wert vor der Änderung
* **Neuer Wert** – Wert nach der Änderung

Bei neu angelegten Entitäten sind die alten Werte leer, bei gelöschten Entitäten die neuen Werte.

### CSV-Export

Klicken Sie auf **CSV exportieren**, um die aktuell gefilterten Einträge als CSV-Datei herunterzuladen. Der Export berücksichtigt alle aktiven Filterkriterien und enthält eine Zeile pro geändertem Feld.

Das Exportformat verwendet UTF-8 mit BOM und Semikolon als Trennzeichen – kompatibel mit Microsoft Excel. Pro Export werden maximal 50.000 Einträge exportiert.

***

## Verlauf auf Entitäts-Detailseiten

Auf den Detailseiten von Produkten, Bestellungen, Kunden und weiteren Entitäten erscheint nach der Plugin-Aktivierung ein **„Verlauf"-Button** in der Toolbar.

![History-Modal auf einer Produktdetailseite](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-098062f416122e246ecdffb1b119e91acc70b6ea%2F3.png?alt=media)

Klicken Sie darauf, um die vollständige Änderungshistorie der jeweiligen Entität einzusehen, ohne die aktuelle Seite verlassen zu müssen.

Das Modal zeigt alle Protokolleinträge für diese Entität in einem Akkordeon, sortiert nach Datum (neueste zuerst). Jeder Eintrag kann aufgeklappt werden, um die feldebenigen Änderungen zu sehen.

Der History-Button ist auf den folgenden Detailseiten verfügbar:

* Produkte
* Bestellungen
* Kunden
* Kategorien
* Hersteller
* Eigenschaften
* Versandmethoden
* Zahlungsmethoden
* Verkaufskanäle
* CMS-Seiten

**Hinweis:** Der Button ist nur sichtbar, wenn die Entität bereits gespeichert wurde (d. h. auf Erstellungsseiten wird er nicht angezeigt).

***

## Dashboard-Widget

Das Widget **„Letzte Aktivitäten"** erscheint automatisch auf dem Admin-Dashboard und zeigt die 10 aktuellsten Protokolleinträge auf einen Blick.

![Dashboard mit dem „Letzte Aktivitäten"-Widget](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-8fbc1e0cf07fad062bb969280c762a3572cada53%2F4.png?alt=media)

Jeder Eintrag im Widget zeigt:

* Benutzer-Avatar und Name
* Aktion-Badge (z. B. „updated", „created")
* Entitätstyp und Name mit direktem Link zur Detailseite
* Relative Zeitangabe (z. B. „vor 5 Minuten")

Über **Alle anzeigen** gelangen Sie direkt zur vollständigen Listenansicht des Aktivitätsprotokolls.

Das Widget ist nur für Admin-Benutzer mit der Berechtigung `momo_admin_activity_log:read` sichtbar.