Mailsubscribers permet de gérer les inscriptions par Opt-in simple ou double et la désinscription par URL. Ce plugin gère également plusieurs listes de diffusion (simplifiées) permettant de cibler des listes d’inscrits au cas par cas dans les envois en nombre par courrier électronique.
Pour les développeurs, ce plugin implémente la partie subscribe de l’API Newsletter et peut donc être utilisé avec les plugins Newsletters et Mailshot pour l’envoi de Newsletters.
Installation
Le plugin s’installe classiquement, et ne nécessite pas d’autre plugin pour fonctionner. Cependant, si vous souhaitez importer et exporter des listes d’abonnés au format CSV, vous devrez installer le plugin complémentaire SPIP Bonux.
Configuration
Vous pouvez configurer ce plugin pour l’adapter à vos besoins.
Opt-in
Vous pouvez choisir le fonctionnement en simple Opt-in ou double Opt-in :
- en simple opt-in : il suffit pour s’inscrire que la personne renseigne son email dans un formulaire d’inscription explicitement dédié à l’envoi d’informations par mail, ou qu’il coche une case « je veux m’inscrire à la Newsletter » dans un autre formulaire (inscription comme redacteur dans le site par exemple) ;
- en double opt-in : l’inscription est mise en attente suite à cette première étape, et un email est envoyé sur l’adresse courriel renseignée, demandant de cliquer sur un lien pour confirmer l’inscription. Il y a donc une étape de vérification.
Le mode double opt-in permet d’avoir une base d’inscrits de meilleure qualité. Il évite les inscriptions forcées, pour le compte d’autrui, ainsi que d’inscrire une adresse email erronée (faute de frappe). Ce mode est nécessaire dans certain pays pour être en accord avec la loi. En France le simple opt-in suffit, mais il est recommandé d’utiliser le double opt-in.
Inscription à la Newsletter lors de l’inscription au site
Si vous activez cette option, une case à cocher sera automatiquement ajoutée sur le formulaire d’inscription au site pour permettre l’inscription à la Newsletter en même temps.
Listes de diffusion
Pour chaque liste, indiquez un identifiant (lettres et chiffres uniquement) ainsi qu’un libellé explicite. Vous pouvez a posteriori fermer une liste : dans ce cas il n’est plus possible de s’y inscrire, mais vous conservez tout de même la liste des inscrits en base de donnée.
Par défaut, il n’y a qu’une liste de diffusion disponible, avec l’identifiant newsletter.
Listes de diffusion automatiques
Il est possible d’avoir des listes de diffusion dont les abonnés sont automatiquement synchronisées avec d’autres tables ou même d’autres bases [1]. Le plugin permet par exemple de créer les listes automatiques des Administrateurs, des Rédacteurs et des Visiteurs du site.
Si vous cochez la liste des Administrateurs en Enregistrez, elle apparaîtra avec une mention précisant que cette liste est synchronisée automatiquement. Si vous rafraichissez la page quelque minutes plus tard (ce n’est pas immédiat car la synchronisation est faite en tache de fond), le nombre d’abonnés apparaitra.
Vous pouvez aussi définir votre propre liste automatique synchronisée. Pour cela, créez la liste avec un identifiant et un nom qui vous conviennent, puis ajoutez dans votre fichier mes_fonctions.php la fonction mailsubscribers_synchro_list_newsletter_xxx() que vous aurez créé (en remplaçant xxx par l’identifiant de votre liste).
Cette fonction devra retourner un tableau d’abonnés, chacun étant décrit par un tableau avec
- l’entrée obligatoire email
- les entrées facultatives nom et prenom.
Ces données peuvent venir aussi bien d’une table SQL, d’un fichier texte, CSV, d’une autre base de donnée…
Le plugin synchronisera alors automatiquement 1 fois par jour les abonnés avec la liste fournie par votre fonction, et vous pourrez envoyer des Infolettres sur ces listes toujours à jour.
Inscription-désinscription sur le site public
Le plugin ne propose par défaut aucune page d’inscription pour le site public. Vous devez ajouter le formulaire d’inscription et désinscription dans votre squelette.
Formulaire d’inscription
Vous pouvez insérer simplement le formulaire d’inscription dans votre squelette avec la balise #FORMULAIRE_NEWSLETTER_SUBSCRIBE. L’inscription se fera sur la liste par défaut newsletter.
Le formulaire est volontairement le plus simple possible se limitant à un label et un champ de saisie (automatiquement rempli par l’adresse email du visiteur si identifié). Cela vous permet d’ajouter un titre à votre guise. Vous pouvez modifier le libellé du bouton en personnalisant la chaine de langue bouton_subscribe.
Pour proposer l’inscription sur une autre liste ou plusieurs listes, indiquez l’identifiant de la ou les listes en argument de la balise, séparés par une virgule. Les paramètres à passer doivent être entre guillemets. Par exemple :
#FORMULAIRE_NEWSLETTER_SUBSCRIBE{
"newsletter,nouveautes",
"checklist" }Lors de son inscription, l’internaute reçoit un email d’information (ou de confirmation si double opt-in).
Comme pour tous les formulaires, il est possible d’insérer le formulaire d’inscription à l’intérieur du texte d’un article, plutôt que dans un squelette, au moyen de l’appel de modèle suivant :
<formulaire|newsletter_subscribe|listes=liste1| ... >
Formulaire de désinscription
Comme pour le formulaire d’inscription, le formulaire de désinscription s’insère avec #FORMULAIRE_NEWSLETTER_UNSUBSCRIBE. Vous pouvez indiquer la ou les listes concernées en argument : #FORMULAIRE_NEWSLETTER_UNSUBSCRIBE{"newsletter,nouveautes"}
Vous pouvez modifier le libellé du bouton en personalisant la chaine de langue bouton_unsubscribe.
Lors de sa désinscription, l’internaute reçoit un email d’information. Si il n’est plus abonné à aucune liste, son adresse email est obfusquée, transformée en md5 de son email avec le domaine @example.org. Cela permet de préserver l’anonymat des désinscrit, mais de les garder en base pour éviter de les réinscrire par erreur en cas d’import d’adresses par exemple.
Administration des inscrits
Liste des inscrits
La liste des inscrits est disponible dans l’espace privé, depuis le menu Activité > Inscrits aux envois par email
Inscription
Vous pouvez inscrire une adresse email manuellement depuis l’espace privé en sélectionnant « Ajouter une inscription ».
Vous devrez renseigner a minima l’adresse email et une liste de diffusion. L’inscrit sera par défaut « pas inscrit » et vous devrez modifier son statut pour l’inscrire réellement.
Lorsque vous modifiez le statut par ce formulaire d’édition, aucun courriel de notification n’est envoyé à l’adresse email concernée.
En revanche, dans tous les autres cas l’inscrit recevra automatiquement sur son adresse courriel un email de vérification quand vous lui mettez le statut « à confirmer », et un email d’information si vous lui mettez le statut « abonné ». De même si vous le passez ensuite en « désabonné » un email d’information sera à nouveau envoyé. C’est par exemple le cas quand vous modifiez le statut de l’inscrit par le formulaire de changement dédié à cet effet :
Export des inscrits [2]
Vous pouvez télécharger la liste des inscrits ou de toutes les adresses (y compris les inscrits en attente ou les désinscrits [3]) au format CSV. Chaque colonne correspond à un champ de la table.
Import des inscrits [4]
Vous pouvez importer une liste d’adresse mail à inscrire. Un fichier CSV est attendu, avec en première ligne le nom des champs, selon le même format que celui fournit en export. Si le fichier ne comporte qu’une seule colonne, il sera supposé que ce sont des emails. Cela vous permet d’importer des fichiers textes avec une adresse email par ligne comme les fichiers d’export générés par SPIP-Listes.
Si votre fichier d’import contient une colonne statut, les adresses prendront automatiquement le statut fixé par le fichier. Un email de confirmation ou d’information sera envoyé à chaque adresse importée (sauf si vous cochez l’option pour ne pas notifier lors de l’import).
Si votre fichier d’import ne contient pas de colonne statut, les adresses seront automatiquement inscrites (directement ou via un mail de confirmation selon le réglage de votre opt-in). Cependant, les adresses emails correspondant à des personnes désinscrites ne seront pas ré-inscrites.
Après sélection d’un fichier, le formulaire vous montre une prévisualisation de l’interprétation des données sur les premières lignes du fichier, et vous pouvez lancer l’import si cela vous convient. A cette étape, vous pouvez préciser que cet import doit se faire sans notification des inscrits [5], ou aussi que vous voulez vider la table avant l’import (cas de la mise à jour complète de votre base par un fichier CSV). Cette dernière option ne vous est proposée que si vous êtes webmestre.
Traçabilité des inscriptions
À chaque fois qu’une adresse email est inscrite ou désinscrite, cela provoque l’enregistrement d’une trace dans le champ optin de l’adresse email correspondante. La trace sera enregistrée que l’inscription se fasse sur le site public, ou par un administrateur dans le back-office, ou même par un import de fichier.
La trace contient la date et l’heure de la modification ainsi que les éléments d’identification de la personne qui a réalisé l’action (adresse IP si la personne n’est pas identifiée, ou id_auteur et nom de l’administrateur SPIP).
Le champ optin qui garde cette trace n’est pas éditable, et peut donc être opposé comme justificatif si une personne manifeste sa désapprobation d’avoir été inscrite à son insu (à tort ou à raison).
Newsletter : confirmation d’inscription / reconsentement
Il est possible d’envoyer un message aux abonnées n’ayant pas ouvert un seul mail depuis 1 an afin de leur demander de confirmer explicitement leur inscription et ainsi éviter de continuer à envoyer des newsletters à des gens qui ne les ouvrent pas.
Cela s’appuie sur les statistiques des prestataires d’envois des mails ; cela ne fonctionnera donc pas avec un envoi via SMTP, qui n’obtient pas ces informations.
Envoyer le mail
Dans le menu Activité > Listes de diffusion, cliquer sur « Accéder à la gestion d’opt-in ».
Choisir une liste de diffusion pour afficher les adresses qui n’ont pas ouvert de mail ainsi que celles qui ont ouvert mais pas cliqué de liens dedans.
Il possible d’envoyer manuellement, liste par liste, un mail de confirmation à ces adresses.
Ce mail offre le choix de rester abonner ou de se désabonner.
Sans confirmation explicite après 7 jours, les adresses sont automatiquement désabonnées.
Migration depuis un ancien plugin
Si vous utilisiez auparavant l’un des plugins SPIP-Listes, SPIP-Lettres, CleverMail ou MesAbonnés, les inscrits seront automatiquement importés lors de l’installation de MailSubscribers (dans le cas des plugins SPIP-Lettres et CleverMail, les désinscrits sont aussi importés).
Pour cela vous devez avoir encore les tables de ces plugins dans votre base de données. Il vous faut donc désactiver votre ancien plugin, mais surtout ne pas le désinstaller car cela supprime les données.
Après avoir installé le plugin et vérifié que toutes les adresses ont bien été importées, vous pouvez désinstaller votre ancien plugin pour supprimer ses données si vous le souhaitez.
Discussions par date d’activité
218 discussions
Bonjour,
Je viens d’installer la dernière version du plugin sur un spip 3.2.1 et j’ai maintenant deux erreurs dans la page « Inscrits aux envois par email » (exec=mailsubscribers) :
Je ne comprends pas pourquoi ces critères posent problème, d’autant qu’ils sont facultatifs dans la boucle incriminée (avec le ?). J’ai vidé le cache et réessayer d’installer le plugin mais rien n’y fait.
SI quelqu’un a une piste, je suis preneuse.
Problème résolu en ajoutant clés primaires dans la table spip_mailsubscriptions :
Répondre à ce message
Bonjour,
Quand un lecteur souhaite s’abonner à la newsletter, il remplit un formulaire très simplifié limité à un label et son champ de saisie « email » (automatiquement rempli par l’adresse courriel du visiteur si le site procède aux inscriptions avec identifications)
Dans la liste « Inscrits aux envois par email » qui comprend par fiche 4 champs apparents pour chaque visiteur inscrit (coté privé), dont seulement 3 se remplissent et le champ « Nom » reste vide, car il n’est pas demandé au lecteur souhaitant s’abonner à la newsletter de le remplir :
Comment ajouter un champ de saisie du Nom et son label dans le formulaire « inscription à la newsletter » sans avoir besoin d’installer un plugin de questionnaire ou de champ supplémentaire, car le champ @nom@ existe déjà ?
Merci pour toutes les solutions simples.
Répondre à ce message
Bonjour,
installation d’un spip 3.2 tout neuf, du plugin Facteur à jour 3.5.1... Mais Mailsubscriber est impossible à installer car il demande une version du Facteur introuvable, la 3.5.2.
Un problème d’écriture du paquet ? Ou bien ?
La version de 3.5.2 est disponible depuis cette nuit. La page https://plugins.spip.net/facteur n’était pas à jour, mais tu peux bien le telecharger là.
Si tu utilise l’installation automatique, il se peut que le cron qui vérifie les information sur les versions des plugin disponible ne soit pas en core passé.
Tu peux aller dans maintenance>liste des travaux> et executer « svp_actualiser_depots »
Ok merci :) Voila faut 10 caractères...
Répondre à ce message
bonjour
y a t-il un moyen de désabonner « en masse » des adresses mails ? par exemple avec un fichier csv ou autre.
merci d’avance
je réponds à ma question si ça interesse quelqu’un :
en iportant un fichier csv par le champ d’import, et ce fichier csv doit comporter une colonne statut qui indiquera « valide » ou « invalide », ainsi que le nom de la newsletter en question.
Répondre à ce message
Hello,
Après passage en 3.2, les mails de confirmation ont un bug sur le HTML
Mail reçu :
En faisant le test de mail accentué du plugin facteur, aucun problème.
Pareil. Mise à jour du site en spip 3.2, et paf, les liens de confirmation dans les mails sont horribles :
Très embêtant... les auteurs du plugin vont-ils intervenir très vite ou bien on doit aller à la pêche dans le php ?
Merci de votre aide.
C’est en fait un problème du plugin FACTEUR.
Fichier /facteur/emails/inc-button.html
Ce sont les protections anti XSS ajoutées dans Spip 3.2 qui se déclenchent ici. Il faut voir comment éviter ça.
Les auteurs du plugin vont regarder comment trouver une solution propre, en fonction de leur disponibilité.
Ok. Ça se passe dans les squelettes de
notifications/Les écritures suivantes envoient un contenu HTML en paramètre d’une chaîne de langue (HTML provenant de l’inclusion inc-bouton donc). La sécurité XSS ajoutée en 3.1.7 et 3.2 bloque certains codes HTML, et ça semble le cas ici.
Pour aller plus loin, le texte est échappé car safehtml() ne retourne pas le même contenu que le texte d’origine. Effectivement, il enlève tout ce qui est entre
<!--[if mso]> et <![endif]-->.La version 2.5.1 du plugin corrige le problème avec SPIP 3.2
Salut cédric :-)
Merci pour le boulot !!!
La version 2.5.1 à le statut « test », mais comme la version 1.x.x avait le statut « stable » la mise à jour n’est pas proposé par « svp »
En plus, la version 1.x.x n’est plus proposé en zip (en plus du fait qu’il a changer de nom)
https://zone.spip.org/trac/spip-zone/changeset/106858/
Donc ma question est de savoir si, tu penses possible de mettre le statut « stable » à la version 2.x.x pour qu’avec un peu de chance, svp propose la mise à jour à ceux qui sont sous spip 3.1.7
Franck
Super, ça marche nickel sur la 3.2 désormais. Beau boulot.
Salut Cédric, merci d’avoir travaillé sur ce problème ! Peut-on disposer bientôt de la version 2.5.1 ? En attendant j’ai mis le opt-in en opt-in simple.
Toujours le même problème... La version 3.5.1 du plugin facteur ne le résoud pas. La version 2.5. n’est pas disponible en téléchargement. Le texte du message de confirmation est illisible.
La loi sur la protection des données qui entre en vigeur le 25 mai renforce la nécessité de passer par un opt-in. Actuellement, je ne peux pas proposer cette fonction à cause de ce problème.
Si je ne trouve pas de solution, je devrais adopter une autre solution pour la gestion des inscriptions, ce que je regrettrai fortement.
Est-il possible de regler le problème tout en utilisant la version 3.5.1 du plugin facteur ?
Heu chez moi la version 2.6.0 Mailsubscriber est bien disponible en téléchargement et en installation automatique.
Pas sur le site plugins spip, un clic sur cette version ne donne rien. Mais même si ce serait possible de le télécharger, est-il bon de mettre une version ancienne ? Je préfère des plugins à jour. Ne pourrait-on pas régler ce problème autrement ?
Répondre à ce message
Bonjour
j’ai refait le site Yoga Vision avec la version 3.2 de spip et réinstallé le plugin. Et il ne marche pas.
J’ai mis le formulaire de base dans le squelette : #FORMULAIRE_NEWSLETTER_SUBSCRIBE
http://www.yoga-vision.org - formulaire dans la colonne de droite
Je me retrouve avec 2 bugs par rapport au passé :
- le message « Erreur » qui apparaît quand je le test.
- Email avec un petit point avant le formulaire
Vos lumières et aide me seront précieuses
merci
Eric
Répondre à ce message
Bonjour,
J’utilise ce super plugin couplé avec Mailshot configuré pour Mailjet et le plugin Newsletter, avec une liste de près de 1000 contacts pour le moment. Mailjet invalide automatiquement les adresses bloquées mais pas les adresses en erreurs (domaine invalide ou utilisateur inconnu).
Je me demande donc s’il est possible de faire quelque chose pour que les adresses mises en erreur par Mailjet puissent être supprimées de la même façon que les adresses bloquées.
Ou alors, au moins, comment faire pour modifier en une seule fois le statut de toutes les adresses mises en échec dans SPIP, dans le compte rendu d’envoi de newsletter ?
Bref, comment ne plus les avoir dans la liste pour un prochain envoi et repartir sur une liste propre, sans modifier les statuts un par un !
D’avance merci pour vos pistes !
Bonjour,
normalement, les adresses mises « en erreur » par mailjet, ne pourront pas être réutilisées lors d’un envoi suivant.
J’adhère à l’idée d’utiliser un automatisme pour que spip reçoive l’information de ces adresses en erreurs, et puisse ainsi mettre à jour sa propre base de donnée.
Pour l’instant c’est la base de données du compte mailjet qui se met à jour.
C’est à dire, que les « erreurs » doivent etre « corrigées » manuellement.
Y a-t-il d’autres solutions plus simples ?
Si vous utilisez un compte Mailjet en v3 avec l’API v3, il y a automatiquement remontée des adresses en erreur depuis Mailjet et une stratégie de désabonnement des adresses fautives
Merci Cédric pour cette info,
Mais où donc dans spip cette remontée d’adresses en erreur est-elle visible ?
Car je n’ai pas constaté cela. Il y a peu, il m’a fallu désinscrire manuellement dans la base spip les adresses signalées « en erreur » par mailjet V3, pour approprier la base spip.
Merci pour vos réponses.
Je confirme que seules les adresses « bloquées » (noires chez Mailjet) sont automatiquement désinscrites de la liste de diffusion dans Spip, mais pas celles en « erreur » (oranges chez Mailjet).
Dans Spip, je vois donc ces adresses en « erreur » additionnées à celles « bloquée » dans le compte-rendu des envois de la newsletter. Tandis que celles en « erreur » sont toujours dans la liste des inscrits à la liste de diffusion dans Mailsubscribers.
(@ Jaser, on les voit donc dans le compte-rendu de l’envoi : publication > suivi des envois de mails en nombre… il y a la liste des envois réussis et des envois échoués. Mais du coup c’est plus clair dans Mailjet car on peut n’afficher que les erreurs à supprimer manuellement, les bloquées étant déjà automatiquement supprimées dans Spip).
Dans les désinscrits, je n’ai donc que les « bloqués » et les désinscriptions faites par les destinataires.
J’utilise un Spip 3.1.7 avec les 3 plugins à jour et Mailjet V3…
Attention, il faut bien configurer Mailshot pour qu’il utilise l’API mailjet, et pas le réglage en SMTP.
Ensuite pour la gestion des erreurs :
https://zone.spip.org/trac/spip-zone/changeset/99821/_plugins_/mailshot/trunk
Mailshot est bien configuré sur Mailjet et non en smtp.
Voilà l’explication, c’est le premier échec et non le troisième, mais jamais sur de boites pleines, seulement des gens qui on mal renseigné leurs mails, avec des adresses du type @gmal ou @wanado, plus certains utilisateurs inconnus… donc aucune chance que ça passe la prochaine fois.
Du coup je vais devoir les enlever à la main, 38 sur 1000… ça va encore mais je n’aime pas car il me semble que les erreurs accumulées au cours des envois nuisent à la réputation de l’expéditeur avec un maximum accepté de 5% au total en s’additionnant au fur et à mesure sans jamais revenir à zéro d’un envoi à l’autre.
En tout cas, merci Cédric pour ce plugin et toutes ces réponses précises.
Répondre à ce message
Bonjour,
Je souhaiterais savoir comment mettre en place un contrôle plus strict sur les adresses email saisies dans le formulaire newsletter_subscribe pour prévenir de certaines erreurs telles que les adresses sans extension (ex : toto@monom). Pourriez-vous m’indiquer comment faire ?
Merci par avance pour votre retour.
Jp
Répondre à ce message
Bonjour
Depuis que j’ai mis à jour les plugins Mailsubscripter et Newsletter, rien ne va plus :
je ne retrouve ni les listes de diffusion, ni les inscrits à ces listes.
Pire, je ne peut inscrire personne : on peut ajouter une adresse mail, mais elle reste au statut « pas inscrit ».
est-ce parce que le site est sous spip 3.0 et pas encore 3.2 ?
Si je fais la mise à jour, retrouverais-je tous les inscrits et toutes les listes ?
Les formulaires d’inscriptions sur le site seront-ils opérationnels de nouveau ?
Merci d’avance
Bonjour,
Pardon il y eu un petit problème lors de la mise à jour, j’ai bien retrouvé les inscrits et les listes. Sauf que le formulaire d’inscription en ligne (en double opt-in) sur un article du site n’inscrit personne. On ne reçoit pas de confirmation sur son adresse mail et rien sur le site comme adresse en attente de confirmation.
Bonjour,
j’ai le même problème sur mes 2 sites, les inscriptions restent en attente et même en étant administrateur on ne peut pas les activer.
J’ai du aller dans la bdd pour pouvoir les valider.
Meilleurs voeux
Bonjour,
Merci de m’expliquer alors comment inscrire à une newsletter par la bdd.
Que faut-il modifier dans quelle table ?
Il faut se connecter à la bdd avec phpmyadmin, afficher la table « spip_mailsubscribers », éditer la ligne correspondant à l’inscription à valider et modifier la case « statut » à « valide ».
Ensuite cliquer sur « Exécuter ».
Oui, cela donne le statut « active », mais toujours impossible d’inscrire à une newsletter.
Si on coche une ou plusieurs listes dans la liste des listes et que l’on clique sur « Enregistrer », rien ne se passe et la fiche revient sans rien de coché.
J’ai aussi essayé de documenter l’item « optin » dans Phpmyadmin avec « newsletter : : identifiant de la newsletter », mais ça ne marche pas non plus.
J’ai trouvé comment inscrire aux newsletters par Phpmyadmin :
il faut passer par la table spip_mailsubscription qui lie les id des inscrits à ceux des newsletters. l’item optin de la table spip_mailsubscripter apparemment ne sert plus à rien après la mise à jour.
Mais toujours impossible d’inscrire par l’interface privée et par le formulaire du site.
Bonne année quand même avec Spip !
Bonjour
Je me réponds à moi-même.
J’ai trouvé la solution : le problème venait d’une surcharge dans squelettes d’un fichier d’une ancienne version. En la supprimant, tout est revenu dans l’ordre.
Répondre à ce message
Hello
Dans mon squelette Escal, j’ai une page de contact et je voudrais y ajouter une case à cocher ’M’inscrire à la newsletter"
Comment pourrais-je m’y prendre, sachant que je suis ignare en php ?
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 :
|
