nette/mail 4.1.2

Author: dg

mail/cs/@home.texy

@@ -310,6 +310,34 @@ $mailer->send($mail);
 Jako další parametry v konstruktoru můžeme uvést počet opakování a čekací dobu v milisekundách.
 
 
+Ladění e-mailů .{data-version:4.1.2}
+====================================
+
+Při vývoji nebo na staging serveru nechcete, aby se nějaký testovací e-mail náhodou dostal k reálnému zákazníkovi. Existují dva způsoby, jak tomu zabránit.
+
+Pro lokální vývoj doporučujeme spustit u sebe lehký SMTP zachytávač jako "Mailpit":https://mailpit.axllent.org nebo "MailHog":https://github.com/mailhog/MailHog. Přijmou každou zprávu, ukáží ji ve webovém UI a nikdy nic nepředají dál – Nette Mailu jen nastavíte `127.0.0.1:1025`:
+
+```neon
+mail:
+	smtp: true
+	host: 127.0.0.1
+	port: 1025
+```
+
+Pro staging nebo prostředí, kde lokální zachytávač spustit nejde, má Nette Mail vestavěný redirect. Nastavte cílovou adresu v konfiguraci a každý příjemce v `To`, `Cc` i `Bcc` bude nahrazen touto adresou. Nette Mail uloží originály do hlaviček `X-Original-*`, takže pořád vidíte, komu měl e-mail dorazit, a do předmětu lze přidat značku:
+
+```neon
+mail:
+	redirect:
+		to: dev@example.com
+		subjectPrefix: '[debug]'   # volitelný
+```
+
+Zkrácený zápis `redirect: dev@example.com` postačí, když nepotřebujete prefix v předmětu. V debug módu se automaticky připojí panel v [Tracy Baru |tracy:] s přehledem všech odeslaných e-mailů.
+
+Interně tohle zajišťuje [api:Nette\Mail\Interceptor], který nabízí ještě událost `$onSent` pro vlastní listenery (audit log, metriky, …).
+
+
 DKIM
 ====
 

mail/en/@home.texy

@@ -310,6 +310,34 @@ $mailer->send($mail);
 Other parameters in the constructor include the number of retries and the waiting time in milliseconds.
 
 
+Debugging Emails .{data-version:4.1.2}
+======================================
+
+When developing or running a staging server, you don't want a test email to slip out to a real customer. There are two ways to make sure that never happens.
+
+The recommended local setup is to run a lightweight SMTP catcher like "Mailpit":https://mailpit.axllent.org or "MailHog":https://github.com/mailhog/MailHog on your machine. They accept every message, show it in a web UI, and never forward anything – you just point Nette Mail at `127.0.0.1:1025`:
+
+```neon
+mail:
+	smtp: true
+	host: 127.0.0.1
+	port: 1025
+```
+
+For staging or environments where you can't run a local catcher, Nette Mail has a built-in redirect. Set the destination in the configuration and every `To`, `Cc`, and `Bcc` recipient is replaced with it. Nette Mail preserves the originals in `X-Original-*` headers so you can see who the email was meant for, and you can prepend a marker to the subject:
+
+```neon
+mail:
+	redirect:
+		to: dev@example.com
+		subjectPrefix: '[debug]'   # optional
+```
+
+The shortcut form `redirect: dev@example.com` works when you don't need a subject prefix. In debug mode, a [Tracy Bar |tracy:] panel listing all sent emails attaches automatically.
+
+Internally this is handled by [api:Nette\Mail\Interceptor], which also exposes an `$onSent` event for custom listeners (audit logs, metrics, …).
+
+
 DKIM
 ====