Important !
A partir de la version 4.3.0 si vous utilisez un fournisseur commercial pour l’envoi des mails (Mailjet, Sendinblue, Mandrill) vous devez installer en plus le plugin Mailshot pour conserver votre fournisseur d’envoi !
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 = array(
'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
);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
Discussions par date d’activité
144 discussions
Bonjour suite aux mises-à-jour de différents plugins, j’ai l’erreur suivante :
Warning : include_once(/var/www/vhosts/frsel.be/httpdocs/ecrire/../plugins/auto/facteur/phpmailer-php5/class.phpmailer.php) [function.include-once] : failed to open stream : Permission denied in /var/www/vhosts/frsel.be/httpdocs/ecrire/inc/utils.php on line 969
Warning : include_once() [function.include] : Failed opening ’/var/www/vhosts/frsel.be/httpdocs/ecrire/../plugins/auto/facteur/phpmailer-php5/class.phpmailer.php’ for inclusion (include_path=’. :’) in /var/www/vhosts/frsel.be/httpdocs/ecrire/inc/utils.php on line 969
Fatal error : Class ’PHPMailer’ not found in /var/www/vhosts/frsel.be/httpdocs/plugins/auto/facteur/classes/facteur.php on line 22
visiblement des probèmes de droits d’accès sur les fichiers. Essai avec un client ftp de les régler à 755
Merci Maïeul,
Quels fichiers ou dossiers dois-je modifier les droits ?
le fichier
plugins/auto/facteur/phpmailer-php5/class.phpmailer.phpSuper, merci, cela fonctionne !!
Répondre à ce message
Bonjour,
J’utilisai Facteur avec la version Spip précédent la 3.0.17 avec facteur 2.4.5 et la ligne :
[<img src="#URL_SITE_SPIP/(#LOGO_ARTICLE|top|right|image_reduire{100,}|extraire_attribut{src})">]Cela me donnait :
<img src="http://www.golias-editions.fr/local/cache-vignettes/L72xH100/arton5225-4d7ff.png">Mais maintenant avec spip 3.0.17 et facteur 3.0.13 j’ai :
<img src="cid:0b2e77c444267ed6ca77e1a52cb74f19">Le courriel envoyé possède bien les images MAIS en pièces jointes et elle ne sont plus disponible dans le texte.
Comment retrouver les bonnes adresses des images ?
Merci Alain
Bonjour,
Je me réponds à moi même,
Il suffisait de décocher embarquer les images ... dans le pavés filtre de la configuration de facteur ! :
Et ça marche bien. MErci aux concepteurs. Alain
Répondre à ce message
Bonjour
J’en perds mon latin et j’appelle au secours.
J’ai installé le plugin facteur. Sans souci. Quand je veux faire un test avec la fontction phpo il ne se passe rien. Enfin le truc se met en arrière plan, je ne peux plus toucher aux paramètres du module et le déboggage (couteau suisse) me donne cela :
Je ne recois pas de courriel !!
Comme expliqué dans « Les choses à faire avant… », pour tester un plugin, la première chose à faire est de désactiver tous les plugins non nécessaires à son activation. Ensuite il est préférable d’activer l’affichage des erreurs PHP, comme expliqué ici :
http://www.spip.net/fr_article4453.html#infos_plus
Répondre à ce message
Bonjour,
Partisan de la sobriété, je recherche le moyen de de forcer le « mode texte » pour chaque mail envoyer par facteur. J’ai bien tenter de surcharger et modifier /emails/texte.html mais le résultat est loin d’être propre (des balises html apparaissent toujours dans le corps du message). Merci pour vos réponses.
Juste avec un squelette je ne sais pas. Je me dis que ça devrait plutôt être une option dans la config de Facteur… Faudrait que je vois avec Cédric qui avait ajouté ce « wrapper » HTML quand l’email de base n’est qu’un texte brut.
Merci Rasta, j’explore cette voie mais si Cédric possède l’astuce, qu’il n’hésite pas à nous en faire profiter ;)
Répondre à ce message
bonjour
je teste ce squelette (sous spip 3) et je rencontre quelques soucis. la fonction d’envoi de mails est ok via fonction mail mais dès que je configure la fonction smtp (afin d’utiliser mailshot en aval), je ne peux pas envoyer de mails (Erreur : consultez le fichier log pour plus de détails... fichier log que je ne trouve pas lol).
mon site est hébergé sur des pages personnelles de free, et que j’utilise le smtp de free (avec port, login et mot de passe), celui de gmail (avec un compte gmail) ou celui de hotmail (smtp.live.com), avec les choix de connexion sécurisée ou non, j’ai toujours la même erreur (sans trouver le log associé malheureusement).
J’avoue, je sèche... Le problème vient peut-être de Free, mais avant de créer le site avec un hébergeur officiel, je voudrai en être sûr.
quels tests je pourrais faire ou comment je pourrais régler mon souci. J’ai bien vu que le souci était déjà mentionné avec un hébergement sur web4all, j’espère qu’il existe aussi une solution pour moi.
Merci pour votre aide
re bonsoir
j’essaye de poursuivre mes investigations et j’ai pu configurer le smtp de free sur un outlook express et envoyer des mails.
je reporte la même conf sur le plugin facteur, ça ne marche pas (même en désactivant le plugin mailshot).
j’ai du mal à comprendre mon souci
merci pour votre aide
Chez-moi-ça-marche. © :-(
T’as testé en désinstallant tout autre plugin pour être sûr de n’avoir aucun conflit et ne tester que celui là ? Les fichiers de logs sont dans tmp/log.
merci pour ce retour rastapopulos.
oui j’avais désactivé mailshot avant un des tests. par contre je n’avais pas désactivé newsletter et mailsubscribers mais je peux tester.
Au niveau des logs, j’ai ceux de spip et mailshot mais pas d’autres et après mes tests sur facteur, aucun rafraîchissement de logs, il n’y a qu’en testant mailshot que je peux avori des logs.
Je vais aussi tenter de réinstaller le plugin facteur, le tester, avant de rajouter les autres un par un en testant facteur à chaque fois. je te tiens au courant (ps en version spip j’utilise spip 3 et le squelette viaspip)
bonsoir
j’ai retesté et même résultat...
j’ai supprimé chaque plugin sur l’administration de spip et répertoire en ftp, j’ai juste remis le plugin facteur. Envoi Email php OK mais dès que je configure un smtp ça ne marche pas (j’ai pourtant activé mon smtp de free sur la gestion de l’email). si je teste avec un autre smtp (hotmail par exemple) pareil je ne passe pas, quelque ce soit le port et la connexion sécurisée (avec un compte existant bien sûr). Et toujours pas de log dans /tmp/log.
mais bon avec free peut-être normal, c’est mentionné pour le plugin mailshot. Il n’y a pas de raison que ça ne marche pas quand j’hébergerais mon site sur ovh...
Merci encore pour l’aide
Bonjour
Je ne pige plus, j’ai décidé d’héberger mon site sur 000webhost.com (en pensant que free me bloquait tout), et idem, autant l’envoi de mail par la fonction php est OK, autant l’envoi de mail en smtp ne fonctionne pas. Et pas de logs pour me dire quoi que ce soit.
Soit j’oublie une option, soit je configure mal, soit je suis maudit, soit chaque hébergeur gratuit que je prends me bloque cette fonctionnalité...
En exemple de configuration smtp, j’ai pris mon compte gmail (smpt.gmail.com, avec le port 465, mon adresse mail complète, mon mot de passe, connexion ssl coché, aucun filtre ni adresse mail de copie).
Si quelqu’un peut m’aider je suis preneur, merci !
Oui Free bloque les envois par SMTP externe et les requetes http externes, et il y a des chances que ce soit le cas de la plupart des hébergeurs gratuits, pour éviter d’être utilisés par les spammeurs.
merci pour ton retour
c’est vraiment ma veine lol...
Répondre à ce message
Problème sur la version 3.0.10.
Si j’envoie un mail de test, le mail n’arrive pas en html, mais un mail avec un corps avec la partie texte et la partie html apparentes. Du coup je pense que cela doit être la même chose pour les formulaires et je suis repassé en 3.0.8.
D’ailleurs en mutu chez OVH, rien n’arrive pour le mail de test.
Les mails fonctionnent sur les formulaires de « Formidable ». C’est juste sur le mail de test qu’il y a un problème.
Non le bug est aussi dans les envois automatiques notamment avec le plugin COPIE en articles des Flux RSS !
Apparemment le bug est dans le séparateur dans le mail avec la balise de séparation :
boundary=...
Pas sûr mais probable !!
Bonjour,
il faut commenter cela , headers :
http://zone.spip.org/trac/spip-zone/changeset/82933/_plugins_/facteur
Je complète ma réponse pour le rechercheur de BUG !!!
Il y a bien les mots : Version texte
Mais il n’y a pas d’indication de Version HTML juste une série de « - » après la version texte et hop çà continue avec le code (non interprété) HTML
Merci Jacot mais que faut-il faire commenter complètement la partie indiquée ?
oui, c’est le patch entre la 3.0.9 et la 3.0.10 qui fait cela.
La version 3.0.11 corrige le bug, désolé de l’erreur :) !
Impec tout à l’air rentré dans l’ordre !! Bravo pour cette réactivité ... Vu l’utilisation massive de Facteur !!! C’est une bonne chose chose, merci !!
Répondre à ce message
Bonjour,
J’utilise le formulaire de contact avancé avec le plugin Facteur. Merci pour ces outils bien pratiques !
Petite question : dans le mail généré, les champs d’identification sont en une ligne et collés les uns aux autres, ce qui n’est ni très joli ni très lisibles. Pour être très claire, voici comment ça se présente :
Civilité : monsieurPrénom : JeanNom : DupontOrganisation : MachinInfolettre : oui
Comment puis-je résoudre ça ? J’ai regardé le fichier texte.html (je suppose que c’est lui qu’il faut modifier) mais je n’en comprends pas trop le code donc je n’arrive pas à l’adapter.
[(#ENV*{html,#ENV*{texte}|replace{'<','<'}|facteur_nl2br_si_pas_autobr|propre|replace{'<br />\s*<br />(\s*<br />)+?','<br /> <br />'}|concat{'<br /> <br />'}})]D’avance merci de vos réponses.
Encore moi,
J’ai encore cherché sans trouver la solution. Est-ce que je cherche dans le bon fichier ou bien faut-il introduire les modifs dans un PHP en amont, soit de Facteur, soit de Formulaire avancé ?
J’aimerais aussi (et c’est le plus important) que la mention « Ce message est enregistré sur votre site : http://www.monsite.tld/ecrire/?exec=message&id_message=x » n’apparaisse pas dans le mail généré. Comment faire ?
Pour le second point c’est dans le « wrapper » HTML ajouté par facteur, dans texte.html donc. En bas L92 :
http://zone.spip.org/trac/spip-zone/browser/_plugins_/facteur/trunk/emails/texte.html#L92
Pour le premier point pour l’instant je ne vois pas, je n’ai jamais rencontré cet affichage tout collé en une ligne.
Bonsoir et merci de ta réponse, Rastapopoulos.
En fait, pour le 1er point, nous avions continué cet échange sur le plugin du formulaire avancé, où d’autres utilisateurs relataient le même problème : contrib.spip.net/Formulaire-de-contact-avance ?lang=fr#forum467797.
J’avais fini par trouver le responsable de l’affichage « tout collé » : c’est enluminure typographique.
Sur ton conseil, j’ai posé la question sur le forum du plugin : http://contrib.spip.net/Enluminures-typographiques-V3-pour-SPIP-2-avec?lang=fr#forum474561
Malheureusement, je n’ai pas eu de réponse de RealET. N’ayant pas trouvé la solution de mon côté, je suis toujours avec mon problème sur les bras. :-(
Répondre à ce message
Bonjour,
J’essaie d’envoyer une page html en pièce jointe, mais ça ne marche pas...
Le mail est bien envoyé, mais sans pièce jointe...
Voici mon code :
Une piste ?
Merci d’avance de votre aide !
Je ne sais pas précisément, s’il n’y a pas de message d’erreur, mais en tout cas ce n’est pas un type Mime existant. Ça devrait être « text/html » ou « text/xml ».
Merci de ta réponse, mais ça marche pas...
Ca ne marche pas non plus avec une image...
Pour info, voici mon code :
Je refais un test ce soir sur un autre serveur...
Le chemin du fichier doit-être le chemin au sens file system, pas une URL http du fichier. Si ton fichier est distant, il faut d’abord le rapatrier sur ton site.
Je crois que c’est le chemin qui ne va pas. Tu dois mettre le chemin d’un fichier que PHP va pouvoir récupérer sur ton serveur, par un URL !
Cf http://zone.spip.org/trac/spip-zone/browser/_plugins_/facteur/trunk/inc/envoyer_mail.php#L30
« chemin file system pour trouver le fichier a embarquer »
Ah bah synchro, on a posté à quelques secondes d’intervalle. :)
Merci de vos réponse ! En effet, c’est assez logique ! Le système joindre la pièce au mail et c’est pas un lien vers le site comme pour une image dans une newsletter...
Je test dès que possible !
Encore merci !
Répondre à ce message
Bonjour,
j’ai aussi un problème de configuration de SMTP
J’arrive bien à le configurer dans MailShot, donc mes envoyes de newsletter fonctionnent et je n’ai pas besoin de la configuration dans facteur, mais je voulais quand le même signaler ici :
Dans le champs Hôte je met « smtp.monmail.be » et facteur me dis « Ce nom d’hôte n’est pas correct ».
Quand je ne met que « monmail.be » plus de message d’erreur de la part du facteur, mais l’envoy de test ne fonctionne pas.
Dans MailShot la configuration fonctionne bien avec « smtp.monmail.be ».
Je ne sais pas pourquoi..
Voila mon petit bug
à bientôt
joz
est-ce que ton champs Hôte c’est par exemple « smtp.free.fr » ou bien du type « smtp.identifiant.fr » ou identifiant est ton identifiant de messagerie (ton nom, ton pseudo ou ce que tu veux) ?
parce que quand je mets smtp.free.fr dans ce champs Hôte de Facteur, il ne m’indique pas d’erreur.
En revanche (et c’est malheureux), c’est ensuite que ça se gate, lorsque je teste la configuration (partie basse de la fenêtre, avec le bouton « tester ») : j’ai un msg qui s’affiche « Erreur : consultez le fichier log pour plus de détails »
et le fichier log... je ne le vois pas (j’ai vu qu’il y a des fichier dans /SPIP/tmp/log, mais je ne trouve pas trace de la tentative d’envoi que je viens de faire)
Bref, je n’arrive pas à envoyer mes mails par SMTP (pas de soucis avec PHP)...
Comme ça a l’air de marcher pour toi, peux-tu me dire quelles sont les valeurs que tu mets dans les champs
Hôte :
Port :
Requiert une authentification : non/oui
...
Connexion sécurisée : non/SSL/TLS
Merci de ta réponse.
bon, en fait j’ai trouvé en relisant les commentaires depuis le début (ça fait un paquet !) et j’ai trouvé qu’il fallait "laisser vide le champ »Retour des erreurs"
Comme quoi, c’est tout simple, mais ça va mieux en le lisant !
Répondre à ce message
Salut Rastapopoulos :-)
j’ai un problème avec facteur :-(
Question 1 sous SPIP 3.0.16 [21266] avec facteur 3.0.7
C’est normal qu’il n’y a pas de logs quand un envoi est réussi, indiquant que justement, l’envoi est bien partie ?
Question 2 toujours concernant les logs
Si je ne configure pas correctement le plug concernant ssl ou autre et que je fais un test, l’envoi ne fonctionne pas (normal)
Par contre, j’ai un message du type « Erreur : consultez le fichier log pour plus de détails »
Le problème, c’est qu’il n’y aucun logs.... Normal aussi ?
Répondre à ce message
Ajouter un commentaire
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.
Suivre les commentaires :
|
