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
- Version 1.8.11
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.
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 :
- '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 :
Exemples d’usages
- On pourra par exemple utiliser un squelette existant pour générer le message 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 :
- include_spip('classes/facteur');
- $texte = Facteur::html2text($html);
- Enfin, on pourra rassembler ces éléments dans le tableau avant de les envoyer :
- 'html' => $html,
- 'texte' => $texte,
- 'nom_envoyeur' => $nom_envoyeur
- );
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
Version 1.8.11
RSS 2.0
Vos commentaires
# Le 15 décembre 2017 à 10:55, par Jaseur Boréal
En réponse à : Facteur
Bonjour
Facteur affiche SMTP Error : Could not connect to SMTP host. lors de tests d’envois par le sous-domaine SMTP de mailjet "in-v3.mailjet.com". Pourtant les tests-infolettres du plugin Newsletters partent correctement et sont réceptionnées dans les minutes suivantes. Je n’ai pas testé d’envois réels d’infolettres.
Merci de toutes solutions pour optimiser les réglages sur un spip 3.2 à jour avec « Facteur 3.5.0 » + « MailShot 1.22.4 » et "Newsletters 1.5.3 " dernières versions stables.
J’ai vérifié que dans « Facteur » et dans « Mailshot » les réglages de ports soient similaires.
Les tests de départs de courriels de Facteur semblent tourner indéfiniment avant d’afficher des erreurs type : « SMTP Error : Could not connect to SMTP host. »
Les emails de tests ne partent pas quelques soient les réglages de port ou de connexion sécurisée TLS , SSL ou pas. J’ai aussi posé la question à Cédric pour Mailshot
Hier, à ma demande, les techniciens chez Mailjet ont migré mon compte d’une vieille version « V1 in.mailjet.com » vers la dernière version « in-v3.mailjet.com ».
Les clés ne changent pas, seul le réglage du choix de sous-domaine Mailjet a été modifié dans Facteur & Mailshot pour la V3 avec la configuration de Mailshot bien enregistrée.
Avez- vous une idée d’un réglage oublié ?
Merci pour toute piste de solution.
Répondre à ce message
# Le 26 octobre 2017 à 18:58, par julien
En réponse à : Facteur
PROBLEME AVEC SPIP 3.2 et FACTEUR 3.4.11
Depuis la mise à jour SPIP, le lien de confirmation dans un mail est codé avec des balises HTML visible :
Télécharger
Le fichier /newsletter/emails/inc-button.html serait en cause.
Possible de le revoir ou bien on tripatouille dans le php ?
Merci à vous,
Julien
# Le 10 novembre 2017 à 00:24, par RastaPopoulos
En réponse à : Facteur
Ce code vient du plugin Newsletters, pas de Facteur non ? Plutôt demander dans le forum du plugin en question ?
Enfin je ne sais pas mais « emails/inc-button » est dans Facteur, mais ya pas « newsletters/emails/inc-button » ça ça n’existe pas.
Et dans le plugin Newsletters il y a un « newsletters/inc/button » par contre.
Donc ya confusion là…
Il y a des « pre » généré, mais pourquoi ? Comme une sécurité on dirait.
# Le 10 novembre 2017 à 10:16, par Julien
En réponse à : Facteur
Le code HTML problématique venait bien du plugin facteur (génération d’un bouton de lien), mais le bug provenait d’une incompatibilité entre une nouvelle mesure de sécurité de SPIP 3.2 et le plugin newsletter ou facteur.
En tout cas, tout est corrigé par les auteurs de ces plugins ! Merci à eux.
# Le 27 novembre 2017 à 09:24, par Caroline
En réponse à : Facteur
Pas pour moi - j’ai réinstallé le plugin facteur mais le problème persiste...
Répondre à ce message
# Le 8 novembre 2017 à 15:39, par nicod_
En réponse à : Facteur
Ça serait quand même bien pratique de pouvoir envoyer un mail avec un contenu html qui utilise lui aussi l’habillage générique utilisé pour les mails en texte.
Qu’on puisse faire
$envoyer_mail($dest, $sujet, $texte, $exp);tout simplement, et que le facteur compose tout seul en multipart, que $texte soit du html ou pas :Facteur::html2text($texte)recuperer_fond("emails/texte",array('texte'=>$texte,'sujet'=>$sujet));Du coup, le nom du template emails/texte ne serait plus logique, mais à garder pour la compat.
Qu’en pensez vous ?
# Le 8 novembre 2017 à 23:10, par RastaPopoulos
En réponse à : Facteur
En fait ya déjà une fonction fournie, qui contient un test pour savoir si c’est vraiment du texte brut OU du semi-html simplifié (pas le html complet). C’est la fonction
facteur_email_wrap_to_html.Si tu as du morceau de html basique (un texte, un bouton, un gros lien joli etc) dans un squelette, dedans tu ajoutes
#FILTRE{facteur_email_wrap_to_html}et c’est tout, ton email utilisera l’entourage commun et donc cohérent avec l’ensemble de tes emails.On pourrait imaginer qu’il y ait un test plus compliqué/complet dans envoyer_mail qui fasse tout ça au même endroit du genre
- si ya aucune balise c’est du texte brut, on envoie à l’entourage dans le contexte « texte »
- si ya des balises, et qu’il y a
</body>mais PAS</html>, c’est un html basique, on envoie à l’entourage dans le contexte « html »- si ya
</html>c’est un html complet, on fait rien, on le laisse comme çaPour l’instant envoyer_mail fait la distinction texte brut VS html. Et le filtre à mettre dans #FILTRE fait la distinction entre texte brut et semi html et ajoute l’entourage.
# Le 13 novembre 2017 à 21:04, par nicod_
En réponse à : Facteur
Je confirme,
#FILTRE{facteur_email_wrap_to_html}fonctionne bien, dans les /mails comme dans les /notificationsJ’ai donc surchargé celles de Formidable parce que de base elles sont vraiment toutes moches : une liste de saisies brutes en Times, noir et blanc, sans entête, avec juste un peu de gras pour égayer.
C’est pas le Pérou mais ça fait un peu moins brut de décoffrage.
On pourrait peut être leur mettre ce filtre par défaut, non ?
# Le 13 novembre 2017 à 21:19, par RastaPopoulos
En réponse à : Facteur
Si ya bien toutes les dépendances (à priori oui puisque ça nécessite Facteur), carrément oui !
# Le 13 novembre 2017 à 22:52, par Maïeul
En réponse à : Facteur
nicod, cela donnerait quoi en capture d’écran ? Parce que personnellement je trouve que les mails de notifs que je recois avec notifications sont hyper chargé. Il y a un entête hyper long avant d’arriver au contenu. Le côté hyper sobre des mails de Formidable, j’apprécie. On arrive directement aux réponses...
Répondre à ce message
# Le 5 novembre 2017 à 16:30, par yann45
En réponse à : Facteur
Bonjour,
Petit soucis sur 2 de mes sites qui sont chez des hébergeurs différents. Alors que jusque là les messages fonctionnaient très bien, aujourd’hui impossible d’envoyer des messages depuis les sites et la fonction test de facteur (quelle que soit la config choisie php ou smtp) ne fonctionne pas et retourne des erreurs ou alors me dit que l’email test a été envoyé mais en fait on ne reçoit rien.
Je ne vois pas où est le problème.
SPIP 3.2, Escal v3.87.47, PHP 5.6.8 pour l’un et 5.4.45 pour l’autre
Yann
# Le 5 novembre 2017 à 19:05, par RastaPopoulos
En réponse à : Facteur
Mais « aujourd’hui » quoi ? Tu as fait des modifs entre temps ? Si le plugin n’a pas bougé, c’est que ça viendrait d’un autre changement ?
# Le 5 novembre 2017 à 19:13, par yann45
En réponse à : Facteur
Je n’ai fait aucune modification. Les seuls plugins qui ont étémis à jour sont : Agenda, Escal et Saisies. L’un de mes sites utilise la fonction mail de PHP. Quand j’utilise la fonction tester de facteur, 9a me dit que l’email est envoyé mais je ne reçois rien. Quand j’essaie sur le site public j’obtiens le message d’erreur : Erreur : à cause d’un problème technique, l’email ne peut pas être envoyé.
Pour l’autre site qui est chez un autre hébergeur, j’utilise SMTP. Le test dans facteur me donne le message : SMTP Error : The following recipients failed : webmestre45@free.fr : : Relay access denied
et en testant sur le site public j’obtiens : Erreur : à cause d’un problème technique, l’email ne peut pas être envoyé.
# Le 6 novembre 2017 à 09:35, par yann45
En réponse à : Facteur
Il me semblait qu’avant l’envoi du message il y avait une prévisualisation. Or je n’ai plus cette prévisualisation.
# Le 8 novembre 2017 à 22:26, par RastaPopoulos
En réponse à : Facteur
Bah ça ressemble plus à un problème SMTP chez ton prestataire.
Dans tous les cas, moi qui suis aussi chez Free, ya eu au moins 2j complet depuis le week-end avec des coupures complètes, aucun mail qui n’arrivent et parfois qui partent mais lentement.
# Le 9 novembre 2017 à 15:28, par yann45
En réponse à : Facteur
Bonjour,
Merci. Je me suis rapproché de mon prestataire et effet quelques règles avaient changé. J’ai donc paramétré en conséquence et tout fonctionne. Pour le second site qui est chez Free, je comprends mieux s’il y a eu 2 jours de coupure. Cela semble fonctionner de nouveau.
Répondre à ce message
# Le 6 novembre 2017 à 20:33, par yann45
En réponse à : Facteur
J’ai toujours des soucis avec l’envoi d’emails. Sur l’un des sites, j’ai désactivé tous les plugins non nécessaires et je n’ai laissé que ceux nécessaires aux emails (facteur, formulaires de contacts avancés, formidable. J’ai fait un test d’envoi à partir du site et j’ai été obligé de cliquer 3 fois avant d’obtenir le message d’envoi. Les 2 premières fois un message m’invitant à renouveler l’opération s’affichait. Je n’ai rien reçu dans la boîte mail, par contre le message est bien enregistré (3 fois) dans Spip. J’y perds mon latin.
Yann
Répondre à ce message
# Le 6 septembre 2017 à 12:27, par Observatoire Environnement Poitou-Charentes
En réponse à : Facteur
Bonjour et merci pour ce plugin,
Ce n’est pas une question mais une suggestion afin de rendre compatible le plugin pour les version 2.0,2.1 de SPIP avec PHP 7.
J’ai réussi à le faire fonctionner en remplaçant des fonctions qui n’existe plus dans /auto/facteur/phpmailer-php4/class.phpmailer.php :
- ligne 470 :
=>
- j’ai commenté les lignes 1217, 1218 et 1222 car tout ce qui magic quotes n’existe plus, il faudrait donc ajouter une condition selon la version de PHP
- ligne 1723 :
=>
# Le 25 septembre 2017 à 14:53, par Observatoire Environnement Poitou-Charentes
En réponse à : Facteur
En fait je me rend compte que ce n’est pas phpmailer-php4 qui doit être appelé mais phpmailer-php5.
Le problème vient de ces lignes dans classes/facteur.php :
Télécharger
Comme la version est 7 il va dans le else et charge phpmailer-php4...
# Le 25 septembre 2017 à 15:09, par Maïeul
En réponse à : Facteur
Merci,
corrigé.
https://zone.spip.org/trac/spip-zone/changeset/106412
Mais attention, il est pas certain que d’autres fonctionnalités de SPIP 2.1 soient compatibles PHP 7.
# Le 25 septembre 2017 à 15:34, par Observatoire Environnement Poitou-Charentes
En réponse à : Facteur
Merci.
Il me semblait que SPIP 2.1 était compatible avec PHP 7. En tout cas je n’ai pas eu de problème jusqu’ici.
# Le 25 septembre 2017 à 15:46, par RastaPopoulos
En réponse à : Facteur
Non 2.1 n’est pas du tout officiellement compatible PHP7, il n’y a aucune assurance que ça marche bien partout et que ça continue de marcher au fil du temps. Il était même question de créer une nouvelle branche 2.X dédiée pour assurer la compat PHP7, mais donc la 2.1 ne l’est pas même si certains trucs peuvent fonctionner. Le conseil est donc plutôt de rester sur un PHP5.X, et si on ne contrôle pas l’hébergement, le mieux (et dans tous les cas c’est le mieux) est de migrer vers SPIP 3.X.
# Le 25 septembre 2017 à 16:18, par Observatoire Environnement Poitou-Charentes
En réponse à : Facteur
Je m’étais référer à ce lien https://contrib.spip.net/SPIP-et-PHP7 qui sort en premier sur google avec la recherche « spip 2.1 php 7 » mais il semblerait qu’il s’agisse plutôt d’un brouillon.
Effectivement cette page https://www.spip.net/fr_article4351.html ne mentionne pas de compatibilité. Ceci dit ça tourne sans problème chez moi, c’est parfois les plugins qui peuvent poser problème.
Répondre à ce message
# Le 13 janvier 2017 à 10:52, par gillesq
En réponse à : Facteur
Bonjour,
J’ai un souci lors de la configuration de Facteur avec le smtp de Gandi en simple hosting, le nom d’hôte indiqué par Gandi : « ssl ://mail.gandi.net » est considéré comme n’étant "pas correct" par le formulaire.
Problème de fonction vérifier ou type d’adresse smtp non conforme au standards ?
# Le 13 janvier 2017 à 11:00, par RastaPopoulos
En réponse à : Facteur
Essaye plutôt de juste mettre le domaine, et de cocher que c’est en SSL.
# Le 13 janvier 2017 à 16:54, par gillesq
En réponse à : Facteur
Merci, ça a bien fonctionné.
# Le 21 juin 2017 à 11:35, par Fennec72
En réponse à : Facteur
gillesq, peux-tu me dire exactement quels réglages tu as mis pour le facteur ?
De mon côté j’ai fait de nombreux tests sans succès.
actuellement mon réglage est le suivant :
Hôte : gandi.net
Port : 465
Authentification : email complet + mot de passe
Connexion sécurisée : SSL
Validation : le certificat SSL du serveur SMTP est émis par une Autorité de Certification (recommandé).
avec comme hôte mail.gandi.net le résultat est le même :
« SMTP connect() failed. https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting »
Merci d’avance,
Hervé
Répondre à ce message
# Le 19 mai 2017 à 16:35, par Jul Blobul
En réponse à : Facteur
Bonjour,
Je viens demandé de l’aide à propos de ce plugin, que je connais très bien et utilise depuis quelque temps déjà sur plusieurs site couplé avec l’API Mailjet (pas de soucis avec Sparkpost par exemple)
Depuis trois jours, aucun emails ne partent lorsque je fais un envoi vers un destinataire unique en utilisant la fonction « newsletter_send_dist » issu du plugin Mailshot pour le plugin Newsletter.
Par exemple quand je veux m’envoyer une infolettre de test (Plugin Newsletter), un message vert me dit que « La newsletter a bien été envoyée à (mon email » mais le mail n’arrive plus chez Mailjet. Je trouve ensuite dans mes logs (mailshot_send.log) :
Erreur Envoi mail (mon email) via Facteur :
Je suis sous SPIP 3.0.24, tous les plugins à jour.
L’envoi sur une liste de diffusion fonctionne et les test d’envois via la page de configuration de Facteur fonctionne très également.
J’ai plusieurs sites impactés, j’utilise la fonction « newsletter_send_dist » dans plusieurs fonctions sur mes sites... autant dire que je suis dans la mouise :(
Je vous remercie par avance de vos lumières !
Jul
Répondre à ce message
# Le 19 avril 2017 à 14:27, par Pierrot
En réponse à : Facteur
Bonjour,
Je me demandais si quelqu’un avait déjà fait fonctionner Facteur avec MailJet ?
J’ai le cas d’un site ou l’envoi par Facteur+Mail() marche, l’envoi avec MailShot+MailJet marche, mais si j’essaye Facteur+MailJet, marche pas, avec les mêmes identifiants que dans MailShot ... J’ai essayé avec les ports 25, 465, 587 avec la sécurité correspondante ...
J’ai cette erreur qui vient de PHPMailer, c’est tout, spip me dit juste que Oups. Une erreur inattendue a empêché de soumettre le formulaire. Vous pouvez essayer à nouveau.
2017-04-19 13:56:33 92.154.37.49 (pid 13204) :Pri:ERREUR: parent::Send() : SMTP connect() failed. https://github.com/PHPMailer/PHPMailer/wiki/TroubleshootingÇa ressemble à une erreur d’authentification, mais bon, ça marche avec MailShot mais par l’API donc, bien qu’à priori les identifiants SMTP de MailJet soient identiques aux identifiants API. Au niveau domaine, SPF et DKIM, tout est ok bien sûr, ça marche avec MailShot.
Une idée ou je pourrai gratter pour identifier le souci ? et savoir si quelqu’un a déjà réussi Facteur+Mailjet serait intéressant.
Merci d’avance !
Pierre
# Le 19 avril 2017 à 14:32, par RastaPopoulos
En réponse à : Facteur
Ya pas un problème avec TLS/ancien SSL ? Jamais utilisé Mailjet par le SMTP directement donc je peux pas trop aider.
# Le 19 avril 2017 à 14:59, par Pierrot
En réponse à : Facteur
Ben j’ai essayé TLS/587, TLS/465, SSL/587, SSL/465 et même sans rien port 25, rien ne marche ... J’ai aussi testé CA officielle ou auto-signé (mais bon MailJet doit bien avoir un vrai certif SSL) ..
J’ai aussi testé directement depuis un client lourd (Thunderbird) avec ces identifiants SMTP, ça marche ... On dirait vraiment que c’est Facteur ou PHPMailer qui a un souci avec MailJet ...
Si quelqu’un d’autre a déjà fait ça, ce serait intéressant de le savoir :-)
Question annexe : MailShot utilise PHPMailer ?
PS : tout est à jour bien sûr.
# Le 20 avril 2017 à 11:55, par Peetdu
En réponse à : Facteur
Hello Pierrot,
je me suis confronté également à cette idée de Facteur + MailJet mais cela ne peut pas marcher en l’état.
Dixit la hotline de Mailjet : « Lа méthode d’authentification que nous proposons est uniquement via la clé API / la clé secrète » . Mailshot propose cette méthode d’authentification, mais pas Facteur
# Le 20 avril 2017 à 13:02, par pierrot
En réponse à : Facteur
Erational a répondu qu’il y arrivait (sur la liste Spip zone) mais moi non avec la même configuration (port 587 mais sans SSL ni TLS) ...
J’avais déjà lu la doc Mailjet et ça n’explique pas pourquoi j’y arrive avec Thunderbird qui fait du SMTP normal ...
# Le 27 avril 2017 à 17:44, par siromac
En réponse à : Facteur
Bonjour,
Je vois que je ne suis pas le seul !
Donc même problème avec le couple facteur/Mailjet.
Quand je fais tester un envoi , il me dit : « L’email de test a correctement été envoyé »
(SMTP correctement configuré avec leurs paramètres et le port 587 sans TSL/SSL).
Mais je ne reçois rien !
en PHP cela fonctionne normalement.
Heureux de vous lire.
# Le 28 avril 2017 à 17:25, par siromac
En réponse à : Facteur
Bjr !
En fait cela fonctionne si on n’oublie pas de déclarer le nom de domaine dans l’interface de Mailjet.
Ce que j’avais omis...
Méa Culpa donc
Et Merci Rasta et les autres pour votre excellent travail de dev pour Spip !
# Le 28 avril 2017 à 19:02, par Pierrot
En réponse à : Facteur
Quel hébergeur ? moi de mon côté j’ai bien le domaine de déclaré, mais marche pas. Il semble que ça marche chez OVH mais pas chez 1&1.
# Le 28 avril 2017 à 19:06, par siromac
En réponse à : Facteur
Je suis chez O2switch
Répondre à ce message
# Le 10 avril 2017 à 14:53, par Chrys
En réponse à : Facteur
Bonjour,
J’aimerais pouvoir appeler un fichier HTML qui est la réponse à un message envoyé via un formulaire spip (AR), je pense que c’est possible avec Facteur, mais je patauge…
J’aurais peut-être dû le faire ici, mais j’explique plus en détail mon souhait sur le forum, merci à vous.
# Le 10 avril 2017 à 15:10, par RastaPopoulos
En réponse à : Facteur
Un *fichier* comment ça un fichier ? On balance à Facteur un *contenu* HTML mais pas un fichier. Et toute la doc est juste au dessus, avec dans quelle clé du tableau d’options mettre le contenu HTML et le contenu texte brut. (Dans la clé… « html » tout simplement.)
À part ça je ne vois pas trop l’intérêt de réinventer la roue, en plus en surchargeant un formulaire de la dist et donc en perdant ses changements futures quand mise à jour (puisque ça utilisera ta version surchargée).
Il y a effectivement déjà des plugins qui font ça, dont Formidable qui permet en plus de personnaliser le contenu dans un squelette quand on veut pas ce qui est fournit par défaut. Donc sans rien avoir à bidouiller.
Répondre à ce message