Safe Media Delete and Quarantine

## Nach der Installation

Es ist nichts nötig, damit die Erweiterung gefahrlos liegen bleiben kann: Sie scannt nichts und

löscht nichts, bevor Sie es verlangen. Der geplante Task entfernt ausschließlich Einträge, die Sie

ausdrücklich in Quarantäne gestellt haben, und auch die erst nach Ablauf der Aufbewahrungsfrist.

## 1. Einstellungen prüfen

Erweiterungen > Meine Erweiterungen > Safe Media Delete > Konfigurieren (Drei-Punkte-Menü).

- Aufbewahrungsfrist (Tage), Standard 30. Wie lange Medien in Quarantäne bleiben, bevor sie

  gelöscht werden. Die Löschung erfolgt nur, wenn sie nach Ablauf weiterhin unbenutzt sind.

- Medien ignorieren, die hochgeladen wurden in den letzten (Tagen), Standard 20. Kürzlich

  hochgeladene Medien werden beim Scannen übersprungen, da sie oft noch nicht zugewiesen sind. Das

  entspricht dem Standard des Shopware-Befehls media:delete-unused.

## 2. Modul öffnen

Inhalte > Safe media delete. Drei Tabs:

- Übersicht — wie viele Einträge in Quarantäne sind, wie viele innerhalb von sieben Tagen fällig

  werden, wie viele zurückgeholt wurden, und die eingestellte Aufbewahrungsfrist.

- In Quarantäne — jeder Eintrag mit Löschdatum und verbleibenden Tagen sowie einer

  Wiederherstellen-Aktion je Eintrag.

- Unbenutzte Medien — der Scan. Er listet auf, worauf nichts verweist, und verändert nichts.

## 3. Scannen, dann in Quarantäne stellen

Starten Sie den Scan im Tab Unbenutzte Medien und sehen Sie sich das Ergebnis an, bevor Sie handeln.

Die Quarantäne verschiebt die Dateien in den Ordner Pending deletion und versieht jede mit einem

Löschdatum. Die Dateien behalten URL und Vorschaubilder und werden weiterhin im Storefront

ausgegeben; es geht also nichts kaputt, während sie warten.

## 4. Zurückholen, was bleiben soll

Jeder Eintrag der Quarantäneliste lässt sich jederzeit während der Frist mit einem Klick in seinen

Ursprungsordner zurückholen.

## 5. Löschlauf abwarten oder selbst starten

Ein täglicher Task löscht Einträge, deren Datum verstrichen ist – und nur die, die zu diesem

Zeitpunkt weiterhin unbenutzt sind. Alles, was wieder verwendet wird, wird stattdessen

zurückgeholt, und der Vorgang wird mit Begründung festgehalten.

"Löschlauf jetzt starten" in der Übersicht macht dasselbe sofort. Die Aktion fragt nach und nennt

die Anzahl der betroffenen Dateien, weil sie die einzige nicht umkehrbare Aktion der Erweiterung

ist. Quarantäne und Wiederherstellung bleiben ein Klick.

## Berechtigungen

Drei ACL-Rollen unter Inhalte, damit Einblick in die Löschliste gewährt werden kann, ohne das Recht

zu löschen:

- Ansehen — Übersicht sehen, scannen, Quarantäneliste lesen

- Verwalten — in Quarantäne stellen und wiederherstellen

- Löschen — Löschlauf ausführen

## Kommandozeile

    bin/console cadnative:media:quarantine-unused --dry-run

    bin/console cadnative:media:quarantine-unused

    bin/console cadnative:media:purge-due

Für den Quarantäne-Befehl stehen zusätzlich --limit, --grace-period-days und --retention-days zur

Verfügung.

## Gut zu wissen

- Getaggte Medien gelten nie als unbenutzt. Shopware wertet ein Medien-Tag als Verwendung; eine

  Datei mit Tag ist für diese Erweiterung ebenso unsichtbar wie für media:delete-unused. Bleibt ein

  Scan leer, obwohl Sie Ergebnisse erwarten, prüfen Sie zuerst die Tags.

- Physische Dateien werden asynchron gelöscht. Shopware stellt die Entfernung in die Queue;

  Speicherplatz wird frei, sobald ein Worker läuft (bin/console messenger:consume async).

- media:delete-unused funktioniert unverändert weiter, auch für Dateien in Quarantäne. Diese

  Erweiterung greift nicht in den Core-Befehl ein; wird er während einer laufenden Quarantäne

  ausgeführt, werden die Dateien sofort gelöscht.

- Die Deinstallation holt zurück, sie löscht nicht. Ohne "Benutzerdaten behalten" wird jeder Eintrag

  vor dem Entfernen der Tabelle in seinen Ursprungsordner zurückverschoben. Der dann leere Ordner

  Pending deletion bleibt bestehen und kann von Hand entfernt werden.