Description
WordPress envoie ses courriels avec la fonction d’envoi du serveur web, souvent peu fiable, et ils finissent dans les pourriels. Duva Mail remplace ce moyen d’envoi : chaque courriel envoyé avec wp_mail() (commandes WooCommerce, formulaires de contact, réinitialisations de mot de passe, notifications de commentaires, n’importe quelle extension) est soumis à votre compte Duva par HTTPS.
- Fonctionne avec tout ce qui appelle
wp_mail(): l’extension se branche sur le filtrepre_wp_maildu noyau, de sorte que WordPress garde son contrat habituel (trueen cas de succès,falseet l’actionwp_mail_faileden cas d’échec). - Respecte les filtres
wp_mail_from,wp_mail_from_nameetwp_mail_content_type, et lit les en-têtesFrom,Reply-To,Cc,BccetContent-Type(chaînes ou tableaux, destinataires de la formeNom <adresse>). - Pièces jointes à partir de fichiers locaux (10 fichiers et 5 Mo au total, comme l’accepte l’API de Duva).
- Aucun repli silencieux : si Duva ne peut pas prendre le courriel,
wp_mail()retournefalse,wp_mail_failedse déclenche, et l’échec s’affiche dans Réglages > Duva Mail et dans un avis d’administration. Le courriel n’est jamais envoyé par un autre moyen dans votre dos. - Reprises sûres : chaque courriel porte une clé d’idempotence, de sorte qu’une panne réseau est reprise sans jamais créer de doublon. Les erreurs de quota et les erreurs du client ne sont jamais reprises.
- Clé d’API tenue hors du navigateur : le champ des réglages ne l’affiche jamais, et vous pouvez plutôt la définir dans
wp-config.php(DUVA_MAIL_API_KEY). - Aucune télémétrie, aucun suivi, aucun appel à un autre serveur que l’adresse d’API que vous configurez.
Ce qu’il vous faut
Un compte Duva avec un domaine d’envoi vérifié, et une clé d’API créée pour ce domaine dans le tableau de bord de Duva.
À savoir avant l’installation
- Les courriels ne sont envoyés qu’à partir de votre domaine Duva. Si WordPress (ou une extension) définit un expéditeur sur un autre domaine, Duva Mail envoie depuis votre adresse d’expéditeur par défaut et place l’expéditeur d’origine dans
Reply-To, de sorte que les réponses aux formulaires de contact parviennent quand même au visiteur. - To, Cc et Cci : ils sont transmis aux champs To, Cc et Bcc de l’API de Duva, avec leurs noms. Chaque adresse reçoit sa propre copie, qui montre tous les destinataires en To et en Cc ; une adresse en Cci n’apparaît que sur sa propre copie. Un courriel avec des destinataires en Cci mais aucun en To est refusé, car Duva exige une adresse en To.
- Seuls les courriels
text/plainettext/htmlsont pris en charge.Un courriel HTML est envoyé en tant que HTML seulement (pas de version texte automatique). Les corpsmultipart/*bruts sont refusés avec une erreur explicite. - PHPMailer est contourné. Les extensions qui personnalisent PHPMailer (l’action
phpmailer_init) ou qui ajoutent leurs propres réglages SMTP n’ont aucun effet sur les courriels envoyés par Duva.EN
- L’API refuse certains en-têtes personnalisés (par exemple
Return-Path,Message-ID) ; le courriel échoue alors avec un message qui nomme l’en-tête. Voir la FAQ.
Services externes
Cette extension envoie les courriels de votre site à l’API de Duva, un service tiers, à l’adresse d’API définie dans les réglages (par défaut https://api.duva.ca). C’est la seule raison d’être de l’extension et la seule connexion externe qu’elle effectue.
- Ce qui est envoyé, et quand : pour chaque courriel envoyé par WordPress, l’expéditeur, les destinataires, l’objet, le corps, les pièces jointes éventuelles et les en-têtes personnalisés sont transmis à Duva pour qu’il livre le courriel. Les boutons « Vérifier la connexion » et « Envoyer un courriel de test » contactent aussi l’API. Chaque requête porte votre clé d’API, la langue du site (pour localiser les messages d’erreur) et un agent utilisateur indiquant les versions de l’extension, de WordPress et de PHP.
- Ce qui n’est pas envoyé : rien d’autre sur votre site, vos utilisateurs ou vos visiteurs, et rien n’est envoyé quand aucun courriel n’est envoyé.
- Conditions d’utilisation de Duva : https://duva.ca/conditions
- Politique de confidentialité de Duva : https://duva.ca/confidentialite
Captures d’écran



Installation
- Téléversez le dossier
duva-maildans/wp-content/plugins/, ou installez le zip depuis Extensions > Ajouter > Téléverser une extension. - Activez l’extension.
- Allez dans Réglages > Duva Mail et saisissez votre domaine d’envoi et votre clé d’API.
- Cliquez sur Envoyer un courriel de test.
Facultatif : pour garder la clé d’API hors de la base de données, ajoutez cette ligne à wp-config.php (elle a alors priorité, et le champ des réglages est masqué) :
define( 'DUVA_MAIL_API_KEY', 'dv_...' );
FAQ
-
L’extension est active, mais mes courriels ne sont pas envoyés.
-
Ouvrez Réglages > Duva Mail : l’état indique si l’extension est configurée, et le journal des échecs montre les dernières erreurs (état HTTP, code d’erreur et message). Un
404signifie que la clé d’API est inconnue, révoquée, expirée ou qu’elle appartient à un autre domaine ; un403, que le domaine n’est pas encore vérifié ou que le compte n’a pas le droit d’envoyer ; un429, qu’une limite de débit ou votre quota d’envoi a été atteint. -
Revient-elle à l’envoi par défaut de WordPress quand Duva échoue ?
-
Non, volontairement. Un repli silencieux enverrait des courriels transactionnels depuis un serveur non vérifié et cacherait le problème. L’échec est retourné à l’appelant (
wp_mail()retournefalse), journalisé et affiché aux administrateurs. -
Fonctionne-t-elle avec WooCommerce, Contact Form 7, Gravity Forms… ?
-
Oui, tant qu’elles envoient par
wp_mail(). Vérifiez que l’adresse d’expéditeur qu’elles utilisent est sur votre domaine d’envoi ; sinon, Duva Mail la remplace par l’adresse d’expéditeur par défaut des réglages et garde l’originale dansReply-To. -
Mes destinataires en Cc et en Cci se voient-ils entre eux ?
-
Les destinataires en To et en Cc se voient, comme dans tout courriel. Les destinataires en Cci restent cachés : leur adresse n’apparaît que sur leur propre copie. Chaque adresse reçoit exactement une copie.
-
Pourquoi un courriel a-t-il été refusé à cause d’un en-tête ?
-
L’API de Duva n’accepte que les en-têtes
X-*(sauf ceux que la plateforme réserve) et une courte liste d’en-têtes standard :List-Unsubscribe,List-Unsubscribe-Post,List-Id,In-Reply-To,References,Auto-Submitted,Precedence,Importance,Feedback-ID. Des en-têtes commeReturn-Path,Message-IDouDKIM-Signaturesont refusés. Retirez-les du code qui envoie le courriel. -
Qu’arrive-t-il aux pièces jointes ?
-
Les fichiers locaux sont lus et envoyés avec le courriel, jusqu’à 10 fichiers et 5 Mo au total. Les extensions de fichiers exécutables et de scripts (
.exe,.js…) sont refusées. Les comptes encore dans le bac à sable de Duva ne peuvent pas envoyer de pièces jointes. Au-delà d’une limite, le courriel échoue avec une erreur explicite et n’est pas envoyé. -
Oui, avec le filtre
duva_mail_payload, qui reçoit le corps de la requête et les arguments dewp_mail()juste avant l’envoi de la requête, et retourne le corps à envoyer :add_filter( 'duva_mail_payload', function ( $payload ) { $payload['tags'] = array( 'wordpress' ); return $payload; } ); -
Où la clé d’API est-elle conservée ?
-
Dans l’option
duva_mail_settings, ou nulle part dans la base de données si vous définissezDUVA_MAIL_API_KEYdanswp-config.php(recommandé). La clé n’est jamais envoyée au navigateur, affichée dans une page, écrite dans le journal des échecs ni incluse dans un message d’erreur. -
Que contient le journal des échecs ?
-
Uniquement des messages d’erreur : aucune clé d’API, aucun contenu de courriel, aucune adresse de courriel complète (elles sont masquées). Il garde les 20 derniers échecs et peut être vidé.
-
Qu’arrive-t-il à mes données quand je désinstalle ?
-
La suppression de l’extension retire ses options (réglages, journal des échecs, état). Les courriels déjà soumis à Duva restent dans votre compte Duva.
-
Prend-elle en charge le multisite ?
-
Les réglages sont propres à chaque site. L’activation sur le réseau n’est pas encore prise en charge de façon particulière.
Avis
Il n’y a aucun avis sur cette extension.
Contributeurs & développeurs
« Duva Mail » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs“Duva Mail” a été traduit dans 1 locale. Remerciez l’équipe de traduction pour ses contributions.
Traduisez « Duva Mail » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Historique des changements
0.2.1
- L’image de la bannière de la page de l’extension a été mise à jour. Aucun changement au comportement de l’extension.
0.2.0
- To, Cc et Cci sont maintenant transmis aux champs To, Cc et Bcc de l’API de Duva, avec leurs noms. Les destinataires en To et en Cc se voient entre eux ; une adresse en Cci n’apparaît que sur sa propre copie.
- Un courriel avec des destinataires en Cci mais aucun en To est refusé.
0.1.0
- Première version : interception de
pre_wp_mail, écran de réglages, vérification de la connexion, courriel de test, journal des échecs.
