Order Emails

Описание

Официальный плагин ecommerce от Payload сохраняет заказ, но не отправляет письма покупателю. Плагин закрывает этот пробел: добавляет один хук `afterChange` к коллекции заказов и отправляет письмо через `payload.sendEmail`. Используется тот email-адаптер, который уже настроен в конфигурации Payload (nodemailer, Resend и другие). События привязаны к четырём статусам из плагина ecommerce: `processing`, `completed`, `cancelled` и `refunded`. Плюс событие `created` при первой записи. По умолчанию включены `created`, `completed`, `cancelled` и `refunded`. Событие `processing` срабатывает только когда заказ возвращается в этот статус. Неизвестный статус обрабатывается через опциональный `defaultEvent`, поэтому статус от другого плагина не вызовет проблем. Получатели настраиваются для каждого события: `customer`, `admin`, `both` или `none`. Если в заказе нет `customerEmail` (так бывает при оплате авторизованного пользователя через Stripe), хук читает запись покупателя в той же `req` и берёт адрес оттуда. Суммы форматируются из минорных единиц: `2500` превращается в `25.00 EUR`. Точность `currencyDecimals` задаётся числом или объектом для отдельных валют, по умолчанию 2. Шаблоны по умолчанию это простой текст, без разметки и названия магазина. Для каждого события задаётся строковый шаблон с токенами `{{placeholder}}` или функция с полным контекстом. Для административной копии предусмотрен отдельный `adminTemplate`. Экспорт шаблонов по умолчанию доступен для импорта, поэтому их можно расширять, а не переписывать. Плагин не добавляет коллекций, полей или миграций, только хук. Отправка выполняется синхронно внутри запроса, поэтому медленный SMTP замедляет запись заказа. Ошибка отправки перехватывается и логируется без повторных попыток и не блокирует сохранение. Опция `dryRun` собирает и логирует все письма, не передавая их адаптеру, это полезно для staging-окружения.

О пакете

Имя пакета

payload-order-emails

Последняя версия

1.0.1

Размер

31 кБ

Лицензия

MIT

Загрузок в неделю

5

Последняя публикация

21 авг. 2026 г.