SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

288 Plugins, 197 contribs sur SPIP-Zone, 203 visiteurs en ce moment

Accueil > Interactivité, échanges > Email, Newsletters, listes de diffusion > Newsletter > Mailshot

Mailshot

16 janvier 2013 – par Cerdic – 263 commentaires

37 votes

Ce plugin prend en charge l’envoi en nombre d’info-lettres par email.

Mailshot permet l’envoi en nombre d’emails au moyen d’un SMTP (ou d’un service externe) dédié à cet effet. Il permet de limiter la cadence d’envoi.

Enfin, ce plugin implémente la partie send de l’API Newsletter et peut donc être utilisé avec les plugins Mailsubscribers et Newsletters pour l’envoi de Newsletters.

La question du SPAM

Avant de décrire en détail le fonctionnement du plugin, il est important de souligner que l’envoi de mails en nombre est rendu de plus en plus difficile en raison de la prédominance du SPAM. Plus de 95% des emails qui circulent sur les serveurs de courriers sont du SPAM. Les opérateurs de mails (FAI, gmail...) sont donc de plus en plus stricts dans les règles de filtrage.

En tant qu’éditeur de contenu et utilisateur de ce plugin, vous avez une responsabilité : n’envoyer du contenu qu’à des utilisateurs qui l’ont sollicité par une demande explicite. Lorsque vous ne respectez pas cette règle, vous envoyez des emails non sollicités, c’est à dire du SPAM. Et vous contribuez à renforcer les règles de filtrage des opérateurs de mail.

Cette situation généralisée entraine bien des désagréments :

  • certains mails légitimes n’arrivent jamais à vos destinataires ;
  • en tant qu’expéditeur régulier vous risquez d’être blacklisté, voire votre serveur risque d’être blacklisté.

C’est pour cette raison que ce plugin ne permets pas d’envoyer des mails à l’aide de la fonction mail() de PHP. Cette fonction permet l’envoi simple de mail, mais elle passe par un canal partagé entre tous les sites hébergés par un serveur. Si vous l’utilisez à mauvais escient, c’est tous les autres utilisateurs qui seront pénalisés.

C’est également pour cette raison que ce plugin propose d’utiliser un service d’envoi de mail (serveur SMTP dédié, service externe commercial) spécifique à cet usage. Ainsi, même si vos envois en nombre déclenchent - à tort ou à raison - un filtrage chez les opérateurs de mail, le reste du fonctionnement du site n’en sera pas affecté (envoi des mails d’inscriptions, de formulaire de contact, de notification de forum, de pétitions...). Utilisez cette possibilité et protégez le fonctionnement quotidien de votre site web.

Installation

L’installation du plugin nécessite le plugin Facteur qui prend en charge l’envoi des mails à l’aide d’un serveur SMTP.

Configuration

La configuration du plugin concerne le service d’envoi qui sera utilisé pour les envois en nombre ainsi que les réglages d’expéditeur (nom et email) :
Configuration du plugin Mailshot

Service d’envoi

Le réglage par défaut est d’utiliser le même service d’envoi que pour les autres mails (soit le serveur de mail SMTP configuré dans le plugin Facteur). Ce réglage fonctionne mais n’est pas conseillé comme indiqué plus haut.
Si aucun serveur SMTP n’est configuré par défaut, le premier choix est désactivé comme ceci :

Cette fois vous n’y couperez pas : vous devez alors absolument choisir un autre service pour l’envoi de vos emails.

Vous pouvez configurer un serveur SMTP (celui qui gère les emails de votre nom de domaine, Gmail...) (assurez vous dans tous les cas qu’il accepte que vous passiez par lui pour cet usage) :

Sinon, et c’est la solution la plus fiable, il vaut mieux utiliser un service dédié à l’envoi de mails en nombre comme Mailjet [1], Sparkpost ou Mandrill [2] (disclaimer : l’auteur n’a aucun intérêt dans ces services commerciaux).

