Acorn Mail: SMTP in WordPress eindelijk voorspelbaar (met Acorn CLI)

Als je WordPress-sites bouwt in meerdere omgevingen (lokaal, staging, productie), dan ken je de SMTP-pijn: één plugin doet het ‘meestal’, een andere is lastig te debuggen, en uiteindelijk kom je er pas achter dat mail faalt wanneer een klant geen reset-link ontvangt. Daarbovenop komt nog dat SMTP-plugins niet alleen onvoorspelbaar kunnen zijn, maar soms ook een minder fijn security-profiel hebben — inclusief bekende kwetsbaarheden in het ecosysteem.

Roots introduceert daarom Acorn Mail: een package dat SMTP-configuratie en vooral het testen ervan in een WordPress-applicatie stroomlijnt. Het idee is simpel: configureer via environment variables en gebruik Acorn’s CLI (command line interface) om gericht een testmail te versturen met duidelijke foutoutput.

Wat is Acorn Mail precies?

Acorn Mail is een add-on voor het Roots Acorn-ecosysteem. In plaats van een klassieke WordPress SMTP-plugin die via wp-admin wordt ingesteld, leunt Acorn Mail op omgeving-variabelen (bijvoorbeeld in je .env) en integreert het rechtstreeks met WordPress’ mailstack via PHPMailer (de library die WordPress gebruikt om mail te versturen).

Zodra er mail-credentials aanwezig zijn (dus niet leeg), haakt Acorn Mail automatisch in op de WordPress PHPMailer-instantie en zet SMTP voor je klaar. Geen extra UI, geen verborgen opties per omgeving, maar een configuratie die past bij moderne deployment-flows.

Installatie via Composer (zoals je het wilt in Roots-projecten)

Acorn Mail installeer je naast Acorn met Composer:

composer require roots/acorn-mail

composer require roots/acorn-mail

Hierna is de basisopzet vooral een kwestie van het zetten van de juiste variabelen.

SMTP configureren met environment variables

Acorn Mail verwacht de volgende omgeving-variabelen:

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=

Zodra deze waarden gevuld zijn, detecteert Acorn Mail dat er credentials beschikbaar zijn en configureert het SMTP automatisch via PHPMailer. Dat maakt het gedrag ook lekker voorspelbaar: leeg is ‘geen SMTP’, gevuld is ‘SMTP actief’.

Geavanceerde configuratie: mail.php publiceren

Heb je meer controle nodig dan alleen de basisvariabelen, dan kun je volgens de aankondiging een configuratiebestand publiceren. Dat doe je via de Acorn CLI:

wp acorn mail:config

wp acorn mail:config

Daarmee krijg je een mail.php configbestand dat je kunt gebruiken voor geavanceerdere instellingen (de exacte opties hangen af van de config die het package publiceert).

SMTP testen zonder giswerk: wp acorn mail:test

Het grootste praktische voordeel zit ’m voor veel developers in het testen. In plaats van een ‘Test mail versturen’-knop met minimale feedback, biedt Acorn Mail een CLI-commando:

wp acorn mail:test [--to=]

wp acorn mail:test [--to=]

Met dit commando verstuur je een testmail naar een opgegeven adres. Belangrijker: het commando is bedoeld om fouten onderweg netjes te tonen, zodat je snel ziet of het probleem zit in DNS/poort, credentials, relay policies of iets anders in de keten.

Waarom Roots dit oplost op package-niveau (en niet als klassieke plugin)

De onderliggende gedachte is herkenbaar als je met Roots/Sage/Acorn werkt: liever configuratie als code, en tooling die past bij een moderne workflow. SMTP is bij uitstek zo’n onderwerp waar je niet wilt leunen op een UI-instelling die iemand ooit in wp-admin aanklikte, en waar je wél behoefte hebt aan reproduceerbare setup per omgeving.

Door direct te koppelen aan PHPMailer — de plek waar WordPress uiteindelijk toch uitkomt — blijft het model simpel: WordPress blijft WordPress, maar je SMTP-configuratie wordt consistenter en beter testbaar.

Samenvatting

1. SMTP in WordPress is vaak fragiel over omgevingen heen, en debugging is meestal matig.
2. Acorn Mail brengt SMTP-configuratie terug naar environment variables en haakt automatisch in op WordPress’ PHPMailer.
3. Installatie gaat via Composer: composer require roots/acorn-mail.
4. Je zet MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_FROM_ADDRESS, MAIL_FROM_NAME en Acorn Mail regelt de rest.
5. Testen kan via CLI met wp acorn mail:test [--to=], met de bedoeling om fouten duidelijk weer te geven.