Acorn Mail: SMTP in WordPress endlich sauber konfigurieren und testen

Wer WordPress-Projekte über mehrere Umgebungen hinweg betreibt (lokal, Staging, Produktion), kennt das Problem: E-Mail-Versand ist eines der ersten Dinge, die plötzlich „nur manchmal“ funktionieren. SMTP-Plugins sollen helfen, sind aber in der Praxis oft eine zusätzliche Fehlerquelle – und im schlechtesten Fall sogar ein Sicherheitsrisiko (inklusive dokumentierter Schwachstellen in der Plugin-Landschaft).

Roots adressiert genau diesen Schmerzpunkt mit Acorn Mail: einem Add-on für das Roots-Ökosystem, das SMTP-Konfiguration und vor allem das Testen des Mailversands über Acorns CLI (Command Line Interface, also die Kommandozeilen-Tools rund um Acorn) vereinfachen soll. Der Fokus liegt auf reproduzierbarem Setup und brauchbarem Feedback, wenn etwas schiefgeht.

Was Acorn Mail konkret macht

Acorn Mail hängt sich automatisch in die WordPress-Mail-Pipeline ein, sobald Mail-Credentials vorhanden sind. Technisch bedeutet das: Wenn die relevanten Umgebungsvariablen gesetzt sind, wird die WordPress-PHPMailer-Instanz (WordPress’ interne Bibliothek fürs Versenden von E-Mails) so konfiguriert, dass sie über SMTP sendet – ohne dass du in einem UI-Plugin herumklicken oder Einstellungen pro Umgebung nachziehen musst.

Installation per Composer

Acorn Mail ist dafür gedacht, zusammen mit Acorn genutzt zu werden und wird über Composer installiert:

composer require roots/acorn-mail

composer require roots/acorn-mail

SMTP-Zugangsdaten über Environment Variables

Die Konfiguration erfolgt über Umgebungsvariablen. Sobald diese erkannt werden (also nicht leer sind), übernimmt Acorn Mail die SMTP-Einrichtung automatisch:

MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_FROM_ADDRESS=
MAIL_FROM_NAME=

MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_FROM_ADDRESS=
MAIL_FROM_NAME=

Das ist besonders praktisch, wenn du je Umgebung unterschiedliche Credentials brauchst oder Secrets ohnehin über die Plattform (z. B. Hosting-Env, CI/CD, Secret Store) bereitstellst. Du vermeidest damit auch das typische Problem, dass jemand „mal schnell“ im Admin-Bereich Settings ändert und später niemand mehr nachvollziehen kann, was in welcher Umgebung aktiv ist.

Erweiterte Konfiguration: mail.php veröffentlichen

Wenn du über die Standard-Env-Settings hinaus feinere Einstellungen brauchst, kannst du laut Ankündigung eine mail.php-Konfiguration veröffentlichen (publish). Das passiert ebenfalls über die Acorn-CLI:

wp acorn mail:config

wp acorn mail:config

Der wichtigste Teil: SMTP wirklich testen – mit sichtbaren Fehlern

In vielen SMTP-Setups ist nicht die Einrichtung das Schlimmste, sondern das Debugging: Testmails verschwinden, Timeouts werden geschluckt, Logs fehlen. Acorn Mail bringt dafür einen dedizierten CLI-Test mit:

wp acorn mail:test [--to=]

wp acorn mail:test [--to=]

Damit kannst du eine Testmail an eine Zieladresse schicken und bekommst dabei eine saubere Ausgabe, inklusive möglicher Fehler, die unterwegs auftreten. Gerade beim Wechsel des Mailproviders, bei Firewall-/Port-Themen oder falschen Credentials spart das erfahrungsgemäß enorm Zeit, weil du nicht mehr über „Kontaktformular ausfüllen und hoffen“ testen musst.

Warum das in der Praxis hilft (und wann nicht)

• Weniger Plugin-Overhead: Kein zusätzliches SMTP-Plugin mit eigenem UI, eigener Speicherung und potenziellen Sicherheitsproblemen als Angriffsfläche.
• Konfigurations-Standardisierung: Env-Variablen sind ein sauberer, deploybarer Weg, um Credentials pro Umgebung zu managen.
• Besseres Troubleshooting: Ein CLI-Test, der Fehler sichtbar macht, ist im WordPress-Kontext Gold wert.
• Roots/Acorn-Stack vorausgesetzt: Der Ansatz spielt seine Stärken aus, wenn du ohnehin Composer + Acorn nutzt.

Kurzfazit

Acorn Mail positioniert sich als schlanke, entwicklerfreundliche Lösung für ein altes WordPress-Problem: zuverlässiger SMTP-Versand über verschiedene Umgebungen hinweg – inklusive eines brauchbaren Test-Workflows über WP-CLI/Acorn-CLI. Wer Acorn im Projekt hat und SMTP stabil sowie nachvollziehbar betreiben will, bekommt damit ein deutlich aufgeräumteres Setup als mit vielen klassischen SMTP-Plugins.