Mailsubscribers

16 January 2013 – by Cerdic – 499 commentaires

1
2
3
4
5
52 Votes

Ce plugin permet de gérer les inscriptions (ou abonnements) à la diffusion de contenu par email.

Table of contents

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 courier é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 Redacteurs 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 raffraichissez 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 personalisant 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 desinscrit, 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 “desabonné” 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

A chaque fois qu’une adresse email est inscrite ou desinscrite, 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 elements 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ésaprobation d’avoir été inscrite à son insu (à tort ou à raison).

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.

Footnotes

[1] à partir de la version 1.6.0

[2] Cette fonction necessite la présence du plugin SPIP-Bonux

[3] les adresses mails des desinscrits sont obfusquées par un md5 pour des raisons de confidentialité

[4] Cette fonction necessite la présence du plugin SPIP-Bonux

[5] réserver cet usage au transfet d’inscrits d’un site à un autre, et ne pas en profiter pour importer des adresses qui n’ont pas explicitement demandé à être inscrites

updated on 6 April 2020

Discussion

5 ans 1 an 3 mois Sans limite
par date
Filtrer

188 discussions

  • JeromeD

    Bonjour,
    Je voulais savoir s’il était possible de désinscrire en masse des adresses de ce plugin à l’aide de l’import de fichier csv. Il ne me semble n’avoir vu que la possibilité d’inscription.
    L’objectif étant de nettoyer la liste des inscriptions après une vague massive d’inscriptions bidons.
    Merci d’avance pour votre retour
    Cordialement
    Jérôme

    Reply to this message

  • Pierre

    Bonjour,

    J’ai installé sur ma page d’accueil un formulaire avec le code :

    #FORMULAIRE_INSCRIPTION_NEWSLETTER{'maliste'}

    J’ai choisi le double opt-in.
    L’inscription se passe bien, en statu “prop”, Mais le mail de confirmation de l’adresse mail n’est jamais envoyé. En essayant de debugger, je vois que le code passe par les fonctions :

    - inscription_newsletter_traiter()
- newsletter_subscribe_dist()

    dans newsletter_subscribe_dist, il s’exécute à la fin :

    $notifications('instituermailsubscriptions', $row['id_mailsubscriber'], $notifications_options);

    avec une variable $notifications_options qui vaut :

    array (size=4)
          'identifiant' => string 'maliste' (length=9)
          'id_mailsubscribinglist' => string '1' (length=1)
          'statut' => string 'prop' (length=4)
          'statut_ancien' => string 'prop' (length=4)

    Par la suite, ces options sont transférées de fonction en fonction :

    - inc_notifications_dist()
