Acorn Mail: SMTP en WordPress sin plugins frágiles (y con pruebas desde CLI)

En proyectos WordPress medianamente serios, el email transaccional (recuperación de contraseña, formularios, pedidos, notificaciones internas) no puede depender de “a veces llega”. Y, sin embargo, la configuración de SMTP sigue siendo uno de esos puntos donde cada entorno (local, staging, producción) te obliga a pelearte con ajustes, plugins y pruebas poco fiables.

El problema no es solo la fricción: el ecosistema de plugins SMTP ha demostrado ser un área delicada. Hay plugins que se comportan de forma inconsistente, otros que exponen configuraciones de manera insegura y, en general, el feedback cuando algo falla suele ser escaso. En el peor de los casos, incluso han aparecido vulnerabilidades públicas en plugins de este tipo (Roots menciona un ejemplo concreto: CVE-2023-6875).

Con este contexto, Roots ha presentado Acorn Mail: un paquete pensado para simplificar la configuración de SMTP y, sobre todo, hacer que probar el envío sea directo y con errores visibles, apoyándose en la CLI de Acorn (la interfaz de línea de comandos que acompaña al framework Acorn en proyectos WordPress modernos).

Qué es Acorn Mail y qué intenta arreglar

Acorn Mail es una integración que se engancha al PHPMailer de WordPress (la clase que WordPress usa internamente para enviar correos) y lo configura para usar SMTP cuando detecta credenciales válidas en el entorno. La idea es muy pragmática:

• Configuración por variables de entorno: más portable entre entornos y más alineada con flujos tipo Twelve-Factor App.
• Menos dependencia de plugins: en lugar de añadir otra capa de UI y lógica dentro del admin, se resuelve desde configuración y CLI.
• Testing real desde consola: un comando que dispara un email de prueba y muestra errores de forma “limpia”, sin tener que adivinar qué ha pasado.

Instalación con Composer

Acorn Mail se instala como un paquete adicional junto a Acorn, usando Composer (lo habitual si estás trabajando con un stack tipo Roots/Sage/Bedrock o un proyecto WordPress más moderno con dependencias gestionadas).

composer require roots/acorn-mail

composer require roots/acorn-mail

Configuración SMTP con variables de entorno

Una vez instalado, la configuración base se hace vía variables de entorno. Esto encaja bien con despliegues en contenedores, plataformas tipo PaaS o cualquier pipeline CI/CD donde no quieres “clicar” ajustes a mano en wp-admin.

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=

Según el anuncio, cuando Acorn Mail detecta que estas credenciales existen (es decir, no están vacías), configura automáticamente el PHPMailer de WordPress para usar SMTP. Esto te evita el patrón típico de: instalar plugin → rellenar campos → cruzar dedos → repetir en otro entorno.

Configuración avanzada: publicar el archivo mail.php

Si necesitas ajustar opciones más allá de lo básico, Acorn Mail permite publicar un fichero de configuración mail.php mediante un comando de la CLI de Acorn:

wp acorn mail:config

wp acorn mail:config

Este enfoque es útil cuando quieres versionar configuración avanzada (sin secretos) o adaptar el comportamiento según el entorno con mayor granularidad, manteniendo el “source of truth” en el proyecto y no en una pantalla del admin.

Probar el envío: un comando, un email y errores claros

La parte más agradecida del enfoque de Acorn Mail es el testing. En lugar de botones de “Send Test Email” que a veces no explican nada, Roots incorpora un comando específico para enviar un correo de prueba indicando el destinatario:

wp acorn mail:test [--to=]

wp acorn mail:test [--to=]

La promesa aquí es simple: poder disparar un envío y ver de forma clara qué falla en el proceso (autenticación, conexión, host/puerto, etc.). En flujos de trabajo con múltiples entornos, esto acorta muchísimo el tiempo de diagnóstico.

Cuándo tiene sentido apostar por Acorn Mail

No todos los sitios WordPress necesitan un enfoque “framework + CLI”. Pero si tu proyecto ya utiliza Acorn (o estás en el ecosistema Roots), Acorn Mail encaja especialmente bien cuando:

• Gestionas infraestructura con despliegues reproducibles (CI/CD) y quieres evitar configuración manual.
• Trabajas con varios entornos y te interesa que el email se configure igual en todos.
• Quieres reducir dependencia de plugins para piezas críticas como el correo transaccional.
• Necesitas una forma rápida de validar credenciales SMTP sin pelearte con tooling pobre.

Resumen

Acorn Mail es una propuesta concreta para un problema muy repetido en WordPress: SMTP suele ser frágil, difícil de probar y con poca visibilidad cuando falla. Roots lo ataca con un enfoque más “de aplicación”: configuración por entorno, integración directa con PHPMailer y comandos de CLI para publicar configuración y enviar correos de prueba. Si ya trabajas con Acorn, es una manera limpia de sacar el SMTP del terreno de los plugins y llevarlo a un flujo más predecible.