wp_mail() è la funzione con cui WordPress invia le email: le notifiche di registrazione e di recupero password, gli avvisi di commento, i messaggi dei moduli di contatto, le conferme dei plugin. Riceve destinatario, oggetto, testo, intestazioni e allegati, e li passa alla libreria PHPMailer, inclusa nel core, che costruisce il messaggio e lo spedisce.
Una funzione sostituibile
wp_mail() appartiene alle funzioni che WordPress chiama pluggable: un plugin può definirne una versione propria prima che il core carichi la sua. Oggi la strada consigliata è un’altra, perché più plugin che sostituiscono la stessa funzione entrano in conflitto: usare gli hook che la funzione mette a disposizione. Il filtro wp_mail modifica destinatari, oggetto e intestazioni prima dell’invio; l’azione phpmailer_init permette di configurare PHPMailer, per esempio per usare un server SMTP; il filtro pre_wp_mail, introdotto con la versione 5.7, permette di prendere in carico l’invio e saltare del tutto quello predefinito. L’azione wp_mail_failed segnala gli invii falliti.
Che cosa non dice
Che wp_mail() restituisca vero significa solo che il messaggio è stato consegnato al primo passaggio, cioè al programma di posta locale o al server SMTP. Non significa che sia arrivato al destinatario, né che non sia finito nello spam. Un rifiuto successivo, un bounce, arriva come un’altra email all’indirizzo di ritorno.
Nei plugin ThinkClouds
Tutti i plugin ThinkClouds che spediscono email, dai codici OTP di ThinkLogin alle conferme di Kevents, usano wp_mail(), e possono indicare la natura del messaggio con l’intestazione X-SMP-Category. SMTP-MailPool intercetta la funzione e decide la categoria in quest’ordine: l’intestazione X-SMP-Category aggiunta dal plugin mittente, il filtro smp_email_category, infine parole chiave cercate nell’oggetto. Con l’intestazione X-SMP-Defer un’email non critica va direttamente in coda. ThinkWatch conta le email fallite degli ultimi sette giorni e le segnala a ThinkRepo.