- notifications_instituermailsubscriptions_dist()

    Mais dans tous les cas, aucun mail n’est envoyé.
    Pourtant, les newsletter par exemple, sont envoyées par mail (et reçues) sans problème.

    Avez-vous une idée pour m’aider à faire fonctionner ces mails de confirmation ?

    Reply to this message

  • iota

    Bonjour,

    nous utilisons Mailsubscribers 2.14.4 et, seul petit problème, le mail de confirmation reçu lors de l’insciption est en anglais. Le second mail reçu, lorsque qu’on clic sur le lien contenu dans le premier mail, est quant à lui bien en français.. bizarre

    J’ai regardé dans le fichier mailsubscriber_fr.php et fais une recherche sur la chaîne confirmsubscribe_texte_email_1 et je n’ai rien trouvé d’anormal..

    Une idée ?
    Merci !

    Reply to this message

  • 7
    SireJovial

    Bonjour,
    Après mise à jour de mailsubscribers, le code http://www2.ac-lyon.fr/services/loire/tice/spip.php?article381> dans un article provoque la disparition des articles qui se trouvent en dessous de lui et le champ à renseigner n’apparait pas. Si je désactive mailsubscribers, tout redevient normal.
    Avez-vous une idée pour résoudre ce problème ?
    Merci

    • SireJovial

      Erreur de copier/coller, désolé, c’est le code “formulaire|newsletter_subscribe|listes=newsletter” entre < et > qui pose problème.

    • vfavrat

      Bonsoir.
      Ayant accès à ce site, j’ai désactivé la plupart des plugins et le problème persiste.
      Comme c’est arrivé après la mise à jour du plugin “Mailsubscribers”, je crains qu’il n’y ait un bug avec le modèle <formulaire|newsletter_subscribe|listes=newsletter> .
      Merci de regarder si vous avez une solution pour que cela fonctionne à nouveau.
      Merci d’avance.

    • Cerdic

      Je ne vois rien d’anormal sur le plugin ni le formulaire, et le raccourci fonctionne normalement sur mon site de test en SPIP 3.2

      La seule modification récente sur ce formulaire concerne l’antispam, mais fonctionne normalement qu’on ait une version récente ou non du plugin NoSpam voire pas le plugin NoSpam actif.

      Comme on a ici aucune information pour en dire plus c’est compliqué de vous aider : quelle version de SPIP ? quelle version du plugin mailsubscribers ? quelle version du plugin NoSpam ? un lien vers un article où le problème se produit et qui permet de le voir ?

    • SireJovial

      Merci pour votre réponse.

      En pièce jointe, une copie d’écran lorsque le modèle est renseigné en entier dans la noisette “infolettre”. Si je supprime le > à la fin du modèle, les noisette de la colonne de droite réapparaissent. Il se passe la même chose si j’ai une noisette en dessous de l’infolettre dans la colonne de gauche : elle disparait.

      Le site est le suivant : http://www2.ac-lyon.fr/services/loire/tice

      La version de SPIP est 3.0.21, la version de mailsubscriber est 2.14.4, pas de plugin nospam installé.

      Autre constat, si le modèle est présent dans un article, dans l’interface d’édition, je ne vois pas le contenu de l’article ni les blocs “auteur”, “mots clés” “date de publication” qui sont normalement présent au dessus du corps de l’article avant de l’éditer.

    • Cerdic

      Il y a peut-être une erreur fatale de ce formulaire avec SPIP 3.0 ? Il faudrait regarder les logs PHP ou apache sur votre serveur.

      Je n’ai plus de version SPIP 3.0 pour tester, cette version n’est plus maintenue et il serait grand temps de mettre à jour vers SPIP 3.2 https://www.spip.net/fr_article6500.html

    • SireJovial

      Merci, la mise à jour de SPIP a fait disparaître le problème.

    • vfavrat

      Autre aspect positif du changement de serveur ;)
      Bien contente que cela ait réglé le problème.

    Reply to this message

  • 1
    beno

    Bonjour à vous,
    Signalement de ce qui pourrait être un petit bug (SPIP 3.2.7, plugin mis à jour, et cache vidé) :
    Quand je clique sur une personne inscrite (ecrire/?exec=mailsubscriber&id_mailsubscriber=xxx), j’obtiens un message d’erreur : “Aucun squelette prive/objets/liste/mailshots_destinataires n’est disponible...”
    C’est moi ou c’est le plugin ?

    • I-love-spip

      Bonjour à tous
      J’ai exactement le même problème avec juste un squelette-dist.
      Quelqu’un aurait-il une idée de comment je peux solutionner le problème ?
      Avec mes remerciements
      Aucun squelette prive/objets/liste/mailshots_destinataires n’est disponible...
      ../plugins/mailsubscribers/prive/objets/contenu/mailsubscriber.html / 55

    Reply to this message

  • jotacese

    Je suis dans Spip 3.2.7, Mailsuscribers 2.14.4 et PHP 7.2. Lorsque j’essaie d’utiliser un formulaire d’inscription (le plus simple sans changements sauf pour les styles via CSS) mon site affiche le message ok (“Vous allez recevoir un email sur l’adresse email@email.com pour confirmer votre inscription”) mais le courriel n’arrive jamais.

    En recherchant dans le journal des erreurs, j’ai trouvé cet avertissement:

    PHP Warning:  count(): Parameter must be an array or an object that implements Countable in /home/monsite/public_html/tmp/cache/skel/html_b0ec682da9cf73502b431479d8a1a614.php on line 103

    Cette ligne contient le code suivant:
    vide($Pile['vars'][$_zzz=(string)'bouton'] = interdire_scripts((((((count(entites_html(table_valeur(@$Pile[0], (string)'_listes_choix', null),true)) > '1')) AND (interdire_scripts(entites_html(table_valeur(@$Pile[0], (string)'_checkable', null),true)))) ?' ' :'') ? attribut_html(_T('newsletter:bouton_subscribe_multiples')):attribut_html(_T('newsletter:bouton_subscribe')))))

    Peut-il s’agir d’un code invalide en PHP 7.2 qui empêche l’envoi de l’e-mail?

    Note 1: J’ai essayé d’utiliser PHP mailer et la connexion SMTP. Lorsque j’envoie un message de test avec Facteur depuis l’espace privé, je n’ai aucun problème.

    Note 2: Désolé pour mon français et merci pour le plugin!

    Reply to this message

  • DD

    Bonsoir,
    J’ai un formulaire de désinscription sur une page publique et je m’attendais à recevoir un email de demande de confirmation de désinscription mais il me semble (testé avec plusieurs adresses mails et en changent de navigateur) que l’adresse mail saisie est directement désinscrite. (un message est bien envoyé après la désinscription)
    Cela veut dire que n’importe qui peut désinscrire n’importe qui ?
    Merci

    Reply to this message

  • 2
    Pieerot

    Bonjour,
    Est-il envisagé de remplacer les “ul/li” qui structurent les champs par des “div” dans les formulaires d’inscription pour être identique à Formidable ?
    Pierre.

    • Cerdic

      La version actuelle du plugin étant encore compatible SPIP 3.0, ce n’est pas souhaitable.
      Je vais sans doute passer en v3 pour le support de SPIP 3.3 et abandonner la compat 3.0 et dans ce cas ce sera possible.

      Cela dit les formulaires utilisent bien les classes .editer et .editer-groupe qui sont la convention commune et doivent servir de support aux styles, donc ça ne doit pas gêner

    • Pierrot

      Bonjour,
      Ok merci pour l’explication :-) Non ça ne gène pas (c’est déjà fait en fait), mais ça serait plus joli dans ma feuille de style ...
      Pierre

    Reply to this message

  • 1
    DD

    Hello,
    Quelle est la bonne syntaxe pour afficher un formulaire d’inscription dans une page via un modèle ?
    J’ai plusieurs listes ouvertes et elles ne s’affichent pas avec les cases à cocher.
    J’ai essayé

    <formulaire|newsletter_subscribe|listes=nomliste_4|listes=nomliste_2>
