Prueba los emails de WordPress en local en tu Mac

Captura cada email de wp_mail() de tu WordPress local, incluidos los de WooCommerce y los formularios de contacto, con un servidor SMTP local en tu Mac.

En un sitio WordPress local, los emails suelen desaparecer: wp_mail() se los pasa a mail() de PHP, que en un Mac no los envía a ningún lugar útil. Con Mailbox enrutas WordPress por SMTP hacia un servidor en tu Mac, y cada email — restablecimientos de contraseña, pedidos de WooCommerce, envíos de formularios de contacto — aparece completamente renderizado.

1. Inicia un servidor en Mailbox

Abre Mailbox. La primera vez que lo abres crea un servidor en el puerto 2525 — asegúrate de que esté iniciado. Si en su lugar añades otro servidor, Mailbox le asigna un puerto libre; usa ese puerto en los pasos siguientes.

2. Envía wp_mail() por SMTP

Crea un plugin must-use en wp-content/mu-plugins/local-mailbox.php. Los plugins must-use se cargan automáticamente, y si dejas este fuera del control de versiones nunca llegará a producción.

<?php
/**
 * Plugin Name: Local Mailbox SMTP
 * Description: Sends all wp_mail() email to Mailbox on this Mac. Development only.
 */

add_action('phpmailer_init', function ($phpmailer) {
    $phpmailer->isSMTP();
    $phpmailer->Host = '127.0.0.1';
    $phpmailer->Port = 2525;
    $phpmailer->SMTPAuth = false;
    $phpmailer->SMTPSecure = '';
    $phpmailer->SMTPAutoTLS = false;
});

// Sites on http://localhost send from "wordpress@localhost", which wp_mail() rejects.
add_filter('wp_mail_from', function ($from) {
    return is_email($from) ? $from : 'wordpress@example.test';
});

La primera parte enruta el correo por SMTP sin autenticación ni TLS: Mailbox no usa ninguno de los dos. La segunda corrige una peculiaridad: por defecto, WordPress envía desde wordpress@ más el dominio de tu sitio, y en un sitio en http://localhost:8080 esa dirección no tiene ningún punto en el dominio, así que wp_mail() la rechaza antes siquiera de enviar el email.

¿Prefieres un plugin? Un plugin SMTP como WP Mail SMTP también sirve: elige el mailer “Other SMTP”, host 127.0.0.1, puerto 2525, cifrado None y la autenticación desactivada. En un sitio localhost, configura además una dirección From con un dominio de aspecto real.

3. Envía un email de prueba

Con WP-CLI:

wp eval 'var_dump( wp_mail( "test@example.com", "Hello from WordPress", "It works!" ) );'

bool(true) significa que WordPress ha despachado el email, y este aparece en Mailbox. O simplemente usa Lost your password? en la pantalla de inicio de sesión.

Local, DDEV y otros entornos Docker

Si WordPress se ejecuta dentro de un contenedor, 127.0.0.1 es el propio contenedor. Usa host.docker.internal como host; si se rechaza la conexión, activa Permitir acceso a la red en Mailbox (Configuración → General) y reinicia el servidor. El Mailpit integrado de DDEV solo captura el mail() de PHP, así que, en cuanto WordPress envía por SMTP, es Mailbox quien recibe el email. DDEV espera que los servicios del host escuchen en todas las interfaces, así que con DDEV activa Permitir acceso a la red.

Solución de problemas

  • wp_mail() devuelve false — añade un hook a wp_mail_failed y registra el error. Invalid address: (From) significa que falta el filtro wp_mail_from; si no, suele ser un servidor detenido o un puerto incorrecto.
  • Los emails siguen sin llegar — otro plugin SMTP está sobrescribiendo la configuración. Desactívalo en local o apúntalo a Mailbox.

Qué revisar a continuación

Los emails de WooCommerce y de los temas son famosos por lo difícil que es que se vean bien en todos los clientes. Ejecuta la verificación de compatibilidad HTML para ver qué CSS no renderizan Outlook o Gmail, y usa la vista previa móvil para revisar los emails de pedidos en una pantalla del tamaño de un teléfono.

Más guías