Order Emails

Über

Das offizielle E-Commerce-Plugin von Payload speichert Bestellungen, ohne E-Mails an Kunden oder Admins zu senden. Dieses Plugin schließt diese Lücke, indem es einen afterChange-Hook an die orders-Collection anhängt und über payload.sendEmail eine E-Mail auslöst. Der bereits konfigurierte E-Mail-Adapter wie nodemailer oder Resend wird verwendet. Die Events orientieren sich an den vier Status des E-Commerce-Plugins: processing, completed, cancelled und refunded. Zusätzlich gibt es ein created-Event beim ersten Schreiben. Created, completed, cancelled und refunded sind standardmäßig aktiviert. Processing feuert nur, wenn eine Bestellung zu diesem Status zurückkehrt. Ein unbekannter Status greift auf ein opt-in defaultEvent zurück, sodass ein durch ein anderes Plugin hinzugefügter Status nicht zu unerwartetem Verhalten führt. Empfänger sind pro Event als customer, admin, both oder none konfigurierbar. Wenn eine Bestellung keine customerEmail enthält, was bei eingeloggten Kunden im offiziellen Stripe-Flow vorkommt, liest der Hook den Kunden-Datensatz auf derselben req aus, um die Adresse zu ermitteln. Beträge werden von der kleinsten Einheit formatiert: 2500 wird zu 25.00 EUR. currencyDecimals lässt sich als Zahl oder als Map pro Währungscode einstellen. Templates sind standardmäßig reiner Text ohne Markup. Jedes Event akzeptiert ein String-Template mit {{placeholder}}-Tokens oder eine Funktion, die den vollen Kontext erhält. Für die Admin-Kopie gibt es ein separates adminTemplate. Das Plugin fügt keine Collection, kein Feld und keine Migration hinzu, sondern nur den Hook. Der Versand erfolgt innerhalb des Requests. Ein langsamer SMTP-Server verzögert den auslösenden Schreibvorgang. Ein fehlgeschlagener Versand wird abgefangen und geloggt, ohne die Bestellung zu blockieren. Für Staging-Umgebungen gibt es eine dryRun-Option, die alle Nachrichten auflöst und protokolliert, ohne sie an den Adapter zu übergeben.

Paketinformationen

Paketname

payload-order-emails

Neueste Version

1.0.1

Entpackte Größe

31 kB

Lizenz

MIT

Wöchentliche Downloads

5

Zuletzt veröffentlicht

21. Aug. 2026