<formulaire|newsletter_subscribe|listes=4|listes=2>

    Mais la liste des listes n’apparaît pas et lorsque l’on s’inscrit c’est la liste 2 (qui est cachée donc) qui est choisie par défaut.
    Merci

    Reply to this message

  • 5
    ablink

    Bonjour,
    Quelqu’un connaitrait une technique pour éviter les tentatives d’inscription par des robots (ou des casses-pieds ^^) ?
    Un captcha par exemple mais le dernier plugin est indiqué compatible avec la version 1.9 de SPIP, or mon site est en 3.2.1 ...
    Merci.

    • Cerdic

      Ce plugin s’autodétruit si on utilise un captcha !

      JAMAIS de captcha, qui n’arrête que les humains

      Tu as essayé le plugin nospam ?

    • ablink

      J’ai déjà le plugin nospam mais il ne répond pas à mes besoins, j’ai une newsletter donc avec un formulaire d’inscription. J’ai activé le double Opt-in pour ne pas avoir une flopée d’inscription bidons mais cela ne suffit pas car il y a quand même plusieurs tentatives d’inscription bidons, avec des adresses emails inexistantes ... du coup le double opt-in essaye d’envoyer le mail de confirmation, n’y arrive pas (forcément) et on recoit un “undelivered mail” ... chose qui aurait pu etre limitée avec un captcha ...

    • Cerdic

      La version 2.13.0 du plugin, associée à la nouvelle version 2.0.0 du plugin nospam, intègre une protection renforcée contre les bots du formulaire d’inscription. A tester donc avec une mise à jour des 2 plugins dès qu’elles sont disponibles dans les zips

    • 1138

      Depuis quelques temps, je constatais aussi de nombreuses demandes d’inscription d’adresses douteuses. Avec les nouvelles versions des plugins, c’est réglé.

      Merci. 🙏

    • ablink

      Je trouve aussi que cela va beaucoup mieux ... pourvu que ça dure ^^
      Merci

    Reply to this message

Ajouter un commentaire

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom