# 1. Beschreibung

In jedem Shopware-Shop sammeln sich über die Zeit ungenutzte Mediendateien an – besonders nach Produktimporten, Layout-Überarbeitungen oder dem Wechsel von Hersteller-Logos. Shopware bietet zwar den CLI-Befehl `media:delete-unused`, dieser ist jedoch für die meisten Shop-Betreiber ohne Serverzugang nicht nutzbar.

Der **Mediathek-Aufräumer** bringt diese Funktionalität direkt in die Shopware-Administration: als visuelles Dashboard, das ungenutzte Mediendateien sicher erkennt, anzeigt und löscht – ganz ohne Kommandozeilen-Kenntnisse.

![Dashboard-Übersicht mit ungenutzten Mediendateien](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-6edc8acf009fe7fcfbd403f0b5cbc1541b4801f5%2F1.png?alt=media)

## Funktionen im Überblick

### Dashboard mit Dateiliste

Das Dashboard zeigt alle ungenutzten Mediendateien in einer paginierten Liste an – mit Vorschaubild (oder Dateityp-Icon für PDFs, Videos usw.), Dateiname, Typ, Größe und Upload-Datum. Eine Zusammenfassungsleiste am oberen Rand zeigt die Gesamtanzahl und den kombinierten Speicherbedarf auf einen Blick.

### Massenauswahl und sicheres Löschen

Wählen Sie einzelne Dateien per Checkbox aus oder nutzen Sie „Alle auswählen" – auch seitenübergreifend. Vor jeder Löschung erscheint ein Bestätigungsdialog mit Anzahl der Dateien und Gesamtgröße. Während des Löschvorgangs wird eine Fortschrittsanzeige eingeblendet; das Ergebnis (gelöscht / übersprungen / fehlgeschlagen) wird danach detailliert angezeigt.

![Bestätigungsdialog vor dem Löschen](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-ab448181cfb41a43767a7f40da146069247284bf%2F2.png?alt=media)

### Erweiterte Erkennung

Shopware erkennt Vorschaubilder, die in YouTube- oder Vimeo-Video-CMS-Elementen eingestellt sind, nicht als „in Verwendung". Der Mediathek-Aufräumer schließt diese Lücke: Vorschaubilder in Video-Elementen werden korrekt als verwendet markiert und erscheinen nicht in der Löschliste – unabhängig davon, auf welcher Seite das Video-Element eingebettet ist.

### Filter und Sortierung

Filtern Sie die Liste nach Dateityp (Bild, Video, Dokument, Sonstiges), Mindestdateigröße oder Upload-Alter. Sortieren Sie nach Dateiname, Dateigröße oder Datum – auf- oder absteigend. Ein Klick setzt alle aktiven Filter zurück.

![Filter nach Dateityp aktiv](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-030a2895126f17cc45bbc08dd75c368681bdb5ca%2F3.png?alt=media)

### Benutzerrechte (ACL)

Das Plugin fügt zwei separate Berechtigungen hinzu:

* **momo\_media\_cleanup:read** – Zugriff auf das Dashboard und die Liste der ungenutzten Dateien
* **momo\_media\_cleanup:delete** – Berechtigung zum Löschen ungenutzter Mediendateien

Mitarbeiter können die Liste einsehen, ohne Löschrechte zu benötigen.

## Technische Details

| Eigenschaft             | Wert                                                                            |
| ----------------------- | ------------------------------------------------------------------------------- |
| Shopware-Kompatibilität | 6.6.x und 6.7.x                                                                 |
| PHP                     | 8.2+                                                                            |
| Externe Dienste         | Keine – das Plugin kommuniziert ausschließlich mit der eigenen Shopware-Instanz |
| Datenbankmigrationen    | Keine – das Plugin erstellt keine eigenen Tabellen                              |