# 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

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pixeleyes.de/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/plugin-update-log-handbuch.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.