> For the complete documentation index, see [llms.txt](https://docs.pixeleyes.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixeleyes.de/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/plugin-update-log-handbuch.md).

# Plugin Update Log – Handbuch

### 🧩 Überblick

Das Plugin Plugin Update Log protokolliert automatisch alle relevanten Aktionen rund um Shopware-Plugins, wie:

* Installation
* Updates
* Aktivierung / Deaktivierung
* Deinstallation

Alle Vorgänge werden historisch gespeichert und können im Admin eingesehen sowie exportiert werden.

### 📍 Navigation

Nach der Installation findest du das Plugin unter:

Einstellungen → Plugins → Plugin Update Log

### 📊 Funktionen

#### 🔍 Übersicht (Liste)

In der Listenansicht erhältst du eine vollständige Historie aller Plugin-Aktionen.

**Angezeigte Informationen:**

* Plugin (Name)
* Plugin Base Class
* Composer Name
* Aktion (z. B. Update, Install)
* Ergebnis (Success / Failed)
* Version vorher / nachher
* Shopware-Version
* Quelle (Admin / CLI / System)
* Benutzer
* Zeitpunkt

***

#### 🔎 Suche

Über die globale Suche im Admin kannst du direkt nach Log-Einträgen suchen:

* Plugin-Name
* Composer Name
* Aktion
* Benutzer

***

#### 🎯 Filter

Im rechten Bereich stehen folgende Filter zur Verfügung:

* Plugin
* Benutzer
* Aktion
* Ergebnis
* Quelle
* Seitengröße

Alle Filter lassen sich kombinieren.

***

#### 📄 Detailansicht

Ein Klick auf einen Eintrag öffnet die Detailseite mit:

* Vollständigen Metadaten
* Benutzerinformationen
* Nachricht (falls vorhanden)
* Zusatzdaten (JSON)

***

#### 📤 CSV-Export

Über den Button „Export“ kannst du die aktuellen Filter-Ergebnisse als CSV-Datei herunterladen.

**Enthaltene Daten:**

* Plugin
* Composer
* Aktion
* Ergebnis
* Versionen
* Shopware-Version
* Quelle
* Benutzer
* Zeitpunkt
* Nachricht

***

### ⚙️ Technische Details

#### 🔄 Automatische Protokollierung

Das Plugin nutzt Shopware Events:

* `PluginPostInstallEvent`
* `PluginPostUpdateEvent`
* `PluginPostActivateEvent`
* `PluginPostDeactivateEvent`
* `PluginPostUninstallEvent`

***

#### 🧠 Quelle (Source Type)

Die Quelle wird automatisch erkannt:

| Quelle  | Beschreibung      |
| ------- | ----------------- |
| admin   | Aktion im Backend |
| cli     | Kommandozeile     |
| system  | Systemprozesse    |
| unknown | nicht eindeutig   |

#### 👤 Benutzererkennung

* Admin-User wird automatisch ermittelt
* CLI → „CLI“
* System → „SYSTEM“

***

#### 📦 Initialer Snapshot

Beim Installieren des Plugins wird automatisch ein Snapshot aller vorhandenen Plugins erstellt.

***

### 🔐 Sicherheit

Der CSV-Export ist nur über die Shopware Admin API erreichbar und durch Berechtigungen geschützt.

***

### ⚠️ Hinweise

* Das Plugin protokolliert sich selbst nicht, um Schleifen zu vermeiden
* Alte Einträge werden nicht automatisch gelöscht
* Export ist aktuell auf maximal 500 Datensätze begrenzt (Shopware Limit)

***

### 🛠️ Anforderungen

* Shopware 6.7.8.x
* Admin-Zugriff erforderlich

***