SPIP-Contrib

SPIP-Contrib

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

291 Plugins, 198 contribs sur SPIP-Zone, 109 visiteurs en ce moment

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

Mailsubscribers

16 janvier 2013 – par Cerdic – 440 commentaires

49 votes

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

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.

Voir en ligne : https://plugins.spip.net/mailsubscribers

Notes

[1à partir de la version 1.6.0

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

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

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

[5ré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

Dernière modification de cette page le 4 octobre 2018

Retour en haut de la page

Tout afficher

Vos commentaires

  • Le 21 août 2015 à 22:13, par placido En réponse à : Mailsubscribers

    Bonjour,

    J’ai voulu débuter la traduction du module dans une nouvelle langue depuis trad.spip.net. Or, ce dernier n’est pas disponible depuis l’interface de traduction.

    En regardant dans le dossier du plugin, je reste perplexe, car c’est tantôt le préfixe mailsubcribers (au pluriel, comme déclaré dans paquet.xml) tantôt mailsubscriber (au singulier, comme pour certaines fonctions ou fichiers de langue) qui semble être utlisé.

    D’où mes 2 questions :

    -  Peut-on rajouter le module à la liste de Salvatore, afin de partager ma traduction ?
    -  Dans quelle mesure le recours au préfixe mailsubcriber (singulier) est-il fonctionnel ?

    Merci,

    Répondre à ce message

  • Le 20 août 2015 à 22:04, par Perline En réponse à : Mailsubscribers

    Bonjour,
    J’ai implémenté ce plugin (et ses copains) sur un site sans problème
    Là, sur un autre, la page d’inscription/désinscription me donne une erreur 404.
    J’ai fait un copier-coller de /squelettes/newsletter
    J’a fait un copier-coller dans Zpip de /squelettes/contenu/page-newsletter.html, qui contient les balises FORMULAIRE_NEWSLETTER_SUBSCRIBEnewsletter et FORMULAIRE_NEWSLETTER_UNSUBSCRIBEnewsletter.
    Et j’ai une erreur 404.

    ma config : SPIP 3.0.20 ; MailShot 1.8.2 ; Zpip-dist v1 1.7.28.

    Merci de votre aide.

    Répondre à ce message

  • Le 10 octobre 2014 à 12:16, par pierrot En réponse à : Mailsubscribers

    Je m’interrogeais sur les interactions entre « inscription à une newsletter » et « inscription au site ». Sur un site on est passé de spip-listes à newsletters je crois constater les différences suivantes :

    -  sur spip-listes on utilisait dans les patrons _AUTEUR_NOM_ qui semble ne plus marcher, sur newsletters on a essayé de remplacer par @auteur_nom@ ou \#ENV{auteur_nom} ce qui ne donne aucun résultat, par contre on a bien quelque chose pour @nom@

    -  l’idée était d’envoyer une newsletter personnalisée qui fournissait le nom et le login des visiteurs du site, ce qui me semble impossible aujourd’hui ... c’est moi qui comprend pas quelque chose ou c’est vraiment plus possible (ça marchait) ?

    -  quand on importe des listes d’abonnés (c’est souvent le cas, les gens aiment gérer leur abonnés en dehors du web, surtout pour des listes de « captifs », c’est à dire de membres d’une assoc par ex) ne serait-il pas possible que cet import génère une inscription au site comme visiteur avec un mot de passe commun ou par ex. généré sur un schéma genre « 4 première lettres du login plus 3 caractères décidés par le webmaster » ce qui permettrait d’ailleurs d’avoir un mdp qui évolue ... et que l’on pourrait écrire/personnaliser dans la newsletter ?

    -  quand on crée un visiteur dans le site, ne pourrait-on avoir une liste des newsletters avec des cases à cocher pour inscrire directement à une newsletter ? (il semble que ce soit le cas dans le formulaire public d’inscription au site, est-ce difficile de l’ajouter au formulaire du back-office ? c’est une saisie ?)

    Merci d’avance pour quelques éclaircissements ...
    Pierre

    • Le 11 octobre 2014 à 07:50, par pamillet En réponse à : Mailsubscribers

      pour ce que j’ai compris...

      il n’y a aucun lien dans newsletter entre un inscrit à une newsletter et un inscrit au site...
      ce sont deux données totalement indépendante
      et il faudrait (faudra ?) faire des modules complémentaires de lien entre ces deux notions...ce qui sera utile pour pas mal d’autres plugins (assos, pétitions..). J"utilisai par exemple spiplistes pour gérer des listes de diffusion correspondantes aux signataires d’une pétition (qui sont des invités spip), il faut refaire ce lien...

      par contre, après avoir pas mal galéré au début, la gestion des inscrits aux envois par mail est très bien faite avec notamment la tracabilité des modifs...

      pam

    • Le 21 mars 2015 à 07:24, par bcaron En réponse à : Mailsubscribers

      Bonjour,
      Je me joins à la demande de pouvoir inscrire des inscrits au site sur une liste fermée.
      J’essaye de ne plus utiliser spip-liste et cette fonctionnalité est très intéressante.

    • Le 20 juillet 2015 à 17:57, par bcaron En réponse à : Mailsubscribers

      Bonjour,
      je reviens à ma demande d’utilisation de la liste des inscrits d’un site spip pour créer des listes de diffusion afin que la modification de l’adresse mail d’un auteur/admin etc... se répercute dans le plugin.
      Mon objectif est d’abandonner spip listes.
      Si les développeurs pouvaient mettre ça dans leur roadmap...
      Merci

    • Le 20 juillet 2015 à 18:02, par Cerdic En réponse à : Mailsubscribers

      il suffit d’utiliser la fonction « Listes de diffusion automatiques » qui a été ajoutée au plugin en choisissant les inscrits au statut visiteur. La liste sera toujours synchronisée avec les inscrits au site.

    • Le 20 juillet 2015 à 18:17, par bcaron En réponse à : Mailsubscribers

      puis je faire autant de listes que je veux (avec le nom que je veux) à partir des auteur/visiteurs/admin du site ?

    Répondre à ce message

  • Le 2 juillet 2015 à 14:54, par Natacha Courcelles En réponse à : Mailsubscribers

    Bonjour à tous

    j’ai un problème bizarre que je n’arrive pas à résoudre
    j’ai 2 sites strictement identiques un en dev l’autre en prod
    plugins Facteur, Newsletters, Mailshot, Mailsubscribers configurés pareils

    je créé une newsletter avec Newsletters
    je l’envoi en test à mon adresse mail

    sur mon serveur de dev le lien de désabonnement inclus dans le mail reçu est :
    http://www.mondomaine.com/spip.php?action=unsubscribe_mailsubscriber&email=info%40courcelles-design.fr&arg=72e5cbe47a4f055701253cdc70c1d3e23224310c

    sur mon serveur de prod le lien de désabonnement inclus dans le mail reçu est :
    http://www.mondomaine.com/unsubscribe -> erreur 404

    @url_unsubscribe@ n’est donc pas le même ou il y a un bug quelque part mais je ne vois pas ou

    merci de votre aide
    Bien cordialement
    Natacha

    Répondre à ce message

  • Le 8 juillet 2015 à 15:59, par Roca balbolive En réponse à : Mailsubscribers

    Bonjour,

    Pour donner la solution à un problème auquel j’étais confronté :

    Lors de l’inscription à des newsletter, que j’effectuais avec :

    1. #FORMULAIRE_NEWSLETTER_SUBSCRIBE{newsletter,nouveautes}

    l’inscription ne se faisait que pour la liste newsletter::newsletter

    Pour s’inscrire à plusieurs listes d’un coup, j’ai simplement écrit :

    1. #FORMULAIRE_NEWSLETTER_SUBSCRIBE{#LISTE{newsletter,nouveautes}}

    et l’inscription se fait sur les deux listes en même temps

    Idem pour #FORMULAIRE_NEWSLETTER_UNSUBSCRIBE

    Solution que j’ai trouvé par hasard de nombreux messages en arrière... J’espère que ça aidera certains qui ont cherché la solution désespérément comme moi

    Répondre à ce message

  • Le 18 juin 2015 à 07:12, par Jaseur Boreal En réponse à : Mailsubscribers

    Bonjour,

    Merci Cédric pour cet outil, et l’option « Inscription à la Newsletter » qui peut s’ajouter lors de l’inscription au site ou lors d’une réponse commentaire dans un article.

    Comment faire pour ajouter de la même manière cette fonction « Inscription à la Newsletter » dans une autre page ?

    Par exemple dans la « contact » du plugin « escal ».

    Je cherche où se trouve le fichier qui transporte cette fonction, ainsi que le fichier .css qui gère son affichage.

    Merci des conseils

    Répondre à ce message

  • Le 8 septembre 2014 à 21:49, par pamillet En réponse à : Mailsubscribers

    bonsoir,

    la gestion des inscriptions me pose toujours problème...

    la page « /ecrire/ ?exec=mailsubscribers&importer=oui&liste= » me donne 6477 inscrits
    et l’export des adresses me donne bien 6477 lignes
    mais la liste principale annonce 6466 inscrits, alors que dans l’export, les 6477lignes sont inscrites à cette liste...

    donc, le compteur des inscrits d’une liste, ne compte pas toutes les adresses...
    si ce n’est qu’un pb d’indicateurs,ce n’est pas très grave,mais ca veut peut-être dire que certaines adresses ne sont pas valides ?

    merci d’avance...
    pam

    • Le 24 septembre 2014 à 15:35, par pierrot En réponse à : Mailsubscribers

      Bonjour,
      Je n’ai pas de réponse, je vois juste qu’il y a un « export des inscrits » et un « export des adresses » ... La différence ne vient-elle pas de là ?
      Pierre

    • Le 10 février 2015 à 17:41, par Chourak En réponse à : Mailsubscribers

      Bien le bonjour,

      Je remonte virtuellement ce commentaire pour faire part du même problème : le nombre d’inscrits et le nombre affiché pour la newsletter est différent.
      La différence est pile poil le nombre d’adresses que ma cliente vient de rajouter à la main.
      J’ai exporter toutes les adresses et je les ai réimporté ensuite et pas mieux, la même différence.

      Est-ce un problème de calcul / d’affichage et donc tous mes inscrits sont bien pris en compte ou y a t’il un réel problème avec les derniers inscrit manuellement ?

    • Le 12 février 2015 à 10:02, par Chourak En réponse à : Mailsubscribers

      Bon et bien après quelques vérifications il s’avère qu’une adresse mail mal formatée était à l’origine du souci, il manquait le . avant l’extension du domaine.

    Répondre à ce message

  • Le 23 mai 2015 à 12:16, par Fanny En réponse à : Mailsubscribers

    Bonjour

    j’ai un soucis avec la validation double opt-in. Je coche la case donc double Opt-in dans la configuration et pourtant dans le mail reçu, il n’y a pas de lien pour valider, je suis inscrite directement.

    J’ai pas contre bien le lien pour me désinscrire, mais le but est de qualifier les mails et d’éviter les erreurs de frappes et autres erreurs.

    Quel peut être le problème ?

    Je vous remercie.

    Répondre à ce message

  • Le 11 avril 2015 à 12:22, par galop En réponse à : Mailsubscribers

    Bonjour,

    Est-il possible d’ajouter un champs dans la fiche auteur pour l’affecter à une liste ?

    Merci

    Répondre à ce message

  • Le 20 avril 2015 à 14:32, par crazyspip En réponse à : Mailsubscribers

    Bonjour,

    Spip 3.0.17 - Mailsubscribers 1.6.13

    J’ai 2 questions.

     

    1. Dans mon squelette, je mets

    1. #FORMULAIRE_NEWSLETTER_UNSUBSCRIBE{newsletter,test2}

    Lorsque je me désinscris, je ne suis désinscrite que de newsletter. Y a-t-il autre chose à faire pour que ça fonctionne ?

     

    2. J’essaie d’importer des listes de contacts. J’ai bien un fichier Excel avec les bonnes colonnes et intitulés de colonnes, que j’exporte en CSV. La prévisualisation du fichier fonctionne, mais lorsque je clique sur « importer », j’ai un message d’erreur (un pour chaque ligne de données, en fait).

    Erreurs :
    email invalide « xxxx@xxxx.be ;NOM ;fr ;2015-03-16 10:00:00 ;valide ;newsletter::machin »

    C’est comme s’il considérait que toutes mes colonnes regroupées = adresse email, il me semble. Je tourne en rond...

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

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

  • Owl Carousel 2

    30 novembre 2017 – 42 commentaires

    Owl Carousel est un diaporama jQuery adaptable aux différentes tailles d’écran, qu’on peut actionner par glisser, il utilise CSS3 mais il est compatible avec les vieux navigateurs, et il est aussi paramétrable. Le présent plugin permet d’utiliser (...)

  • Formidable, le générateur de formulaires

    23 janvier 2012 – 2531 commentaires

    Un générateur de formulaires facilement configurable pour les non-informaticiens et facilement extensible pour les développeurs. Introduction L’objectif était de créer un plugin permettant de générer des formulaires. Historiquement, 2 plugins (...)

  • Calendrier Mini 2.0

    19 mai 2012 – 256 commentaires

    Ce plugin ajoute la balise #CALENDRIER_MINI qui insère un petit widget de navigation par mois dans les dates des évènements. Fonctionnement du mini calendrier Le mini calendrier présente un mois à la fois. Les jours du mois comportant des (...)

  • Paiement avec Formidable

    16 février 2015 – 69 commentaires

    Ce plugin « Paiement avec Formidable » permet d’ajouter une étape de paiement à la fin de la saisie d’un formulaire créé par le plugin Formidable. Il le complète et nécessite par ailleurs le plugin bank qui gère l’interface technique avec les prestataires (...)

  • citrace : garder une trace de certaines actions

    26 juillet 2013 – commentaire

    L’objectif est de garder une trace, pendant une période déterminée, de qui a effectué quelle action sur le contenu du site et quand. Les objectifs de ce plugin L’objectif est de garder une trace, pendant une période déterminée, de qui a effectué (...)