Le plugin propose aussi l’utilisation du service Mandrill, mais celui-ci est désormais soumis à l’utilisation d’un compte MailChimp payant, ce qui en restreint l’accès.

Cadence d’envoi

Dans tous les cas, que vous utilisiez un serveur SMTP ou un service externe, il est possible, voire probable, que vous soyez soumis à une cadence d’envoi maximale (nombre maximum de mails par quart-d’heure, par heure, par jour...). Dans ce cas là, convertissez cette cadence maximale en nombre de mail par jour et renseignez le champ Limiter la cadence d’envoi. La cadence sera prise en compte en espaçant l’envoi des mails de façon régulière pour ne pas dépasser cette moyenne journalière.

Envoi rapide

A contrario, si vous utilisez un service d’envoi capable d’envoyer très vite, ou de tout recevoir très vite et de mettre en attente les envois surnuméraires (c’est le cas de Mandrill notamment), vous pouvez activer l’option d’envoi rapide.

Quand cette option est cochée le plugin essaye d’envoyer aussi rapidement que possible à tous les destinataires. Notamment, en fonction du nombre d’envoi total à réaliser, il va lancer des processus parallèles pour accélérer le traitement, en étant capable par exemple d’envoyer 50 000 mails/heure si on a 200 000 destinataires.

Attention toutefois, envoyer rapidement un grand nombre de mails est une chose, mais il faut penser que cela va provoquer un pic de visites simultanées sur votre site, et que votre hébergement doit aussi être dimensionné pour absorber ce trafic supplémentaire.

Expéditeur

La dernière partie du formulaire permet de fixer les noms et emails de l’expéditeur qui apparaitra sur vos envois en nombre.

Historique des envois

Pour chaque envoi, le plugin conserve un historique de chaque adresse mail destinataire, date d’envoi, et statut (lu, cliqué, rejeté…) si il est récupéré depuis un service externe. Si vous envoyez beaucoup de lettres à beaucoup de destinataires, cela peut faire grossir la base de données de manière excessive, et dans ce cas il est préférable de purger les statistiques d’envoi pour les vieux envois.
Seul le détail des statistiques sera purgé, mais vous conserverez une statistique globale du nombre de mails reçus, lus, cliqués, rejetés…

Personnalisation du contenu des courriels

Avant chaque envoi d’un email, le plugin déclenche la personnalisation du mail à l’aide des variables qui décrivent le destinataire (voir Newsletters).
Les variables sont celles fournies par le plugin Mailsubscribers pour la description d’un inscrit :

  • email
  • nom
  • listes
  • lang
  • status
  • url_unsubscribe

Pour plus de détail, voir ce que retourne la methode newsletter/subscriber de l’API Newsletter.

Lors de l’envoi à un email unique qui n’est pas forcément inscrit, le plugin essaye de remplir au mieux les variables.

Envoi d’une Info-lettre

L’envoi d’une info-lettre se fait depuis la page d’administration de l’info-lettre, tel que décrit par Newsletters. Un formulaire d’envoi est disponible :

Si la première partie du formulaire sert à faire un envoi unitaire, c’est ici la seconde partie qui nous intéresse. En sélectionnant une liste d’inscrits, on peut déclencher l’envoi en masse à cette adresse en cliquant sur le bouton « Envoyer ! » en regard du selecteur :

On reçoit alors un message de confirmation du déclenchement de l’envoi, et l’envoi en cours apparaît en bas du formulaire. Un résumé de l’avancement apparaît (exprimé en nombre de mails envoyés par rapport nombre total de destinataires). Des boutons de contrôle permettent de mettre l’envoi en pause ou d’abandonner l’envoi.

Tant qu’un envoi est en cours, la liste est rafraichie toutes les 2minutes pour afficher la progression de l’envoi.

Suivi des envois de lot

Il est possible d’avoir une vision plus détaillée des envois de lot (passés en en cours). Pour cela, utilisez le menu Publication > Suivi des envois de mails en nombre. Vous accédez alors à une page qui récapitule les envois en cours et les envois terminés :

