Mail-Archiv

    Alle versendeten E-Mails im Admin archivieren und durchsuchen

    Schritt-für-Schritt-Anleitung zur Einrichtung des Mail-Archivs, Suche im Archiv und Konfiguration der Aufbewahrungsdauer.

    Installation und erste Konfiguration

    Das Plugin beginnt nach der Aktivierung sofort mit der Archivierung. Eine kurze Konfiguration stellt sicher, dass Aufbewahrungsdauer und Ausnahmen korrekt eingestellt sind.

    Plugin-Konfiguration Mail-Archiv

    Öffnen Sie die Plugin-Konfiguration unter Erweiterungen > Meine Erweiterungen > Bronn Mail-Archiv > Konfiguration. Folgende Einstellungen stehen zur Verfügung:

  1. Plugin aktiv: Archivierung ein-/ausschalten
  2. Aufbewahrungsdauer (Tage): Wie viele Tage werden Mails aufbewahrt? Standard: 90 Tage. 0 = unbegrenzt
  3. Maximale Einträge: Optionale Begrenzung der Archivgröße
  4. Ausgeschlossene Templates: Kommagetrennte Liste technischer Template-Namen
  5. Speichern Sie die Einstellungen. Das Archivieren beginnt mit dem nächsten versendeten E-Mail.

    Mail-Archiv im Admin öffnen

    Das Mail-Archiv finden Sie unter Einstellungen > Mail-Archiv in der Shopware Administration. Nach der ersten Aktivierung ist das Archiv leer – E-Mails werden ab diesem Zeitpunkt erfasst.

    Nach einem kurzen Testversand (z.B. Passwort-Zurücksetzen) erscheint der erste Eintrag in der Liste.

    Im Mail-Archiv suchen

    Die Archivliste bietet Suchfunktionen und Filter, um gesuchte Mails schnell zu finden.

    Mail-Archiv Übersichtsliste

    Die Archivliste zeigt alle gespeicherten Mails mit folgenden Spalten:

  6. Datum/Uhrzeit des Versands
  7. Empfänger (E-Mail-Adresse)
  8. Betreff
  9. Template (technischer Template-Name)
  10. Flow (Name des auslösenden Flows, falls zutreffend)
  11. Status (Versendet/Fehler)
  12. Die Liste ist standardmäßig nach Datum absteigend sortiert. Klicken Sie auf eine Spaltenüberschrift zum Umsortieren.

    Suchfunktion und Filter im Mail-Archiv

    Die Suchleiste oben durchsucht Empfänger-E-Mail und Betreff gleichzeitig. Für präzisere Suchen stehen Filter bereit:

  13. Zeitraum: Von/Bis-Datepicker
  14. Template: Dropdown aller verwendeten Templates
  15. Status: Alle / Versendet / Fehler
  16. Beispiel: Um alle Bestellbestätigungen an einen bestimmten Kunden zu finden, geben Sie die E-Mail-Adresse in die Suche ein und wählen Sie das Template "order_confirmation" im Filter.

    HTML-Vorschau einer archivierten Mail

    Ein Klick auf eine Mail in der Archivliste öffnet die Detailansicht mit der vollständigen HTML-Vorschau. Sie sehen die E-Mail exakt so, wie der Empfänger sie gesehen hat – inklusive Formatierung, Tabellen und allen Inhalten.

    Oben in der Detailansicht stehen alle Metadaten: Empfänger, Absender, Datum, Template-Name, zugehörige Bestellnummer (falls vorhanden) und Flow-Name.

    Aufbewahrung und Bereinigung

    Das Mail-Archiv bereinigt sich automatisch. Hier erfahren Sie, wie Sie die Aufbewahrung konfigurieren und bei Bedarf manuell eingreifen.

    Scheduled Task für automatische Bereinigung

    Unter Einstellungen > System > Geplante Aufgaben finden Sie den Task Bronn Mail-Archiv Bereinigung. Er läuft täglich und löscht automatisch Einträge, die älter als die konfigurierte Aufbewahrungsdauer sind.

    Prüfen Sie hier, ob der Task aktiv ist und wann er zuletzt ausgeführt wurde. Falls der Task nicht läuft, prüfen Sie, ob der Shopware Message Worker korrekt eingerichtet ist:

    ```

    php bin/console messenger:consume

    ```

    Manuelle Bereinigung im Mail-Archiv

    Über die Schaltfläche "Archiv bereinigen" oben rechts in der Archivliste können Sie die Bereinigung manuell auslösen. Ein Bestätigungsdialog zeigt, wie viele Einträge gelöscht werden.

    Nützlich nach Konfigurationsänderungen: Wenn Sie die Aufbewahrungsdauer von 90 auf 30 Tage reduzieren, werden bei der nächsten automatischen oder manuellen Bereinigung alle Einträge älter als 30 Tage gelöscht.