51 lines
1.5 KiB
Markdown
51 lines
1.5 KiB
Markdown
# email
|
|
|
|
Wysyłka maili przez SMTP z SiteIntegrations, w runtime (bez Payload email
|
|
adaptera). Edytor zmienia SMTP w panelu — następny mail idzie z nowymi
|
|
ustawieniami, bez restartu.
|
|
|
|
## Zależność
|
|
|
|
```json
|
|
"dependencies": { "nodemailer": "^6.9.0" }
|
|
```
|
|
(+ `@types/nodemailer` w devDependencies)
|
|
|
|
## Config
|
|
|
|
Brak opcji — SMTP (host, port, user, password, from) jest w SiteIntegrations
|
|
(tab SMTP). Edytor konfiguruje w panelu.
|
|
|
|
## Front — sendEmail (server)
|
|
|
|
```ts
|
|
import { sendEmail } from 'ipal-kit/server'
|
|
|
|
const result = await sendEmail({
|
|
payload,
|
|
to: '[email protected]',
|
|
subject: 'Nowa wiadomość',
|
|
html: '<h1>Cześć</h1><p>Treść…</p>', // gotowy HTML (Twój wygląd)
|
|
// text: 'wersja plain', from: '...', replyTo: '...'
|
|
})
|
|
|
|
if (result.sent) {
|
|
// result.messageId
|
|
} else {
|
|
// result.error — np. "SMTP is not configured..."
|
|
}
|
|
```
|
|
|
|
- **HTML to Twój argument** — plugin nie ma templatek, wysyła to co podasz.
|
|
Wygląd maila składasz na froncie.
|
|
- Zwraca `{ sent: true, messageId }` albo `{ sent: false, error }` — nie
|
|
rzuca wyjątku, nie wycieka detali SMTP do klienta.
|
|
- Port 465 → implicit TLS, inne → STARTTLS.
|
|
- `server-only` — hasło SMTP nigdy w bundlu przeglądarki.
|
|
|
|
## Uwaga: maile systemowe Payloada
|
|
|
|
Reset hasła / weryfikacja email idą przez wbudowany mechanizm Payload
|
|
(`config.email`), którego ten moduł **nie** konfiguruje (celowo — wymagałby
|
|
SMTP w env). Jeśli ich potrzebujesz, to osobna konfiguracja adaptera przy
|
|
`buildConfig`. |