Mediathek-Aufräumer

Über die Erweiterung

Ungenutzte Mediendateien häufen sich in jeder Shopware-Installation über Zeit an – besonders nach Produktimporten oder Layout-Änderungen. Der eingebaute CLI-Befehl media:delete-unused ist für die meisten Shop-Betreiber nicht zugänglich und bietet keine visuelle Vorschau. Der Mediathek-Aufräumer löst dieses Problem: ein übersichtliches Admin-Dashboard, das ungenutzte Dateien sicher identifiziert, anzeigt und auf Knopfdruck löscht – ganz ohne CLI-Kenntnisse.

Ihre Vorteile auf einen Blick

• Kein CLI-Zugriff nötig: Alles direkt in der Shopware-Administration erledigen.
• Sicher: Bestätigungsdialog mit Anzahl und Gesamtgröße vor jeder Löschung.
• Kein Timeout: Asynchroner Hintergrund-Scan verarbeitet auch große Mediatheken – Ergebnisse werden 4 Stunden gecacht, sodass die Seitennavigation keinen erneuten Scan auslöst.

Funktionen im Detail

Übersichtliches Dashboard

Das Dashboard zeigt alle ungenutzten Mediendateien in einer paginierten Liste – mit Vorschaubild (bzw. Dateityp-Icon für PDFs, Videos etc.), Dateiname, Dateityp, Dateigröße und Uploaddatum. Eine Zusammenfassungsleiste am oberen Rand zeigt die Gesamtanzahl und den kombinierten Speicherplatz aller ungenutzten Dateien auf einen Blick.

Massenauswahl und sichere Löschung

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 der Anzahl und Gesamtgröße der betroffenen Dateien. Eine Fortschrittsanzeige informiert während des Löschvorgangs, und das Ergebnis (gelöscht / übersprungen / fehlgeschlagen) wird nach Abschluss detailliert angezeigt.

Filter und Sortierung

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

Hintergrund-Scan und Ergebnis-Caching

Der Scan läuft asynchron im Hintergrund über den Symfony Messenger – kein HTTP-Timeout, auch bei sehr großen Mediatheken. Eine Fortschrittsanzeige informiert in Echtzeit über den Scan-Status. Das Ergebnis wird bis zu 4 Stunden gecacht: Seitennavigation und Löschvorgänge lösen keinen erneuten vollständigen Scan aus. Ein "Erneut scannen"-Button aktualisiert die Ergebnisse jederzeit auf Knopfdruck. Vor jeder Löschung prüft das Plugin zusätzlich in Echtzeit, ob eine Datei seit dem Scan wieder in Verwendung genommen wurde – so werden keine aktiv genutzten Dateien gelöscht.

Benutzerrechte (ACL)

Das Plugin fügt zwei separate Benutzerrechte hinzu: Anzeigen und Löschen ungenutzter Medien. Mitarbeiter können die Liste einsehen, ohne Löschrechte zu erhalten.

Technische Details

• Shopware-Kompatibilität: 6.6.x und 6.7.x
• PHP: 8.2+
• Externe Dienste: Keine – das Plugin kommuniziert ausschließlich mit Ihrer eigenen Shopware-Instanz.
• Performance: Asynchroner Hintergrund-Scan via Symfony Messenger verhindert Timeouts auch bei sehr großen Mediatheken; Ergebnisse werden 4 Stunden gecacht.
• Standard-konform: Nutzt Shopwares UnusedMediaSearchEvent – andere Plugins können ihre Medien als "in Verwendung" kennzeichnen, und diese werden respektiert.