Les lots d’envoi en cours sont affichés d’une puce orange, les envois en pause d’une puce blanche, les envois terminés d’une puce verte et les envois abandonnés d’une puce rouge.

Si on clic sur le lien Envoi N°x d’un des envois, on arrive sur une page récapitulative complète qui expose la date et l’avancement de l’envoi, le contenu HTML et texte envoyé, ainsi que la liste des destinataires :

Les destinataires sont regroupés par statut (envoi à venir, envoi réussi, email ouvert, email cliqué, envoi échoué). Il est ainsi possible de retrouver si l’email a déjà été envoyé à un destinataire particulier, ou si il l’a ouvert, ou cliqué sur un lien [3].

Gestion des erreurs

Les envois échoués sont directement marqués en statut fail et ne sont pas relancés. Dans le cas d’un SMTP il pourrait être utile de faire plusieurs tentatives avant de déclarer l’envoi vers une adresse en echec (prise en compte des retry-later notamment). Dans le cas d’un service externe, c’est lui qui prend en compte la relance de cet essai.

La gestion des bounce est prise en charge avec le service Mandrill qui notifie en HTTP pour signaler quand un envoi a été rejeté. Dans le cas de l’envoi par SMTP on ne gère pas les bounce (l’API interne le permet au moyen de la fonction newsletter/feedback mais il faut implémenter la partie relève d’une boite mail qui sert à collecter les bounces).

En cas de non-déclenchement des envois :

Si l’envoi ne démarre pas ou met du temps, c’est parce que le cron de SPIP ne fonctionne pas ou pas assez souvent. Vous pouvez le forcer à la main en appelant l’url spip.php?action=cron mais en général c’est lié à un hebergeur qui bloque les appels http sortant, ou un site avec vraiment très peu de traffic.
Dans ce cas, un paliatif peut-être d’ajouter dans le fichier mes_options.php la ligne :
define('_HTML_BG_CRON_FORCE',true);

Migration depuis un ancien plugin

Lors de l’installation, le plugin regarde si les plugins SPIP-Listes ou SPIP-Lettre étaient auparavant utilisés. Si les tables correspondantes sont détectées, l’historique des envois (et des destinataires si possible) est automatiquement importé. Il contient naturellement le contenu HTML et Texte qui avait été envoyé.

Après avoir installé le plugin Mailshot et vérifié que toutes les anciens envois ont bien été importés, vous pouvez désinstaller votre ancien plugin pour supprimer ses données si vous le souhaitez.

Voir en ligne : http://plugins.spip.net/mailshot

Notes

