Important !
Par défaut, le facteur propose les méthodes d’envoi suivantes:
- envoi par PHP (à déconseiller)
- envoi par SMTP
A partir de la version 4.3.0 si vous utilisez un fournisseur commercial pour l’envoi des mails transactionnels (Brevo, Mailjet, Mandrill) vous devez installer en plus le plugin Mailshot pour pouvoir utiliser les méthodes d’envoi API de ces fournisseurs !
Introduction
SPIP propose une fonction générique envoyer_mail() pour envoyer un courriel. Elle est assez simple d’utilisation mais peut paraître limitée lorsqu’on veut configurer des options plus complexes : envoi par SMTP, ajout de pièces jointes, etc.
Le plugin Facteur propose d’intégrer proprement à SPIP la librairie PHPMailer. Pour que les fonctionnalités soient immédiatement disponibles, Facteur surcharge de manière compatible la fonction envoyer_mail().
Installation
Placer le contenu du paquet ZIP dans votre dossier plugins/ et activer Facteur dans l’interface d’administration des plugins.
Vous pouvez configurer les options d’envoi (SMTP notamment) en cliquant sur Configuration, puis sur Facteur.
Exemple en local, entrer smtp.orange.fr et port 25.
Appel de la fonction
// Chargement de la fonction
$envoyer_mail = charger_fonction('envoyer_mail', 'inc/');
// Utilisation
$ok = $envoyer_mail(...);
Utilisation
Voici d’abord la fonction standard de SPIP :
function inc_envoyer_mail($destinataire, $sujet, $texte, $from = "", $headers = ""){}
-
$destinataire: adresse de courriel du destinataire -
$sujet: sujet du courriel -
$texte: texte brut du message -
$from: adresse de courriel de l’envoyeur -
$headers: ajout d’entêtes supplémentaires au message
Avec le plugin Facteur, vous pouvez déjà utiliser cette fonction de la même façon. Ce qui signifie que le plugin ne casse pas l’existant si votre code l’utilisait déjà.
Voilà comment est déclarée la fonction dans Facteur et ce qui change :
function inc_envoyer_mail($destinataire, $sujet, $corps, $from = "", $headers = ""){}
-
$destinataire: peut être le destinataire ou bien un tableau où chaque ligne contient un destinataire -
$corps: peut être le texte brut ou bien un tableau associatif contenant toutes les options de message
Description des options
Le tableau $corps des options se présente comme suit :
$corps = [
'options' => 'valeur'
];
Et voici les options possibles :
-
html: le corps du message en version HTML -
texte: le corps du message en version texte brut -
nom_envoyeur: le nom de l’expéditeur -
cc: une ou des adresses de courriel à mettre en copie, soit une adresse en chaine de caractère, soit plusieurs adresses dans un tableau -
bcc: la même chose mais en copie cachée -
repondre_a: l’email à qui les réponses seront adressées, très utile dans le cas d’une utilisation d’un SMTP externe, qui va forcer l’envoi par un nom de domaine bien précis, dans ce cas, l’expéditeur est ce nom de domaine, et le “repondre_a” devient l’email de la personne qui devra recevoir la réponse (d’un help desk par exemple) -
pieces_jointes: un tableau décrivant les pièces jointes, chaque élément est lui-même un tableau associatif décrivant une pièce jointe comme ça :-
chemin: le chemin complet du fichier (chemin sur le file system, pas une URL) -
nom: le nom du fichier -
encodage: comment sera encodé le fichier, par exemple “base64” -
mime: le type MIME du fichier
-
Exemple :
$corps = array(
’html’ => $message,
'cc' => array('truc@truc', 'bidule@bidule'),
’pieces_jointes’ => array(
array(’chemin’ => $chemin_absolu,
’nom’ => ’azerty’,
’encodage’ => ’base64’,
’mime’ => ’image/jpeg’)
)
);
Exemples d’usages
- On pourra par exemple utiliser un squelette existant pour générer le message HTML :
$html = recuperer_fond("inclure/mail", array('id_article' => $id_article));
- Générer le message HTML avec une variable $texte en utilisant le squelette d’email fourni par le plugin
$html = recuperer_fond("emails/texte", array('texte' => $texte));
- Générer le message HTML avec une variable $html en utilisant le squelette d’email fourni par le plugin
$html = recuperer_fond("emails/texte", array('html' => $html));
- Inversement, on pourra générer la version texte du message à partir de sa version HTML en utilisant la méthode html2text de la classe Facteur :
$facteur_mail_html2text = charger_fonction('facteur_mail_html2text', 'inc');
$message_texte = $facteur_mail_html2text($message_html);
- Enfin, on pourra rassembler ces éléments dans le tableau avant de les envoyer :
$corps = array(
'html' => $html,
'texte' => $texte,
'nom_envoyeur' => $nom_envoyeur
);
En cas d’échec des envois
Il arrive que les mails ne parviennent pas à leur destinataire. Dans le dossier /tmp, il y a un sous-dossier facteur consacré aux d’envois rencontrées par le plugin facteur. En y accédant (avec FileZilla par exemple) on peut y trouver 2 sous-dossiers :
- retry contient les mails en instance de réenvoi suite à premier, 2eme, 3eme essai etc
- failed contient les mails en échec définitif parce que marre ça suffit
Activer le mode débug
Si l’envoi des envois échoue, vous pouvez activer le mode débug
Ajouter dans votre fichier config/mes_options.php
define('_LOG_FILTRE_GRAVITE', 8);
define('_FACTEUR_DEBUG_SMTP',4); // 0,1,2,3,4 est la valeur la plus verbeuse
Personnaliser la couleur du bandeau des emails de base
Par défaut, les emails de base ont un bandeau dont la couleur de fond est calculée d’après le logo du site.
Il est possible de personnaliser cette couleur en déclarant la constante suivante dans le fichier mes_options.php
<?php
// définir la couleur du bandeau des emails de base envoyés par le facteur
define('_COULEUR_EMAILS_HTML','#67913D');
Discussions by date of activity
149 discussions
Bonjour,
Je reviens chercher de l’aide sur Webhook failure / Mailjet en ouvrant une nouvelle question plutôt que ma réponse il y a 2 semaines au poste de alain bourdeau qui datait de 2022 car je n’ai toujours pas de solution à ce jour.
Sur un site vieux de 4 ans, avec 2 à 3 news par an, sans aucun problème, j’ai soudain eu une alerte de Mailjet en juin cette année, et à nouveau en septembre, suite à l’envoi de 2 newsletters.
Le site était encore en SPIP 3.2 en juin, et je n’avais rien changé, ni mise à jour ni réglages, puis passé en SPIP 4.2 avec mise à jour des plugins en août, et même alerte à nouveau.
« Webhook failure… It seems one of your webhook is unresponsive and fails to process the events we are pushing. Etc. » pour la deuxième fois consécutive.
Je ne comprends pas pourquoi, ni à quoi correspond l’URL https://monsite.fr/mailshot_webhook.api/mailjet
De quoi parle-t-on ici ? Rastapopoulos parlait du .htaccess dans un précédent post… Mais que faudrait-il y ajouter exactement comme ligne ? Est-ce que ça suffirait pour ne plus avoir d’alerte ?
D’ailleurs, n’est-ce pas étrange que Mailjet parle de Responsive alors qu’il semble qu’on parle d’autorisation d’accès ?
En effet, si je teste l’adresse https://monsite.fr/mailshot_webhook.api/mailjet il y a bien une erreur 403 refus d’accès…
D’avance merci pour vos explications / solutions pour que mon client ne reçoive plus ces alertes de Mailjet (pour autant, j’ai bien les statistiques des mails livrés / ouverts / bloqués hard et soft, etc.)
Je sèche totalement malgré mes recherches !
Déjà tu as bien le .htaccess activé ? et un .htaccess à jour (celui de la version en cours de SPIP utilisée) ?
Merci Rastapopoulos pour ta réponse rapide.
… Alors oui il est activé, si on parle de celui à la racine, et je viens de regarder, ouch, c’est encore celui de la version SPIP 3.2, car en effet j’ai laissé mes propres redirections dedans et n’ai pas pensé à le mettre à jour lors du passage en 4.2 en août.
… Pour autant, en juin lors de la première alerte webhook, c’était encore un SPIP 3.2 qui tournait depuis 4 ans avec son .htaccess activé, avec des newsletters envoyées 3 fois par an sans aucun problème (la dernière avant les alertes webhook, fin janvier 2023).
Je n’aurai pas la possibilité de savoir si l’alerte cesse grâce à la mise à jour du .htaccess avant l’envoi de la prochaine newsletter… en janvier.
Pour autant, la première alerte est arrivée en juin avec un SPIP 3.2 qui n’avait pas bougé depuis 4 ans, ni les plugiins, et c’était le bon .htaccess 3.2… Je n’ai pas l’impression que ça en soit la raison.
Facteur n’ayant rien à avoir avec Mailjet comme tu peux le non-voir dans le code, ta question porte plutôt sur le plugin Mailshot qui gère l’envoi en masse des lettres, généralement en passant par un lien avec un serveur externe. Donc tu devrais plutôt poser ta question dans le plugin Mailshot, qui depuis SPIP 3 a reçu de nombreuses mises à jour (dont pas mal sur les liens avec les services externes).
Je te remercie pour cette piste et cet éclaircissement, je vais donc creuser du côté de Mailshot ces jours-ci pour tenter de comprendre cette première alerte sur un site qui n’avait pas bougé alors (pas le souvenir d’avoir mis à jour aucun plugin avant la première alerte… pour ne pas dire que j’en suis sûre – mais bon, parfois on peut perdre le nord 😅)
Bonne soirée
Reply to this message
Bonjour,
Sous spip 4.0.6, php 7.4.18 et Facteur 5.0.3 en lien avec Maishot 3.0.7 et MailSubscribers 3.0.8.
J’utilise le lien smtp MAILJET.
Si c’est prévus quelle est l’adresse locale que je dois déclarer pour les échanges des Webhooks de mailjet ?.
J’ai créé les dossiers /mailshot_webhook.api/mailjet/ au même niveau que Spip et conforme à l’adresse proposée par mailjet. Je n’ai rien en retour dans ces dossiers.
Merci bien
Alain BOURDEAU
Je n’ai rien compris à ce que tu essayes de faire. Il n’y a strictement aucun “dossier” à créer (pourquoi des dossiers ? de quoi ?). Ya juste à configurer des choses dans l’interface quoi, les clés d’API fournies par le service choisi (ici mailjet donc).
C’est tout simplement savoir comment utiliser ce qui est proposé par Mailjet (voir la capture d’écran suivante).
J’ai néanmoins les notifications par courriel des désinscriptions ou des inscriptions.
Merci bien
En complément, ne plus avoir ce type de message de Mailjet :
Webhook failure
It seems one of your webhook is unresponsive and fails to process the events we are pushing.
API key: xxxxxxx
Webhook endpoint: https://choeurcrescendo.fr/mailshot_webhook.api/mailjet/
Please resolve the issue with this webhook before 2022-05-20 14:35 UTC. After this date, we will stop sending events to your webhook.
If you have any questions, please contact our Support Team.
Sincerely,
The Mailjet team
This email was sent to you by Mailjet because you signed up for a Mailjet account. Please let us know if you feel that this email was sent to you by error.
Mais ça n’a pas de rapport avec Facteur. Faut juste configurer dans la config de avec ce qui est demandé, les clés d’API quoi. Mais pour Mailshot c’est propre à sa config donc, dans son peanneau de config (et dans son forum si ya un problème).
En complément, ne plus avoir ce type de messages de Mailjet :
Webhook failure
It seems one of your webhook is unresponsive and fails to process the events we are pushing.
API key: 2f2a8367c7f629897517e64635f6ca26
Webhook endpoint: https://choeurcrescendo.fr/mailshot_webhook.api/mailjet/
Please resolve the issue with this webhook before 2022-05-20 14:35 UTC. After this date, we will stop sending events to your webhook.
If you have any questions, please contact our Support Team.
Sincerely,
The Mailjet team
This email was sent to you by Mailjet because you signed up for a Mailjet account. Please let us know if you feel that this email was sent to you by error.
Mais t’as bien le .htacess fourni par SPIP ? Sinon les URL d’API peuvent pas marcher… (toutes les URL spip/truc.api/etc)
Merci bien,
Justement, je ne l’avais pas activé !!!
Je viens de le faire, y a plus qu’a voir si “c’est mieux”, ce dont je ne doute pas puisque tes conseils techniques sont rarement pris en défaut.
Amicalement Alain BOURDEAU
Bonjour,
Je viens sur ce fil car j’ai le même problème et je ne le comprends pas non plus.
Sur un site qui existe depuis 4 ans, avec 2 à 3 news par an, j’ai eu cette même alerte de Mailjet pour la premère fois en juin, suite à l’envoi d’une news. Le site était encore en SPIP 3.2, alors que je n’avais rien changé, ni mise à jour ni réglages, et que je n’avais jamais eu ce type d’alerte auparavant.
Passé en SPIP 4.2 cet été, j’ai à nouveau eu, en septembre sur un nouvel envoi, la même alerte à propos de :
“Webhook failure… It seems one of your webhook is unresponsive and fails to process the events we are pushing. Etc.” pour la deuxième fois de suite.
Je ne comprends pas pourquoi, ni à quoi correspond l’URL https://monsite.fr/mailshot_webhook.api/mailjet
De quoi parle-t-on ici ? Rastapopoulos, tu parles du .htaccess… le principal à la racine j’imagine… Que faut-il y ajouter exactement comme ligne ? Est-ce que ça suffit ?
C’est étrange que Mailjet parle de Responsive alors qu’il semble qu’on parle d’autorisation d’accès ?
En effet, si je teste l’adresse https://monsite.fr/mailshot_webhook.api/mailjet il y a bien une erreur 403 refus d’accès…
D’avance merci pour vos explications / solutions.
Bonne journée
Reply to this message
Bonjour,
Une erreur PHP surgit lors de l’envoi d’un mail avec la configuration suivante :
Pensez-vous pourvoir la corriger ?
Merci pour votre réponse et pour ce super plugin !
Hello, il y a déjà un ticket sur ce sujet par ici, encore en cours :)
https://git.spip.net/spip-contrib-extensions/facteur/issues/22
Reply to this message
Hello,
In the SPIP 4 version, there is a change on how html2text is called.
Maybe you could update the guide here to reflect that?
With SPIP 4:
before SPIP 3:
Also, it seems that the facteur html2text function is not identical to the PHPMailer html2text function.
Thank you for the great work on this very useful plugin over the years!
Correction, with SPIP 4:
Thanks, I made the correction in the doc !
Reply to this message
Hello,
y a-t-il un moyen de choisir l’article/le contenu utilisé par facteur pour tester la configuration : “ceci est email de test accentué” ?
Petit up !
Le plugin donne la possibilité de faire un envoi pour tester la configuration : ce mail de test est issu d’un article que l’on ne peut actuellement pas choisir. Or, parfois, le contenu de l’article contient des éléments (iframe, lecteurs audio...) qui perturbent l’analyse que peuvent faire des services tels que mail-tester. Y a-t-il un moyen de choisir l’article/le contenu qui sera envoyé en test ?
Hello,
Tu devrais faire un ticket d’amélioration plutôt : https://git.spip.net/spip-contrib-extensions/facteur/issues
Pour avoir un compte sur la forge : https://contrib.spip.net/spip.php?page=identifiants&focus=nom_inscription&mode=1comite&lang=fr
OK, je viens de créer un ticket
Reply to this message
Bonjour,
J’ai détecté ce qui me semble être une anomalie dans la lib mardownify en PHP 8, quand j’utilise la fonction facteur_mail_html2text j’ai une fatal si j’ai des tags HTML qui n’existe pas dans les fonctions flushStacked_XXX de la lib, en cause :
call_user_func(array(&$this, 'flushStacked_' . $tag));Corrigé par :
Cette limitation de tag est-elle voulu ? Je trouve que c’est assez limitant vu qu’on ne peux même pas mettre un
Reply to this message
Petite astuce: dans le cas d’OVH et d’un SMTP sendinblue
il faut indiquer le port 2525 (le port 587 ne fonctionne pas)
Reply to this message
Bonjour,
J’ai un site sous Spip 4.1.7 / Facteur 5.0.4 sur un serveur Debian 11 / PHP 7.4.33.
Postfix est bien installé, j’ai testé l’envoi de mail depuis la ligne de commande, tout passe bien.
J’ai également testé la fonction mail() de PHP, qui fonctionne également, depuis un script indépendant.
Quand j’essaie d’envoyer un mail de test par Facteur, j’ai ce message d’erreur :
Could not instantiate mail functionQue faire ?
Ah tiens, J’ai fini par trouver..
Erreur dans la config de postfix j’avais ces messages
postfix/postdrop[322784]: warning: uid=33: File too large postfix/sendmail[322783]: fatal: www-data(33): message file too bigDonc j’ai ajouté un parametre dans la config
message_size_limit=0
Et ca marche !
Désolé pour le bruit
Reply to this message
bonjour,
un problème de configuration pour l’utilisation avec sendinblue sur un nouveau site...
cela fonctionne pour d’autres sites (identiques à la version spip4 près)
il y a peut-être eu un changement coté sendinblue car les anciens site sont configurés avec un expéditeur validé par des entrées TXT du DNS, alors que sur mon nouveau site, il me demande de valider le domaine lui-même... ou sinon, vérifie l’expéditeur par mail...
En tout cas, vu de spip/facteur, je ne vois pas de différence
et le constat, c’est que les logs spip semblent indiquer que le mail est parti, alors que les logs sendinblue ne voient rien (et que le mail n’arrive pas !)
merci d’avance d’une piste...
coté log facteur
et aussi un log que je ne connaissais pas (sans doute parceque j’ai activé le debug total ?)
2023-01-17 08:52:49 2a01:e0a:5d0:e4a0:168f:30eb:8d08:785a 3756 Privé debug SPIP\Facteur\FacteurBulkSendinblue: sendAlertIfNeeded sendFailFunction: NOT 2023-01-17 08:52:49 2a01:e0a:5d0:e4a0:168f:30eb:8d08:785a 3756 Privé debug SPIP\Facteur\FacteurBulkSendinblue: sendAlertIfNeeded Important: 2023-01-17 08:52:49 2a01:e0a:5d0:e4a0:168f:30eb:8d08:785a 3756 Privé debug SPIP\Facteur\FacteurBulkSendinblue: sendAlertIfNeeded {} 2023-01-17 08:52:49 2a01:e0a:5d0:e4a0:168f:30eb:8d08:785a 3756 Privé debug SPIP\Facteur\FacteurBulkSendinblue: Send() : result {"messageId":"<202301170752.36367733204@smtp-relay.mailin.fr>"}et coté sendinblue.... rien
un élément de plus
sur une lettre mailshot, les envois ne démarrent pas
et j’ai dans le log facteur bulksendinblue
je ne sais pas ce que ca veut dire...
Reply to this message
Bonjour
:Facteur v5.0.4 spip 4.1.5
j’ utilise facteur avec “SSL, le certificat SSL du serveur SMTP est émis par une Autorité de Certification avec une authentification”
avec cette configuration je configure facteur vers une adresse de la messagerie du serveur qui a différents alias.
si je j’écris a l’auteur spip a qui j’ai attribué une adresse mail égale a cette messagerie .... j’ai une erreur technique ... et pas d’envoi de mail
si je teste la configuration facteur avec un des noms alias de la messagerie, j’obtiens “Aucune adresse email de destination valable pour l’envoi du courriel”
j’ai un site encore en spip 4.0.6 avec facteur4.3.4 sur le même serveur pour lequel ces deux cas fonctionnent
Est-ce un changement volontaire ? est-ce une erreur ?
Je ne suis pas sûr d’avoir compris avec les termes utilisés. (par ex je ne vois pas ce que veut dire “je configure facteur vers une adresse de la messagerie du serveur”)
Est-ce que tu peux réexpliquer en utilisant les termes “adresse d’envoi”, “destinataire” ? Et surtout en donnant des exemples même si fictif (quelle adresse configurée dans facteur, à quelle adresse est envoyé, etc)
je configure l ’adresse d envoi par défaut de facteur adresse.envoi@hotmail.com
Problème 1
Je met cette adresse adresse.envoi@serveur a un auteur spip toto.
j utilise le formulaire contact pour écrire a cet auteur toto .
Erreur.
Si je change l adresse de l’ auteur en ad.autre@hotmail.com et que j utilise le formulaire de contact , le mail part bien
Problème 2
L’adresse d envoi par défaut adresse.envoi@serveur a des alias dont alia.tyty@orange.fr
Si j écris a cet alia.tyty@orange.fr par le formulaire contact ou si je le met pour adresse de test dans ’tester la configuration de facteur ’. L envoi ne marche pas
Il faut aussi expliquer quelle est ta *vraie* configuration d’envoi. Car l’adresse d’envoi c’est juste déclaratif, ce qui envoie c’est la configuration du SMTP (ou fonction mail() de PHP).
Il est plutôt interdit, par exemple, d’affirmer une adresse d’envoi qui ne correspond pas aux droits à envoyer par le SMTP qui envoie (concrètement si l’adresse d’envoi c’est @hotmail, ton SMTP d’envoi devrait être celui de hotmail, pour le cas courant).
La configuration facteur SMTP est égale a l adresse d envoi par defaut adresse.envoi@serveur
L envoi de mail fonctionne si j écris a une adresse différente de l adresse SMTP par exemple ad.autre@hotmail par l intermédiaire du formulaire contact de la dist.
Ce qui ne marche plus c’est si j écris a l adresse SMTP adresse.envoi@serveur ou a un de ses alias alors que cela fonctionnait avant
Bon en fait avec cette version il suffit de ne pas mettre l adresse SMTP a un auteur et de mettre cette adresse SMTP en copie dans la conf facteur pour que le message soit aussi envoye à cette adresse
Je ne comprends toujours pas vraiment, car ça n’existe pas une “adresse SMTP”.
Il y a *l’adresse d’envoi*, qui est une adresse *déclarative*, qui correspond à ce qui sera mis dans l’entête “From” de l’email pour savoir de qui ça vient. Mais cela ne préjuge absolument pas, *du serveur réel* avec lequel sera envoyé l’email. Et qui lui est configuré dans la configuration de l’envoi, càd soit la fonction mail() de PHP, soit un serveur SMTP *précis*. Et donc bien un “serveur SMTP”, pas une “adresse SMTP”. Càd un domaine, un port, un identifiant mdp, etc. C’est ça la configuration de l’envoi dont je demandais quelle était-elle.
Comme dit plus haut, en théorie l’adresse d’envoi déclaré (pour le From) DEVRAIT correspondre le plus souvent à une adresse autorisée du serveur d’envoi configuré (autrement dit si on déclare utiliser une adresse @hotmail pour le From, alors il faut normalement configurer pour utiliser le SMTP de hotmail pour faire les envois, dans le cas courant où on utilise pas un prestataire dédié comme Mailjet etc).
je m’exprime mal mais c’est bien ce que je fait et cela fonctionne.
un mail envoyé par le site a un auteur spip est bien reçu.
L’utilisateur / mot de passe SMTP correspond a un compte ( webmail) qui a des alias qui envois le courrier reçu vers des adresses mail associés ( free, hotmail etc).
je peux aussi envoyer un mail par ma messagerie ( donc sans passer par le site) a cet utilisateur / mot de passe et chaque adresse de l’alias reçois le mail.
ce qui ne fonctionne plus c’est quand je met cet utilisateur / mot de passe comme mail d’un auteur SPIP
.
laisse tomber. je vais simplement ne pas mettre cela a un auteur mais en copie des mails de facteur.
Reply to this message
Add a comment
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Follow the comments:
|
