> For the complete documentation index, see [llms.txt](https://docs.bfn-it.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bfn-it.de/documentation/e-mail-versand-nur-an-freigegebene-domains/entwickler-dokumentation.md).

# Entwickler-Dokumentation

### Technischer Ansatz

Die Erweiterung integriert sich über einen Event Subscriber in den Mailversand von Shopware.

Vor dem Versand wird geprüft, ob die Empfänger-Domain in der konfigurierten Whitelist enthalten ist.

***

### Integration

Die Prüfung erfolgt über das Event `MailBeforeSentEvent`.

Die erlaubten Domains werden aus der Plugin-Konfiguration geladen und mit den Empfängeradressen verglichen. Ist eine Domain nicht erlaubt, wird der Versand gestoppt und ein Log-Eintrag erzeugt.

***

### Konfiguration

Die erlaubten Domains werden über das Konfigurationsfeld `emailWhitelist` gepflegt.

Beispiel: example.com;firma.de;test.local

***

### Hinweise für Entwickler

* Die Erweiterung arbeitet ohne Template-Anpassungen
* Die Logik liegt zentral im Mail-Subscriber
* Aktuell werden Empfänger im `To`-Feld geprüft
* Blockierte Versandversuche werden protokolliert