[1pour bénéficier des fonctions de statistiques d’envoi au sein de SPIP, il faut utiliser l’API v3 de Mailjet

[2qui nécessite maintenant un compte Mailchimp payant

[3les fonctions de tracking sont implémentées avec les services Mailjet, Sparkpost et Mandrill

Dernière modification de cette page le 20 avril 2016

Retour en haut de la page

Tout afficher

Vos commentaires

  • Le 13 août à 09:04, par Francky En réponse à : Mailshot

    Hello cerdic :-)
    J’arrive pas à savoir la version de la lib que le plug utilise concernant sparkpost :-(
    Par contre, en lisant le change log, je viens de me rendre compte, qu’il faut au minimum php 5.5
    https://github.com/SparkPost/php-sparkpost/blob/master/CHANGELOG.md

    Donc, je propose de mettre dans paquet.xml :

    1. <necessite nom="php" compatibilite="[5.5.0;]" />

    Cela dit, c’est à réfléchir, car comme le plug est fait pour minimum spip 3.0.5, possible que cela posera des problèmes chez des utilisateurs...
    Sinon, le dire dans la doc de ton plug et de l’article d’érational concernant la configuration de Sparkpost ?
    Franck

    • Le 13 août à 17:00, par Maïeul En réponse à : Mailshot

      Il existe une syntaxe dans paquet.xml qui permet d’ajouter des balises interprétées uniquement pour certaines versions de SPIP.

    • Le 13 août à 17:20, par Francky En réponse à : Mailshot

      Ouiii, j’y pensais plus, merci Maieul :-)
      Cela dit, c’est pas forcément une bonne solution non plus, car en faite, spip 3.0 et 3.1 demande minimum php 5.1 quand à spip 3.2 c’est php 5.4, ce qui fait que, je ne peux pas me servir de cette astuce :-(
      Donc, soit, on touche à rien dans paquet.xml et c’est dans la doc du plug qu’il faut le dire, soit faut rendre le plug compatible pour php 5.4 minimum via un necessite.
      Je vais attendre la réponde de Cédric par principe, mais je pense que le mieux, c’est simplement de mettre à jour la doc :-)

    Répondre à ce message

  • Le 2 juin à 19:20, par ubiq En réponse à : Mailshot

    Bonjour à tous,
    J’utilise depuis quelques mois mailshot, en combinaison avec Newsletter et MailSubscribers + le service SparkPost pour l’envoi.
    Suite à une récente mise à jour, SPIP + tous mes plugins, mes Newsletters ne partent plus.
    Les tests fonctionnent, mais pas l’envoi vers les listes.
    En analysant les logs de SPIP, cela semble dû à l’erreur suivante :
    Au moment de l’envoi, Mailshot cherche à écrire en base la Newsletter et l’erreur « mysql : Unknown column ’from_name’ in ’field list’ » apparaît à ce moment-là.

    Il semblerait qu’il y ait 2 nouveaux champs dans la table Mailshots, et que ma méthode de mise à jour de plugin (simple remplacement de fichiers en FTP) n’ait pas créé ces champs.

    Que faire ? Désinstaller, puis ré-installer le plugin ? J’ai peur de perdre des données (mes anciennes Newsletters entre autres).
    Merci !

    • Le 2 juin à 19:50, par ubiq En réponse à : Mailshot

      Bon,
      Via PhpMyAdmin, j’ai modifié la structure de la table _mailshots, en rajoutant les 2 champs (après le champ listes) :
      from_name , text (type), utf8_general_ci (interclassement)
      from_email, text (type), utf8_general_ci (interclassement)

      Et depuis, tout est rentré dans l’ordre.
      Il semblerait donc que dans ses versions plus récentes, le plugin Mailshot ait besoin de 2 champs supplémentaires dans la table _mailshots pour fonctionner correctement.

    Répondre à ce message

  • Le 25 mai à 16:38, par Régis En réponse à : Mailshot

    Merci. J’ai configuré Mailshot correctement en cochant « utiliser le même service ... »
    Pour facteur, j’ai mis utiliser les réglages du site, utiliser SMTP, hôte in-v3.mailjet.com, port 587, authentification à « oui », nom utilisateur et mot de passe (clé API et clé secrète) fournis par mailjet comme paramètre SMTP, connexion sécurisée à « non », embarquer les images ...

    J’ai toujours le message « Oups. Une erreur inattendue a empêché de soumettre le formulaire. Vous pouvez essayer à nouveau. » en envoyant à 1 destinataire, et « envoi programmé » en envoyant à la liste des abonnés, mais rien n’arrive. Je ne sais que faire ...

    Répondre à ce message

  • Le 20 mai à 17:22, par régis En réponse à : Mailshot

    J’ai envoyé une infolettre par l’intermédiaire de Mailjet en renseignant soigneusement les codes API et pw.
    J’ai bien le message « La newsletter a bien été envoyée à (adresse de reception) », mais le message n’est pas reçu. Que faire ?

    Répondre à ce message

  • Le 19 mai à 21:43, par régis En réponse à : Mailshot

    en voulant envoyer une infolettre à 1 destinataire, j’ai le message :
    Oups. Une erreur inattendue a empêché de soumettre le formulaire. Vous pouvez essayer à nouveau.

    Je ne sais comment faire ... Est-ce le SMTP ?

    Répondre à ce message

  • Le 16 décembre 2016 à 13:20, par DD En réponse à : Mailshot

    Bonjour,
    Quelle est la tache cron qui permet de purger les détails des vieux envois ? J’ai coché Effacer le détail des anciens envois Plus vieux que 3 mois mais la table spip_mailshots_destinataires n’est pas purgée dans ma base. Merci

    • Le 28 mars à 21:04, par DD En réponse à : Mailshot

      Alors, est-ce que quelqu’un ici a compris le système d’archivage des envois ?
      J’ai mis « 3 mois » pour effacer le détail des anciens envois mais je me retrouve avec des dizaines de newsletters archivées de 2008 à 2015 et des dizaines d’autres de 2015 à septembre 2016 dans la partie « Envois terminés ».
      Les détails des envois dans les 2 cas semblent identiques.

      Quelqu’un peut-il m’expliquer comment purger par lot les envois supérieurs à 3 mois ?
      Merci

    Répondre à ce message

  • Le 23 février à 09:45, par jfg35 En réponse à : Mailshot

    Bonjour,
    Depuis environ un mois, lorsque je fais un test d’envoi de la newsletter, j’obtiens le message suivant « SMTP Error : Could not authenticate ».
    J’ai contacté le support de l’hébergeur, DRI, qui m’a assuré qu’il n’a fait de changement ni sur le serveur mail ni sur serveur web.
    D’ailleurs, les messages créés dans les boîtes email chez l’hébergeur sont bien envoyés et reçus.
    Avez-vous eu une idée d’où pourrait venir ce problème qui nous empêche d’envoyer les infolettres.
    Merci pour votre aide et tout le travail réalisé.

    • Le 23 février à 17:55, par Pierre KUHN En réponse à : Mailshot

      Bonjour,

      Le mot de passe est bien à jour ?
      Pas d’espace dans les renseignements du formulaire ?

    • Le 23 février à 19:28, par degom95 En réponse à : Mailshot

      Bonjour,
      Merci je regarde cela tout de suite.
      Bonne soirée.

    • Le 24 février à 18:24, par jfg35 En réponse à : Mailshot

      Bonsoir,
      Merci pour la réponse rapide.
      J’ai à nouveau vérifié les informations saisies mais elles sont bien identiques à celles qui existaient lorsque les infolettres pouvaient être envoyées.
      J’ai fait aujourd’hui un envoi d’email à une liste de diffusion avec les mêmes coordonnées et le message est bien parti et arrivé.

    Répondre à ce message

  • Le 7 février à 11:29, par degom95 En réponse à : Mailshot

    Bonjour,
    J’utilisais pour l’instant « Ma Lettre » pour envoyer des news, avec le plugin Facteur et une liste free sous ml.free.fr, cela fonctionne bien mais je dois modifier en dur le squelette pour avoir une lettre d’accompagnement.
    J’ai voulu utiliser newsletters, donc obligé d’installer les plugins mailsubscribers et mailshot et la ça se gâte, jusque l’a j’utilisait le service de mail standard php, free n’appréciant pas vraiment l’envoi en groupe, d’ou l’utilisation de la liste ml.
    mailshot ne me donne comme choix que d’utiliser une liste prédéfinie, mailjet, sparkpost, ..
    Y a t’il une solution et si oui, comment prendre en compte ma liste free ?
    Merci par avance de votre aide.
    j’utilise SPIP 3.0.22 avec Sarka-spip 3.2.36, serveur free avec base Mysql

    • Le 22 février à 22:03, par jfg35 En réponse à : Mailshot

      Bonsoir,
      Une suggestion : publier la newsletter puis « Envoyer à 1 personne » à l’adresse email, soit celle de la ml

    • Le 23 février à 11:05, par degom95 En réponse à : Mailshot

      Bonjour,
      Merci pour cette réponse.
      Je me suis résolu à utiliser ce moyen.
      Cependant il est dommage que la liste des ml soit fermée, il serait intéressant d’avoir la possibilité de paramétrer une ml autre (pour moi ml.free), peut être une évolution à venir ?

    • Le 23 février à 17:58, par Pierre KUHN En réponse à : Mailshot

      Bonsoir,

      C’est plus ce plugins a utiliser non https://contrib.spip.net/Abomailmans-pour-s-abonner-a-des-listes-de-diffusion ?
      Ou bien géré les abonnés dans SPIP.

    Répondre à ce message

  • Le 22 février à 23:08, par pamillet En réponse à : Mailshot

    bonsoir,

    utilisateur de mailshot avec sparkpost depuis pas mal de temps, et à vrai dire, ne regardant pas très souvent le détail du fonctionnement qui globalement... fonctionne !

    Je me lance dans un peu de purge des inscriptions et je constate des envois « échoués » par mailshot et qui sont en bounce ou generation rejection dans sparpost... alors qu’ils ne sont plus inscrits dans mailsubscribers...

    Autrement dit, mailshot prendrait qq part dans un cache des listes d’envoi anciennes...???

    Y-a-t-il qqchose à faire pour forcer la réinitialisation de mailshot...???

    merci d’avance
    pam

    • Le 22 février à 23:37, par Cerdic En réponse à : Mailshot

      C’est plus surement le contraire qui s’est produit : comme l’envoi à ces emails a été rejeté ou bloqué par SparkPost, mailshot a désinscrit l’adresse correspondante. Du coup il n’y aura plus d’envoi dans le futur.

    • Le 23 février à 08:40, par pamillet En réponse à : Mailshot

      Tu as sans doute raison, mais alors, elles sont plusieurs fois en échouées avant d’être désinscrits... et je n’arrive pas à comprendre... Je suppose qu’il y a une règle (au bout de 3 bounce ou peut-être au bout de n hardbounces et m softbounces" ?.. Quand je remonte dans l’historique des envois, je vois bien des adresses qui sont plusieurs fois dans échouées.. et qui sont aujourd’hui désinscrites...

      Est-il imaginable de trouver pour chaque adresse désinscrite la trace de ces envois et retours...?

      dans les logs bien sûr, mais on peut imaginer unepage ?

      merci en tout cas pour ces plugins...

      pam

    Répondre à ce message

  • Le 2 janvier à 08:00, par Spipmalion En réponse à : Mailshot

    Pour info : maj auto impossible pour mailshot, et DL du .zip = network error

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?
  • [Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Escal-V3

    16 février 2012 – 281 commentaires

    Un jeu de squelettes proposant un affichage en 2 ou 3 colonnes avec un large choix de noisettes à insérer ou pas, fortement paramétrable depuis l’espace privé . Présentation A l’instar de sa petite soeur plugin Escal-V2 dont elle reprend toutes (...)

  • GIS 4

    11 août 2012 – 1367 commentaires

    Présentation et nouveautés La version 4 de GIS abandonne la libraire Mapstraction au profit de Leaflet. Cette librairie permet de s’affranchir des librairies propriétaires tout en gardant les mêmes fonctionnalités, elle propose même de nouvelles (...)

  • FACD

    3 juin 2015 – commentaires

    FACD est l’acronyme de « File d’Attente de Conversion de Documents ». Comme son nom l’indique, il permet à des plugins dont le but est de convertir des documents dans d’autres formats de mettre ses conversions dans une file afin qu’elles soient (...)

  • CleverMail

    20 janvier 2010 – 637 commentaires

    CleverMail est un plugin permettant d’envoyer des lettres d’informations à des abonnés depuis SPIP. Issu au départ d’un développement libre complètement indépendant de SPIP, il a connu une première version pour SPIP 1.9 avant d’être complètement réécris (...)

  • Massicot

    7 octobre 2015 – 74 commentaires

    Recadrez et redimensionnez vos images directement dans l’espace privé de SPIP ! Inspiré par le plugin photospip, ce plugin plus minimaliste permet de recadrer et redimensionner les images dans l’espace privé de SPIP. Une fois le plugin installé (...)

Ça spipe par là