CleverMail

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 pour SPIP 2.0.

Fonctionnalités

  • Gestion de multiples lettres, avec possibilité de les rassembler par catégories
  • Gestion des inscriptions en ligne et désinscriptions, les abonnés étant distincts des utilisateurs de SPIP
  • Possibilité de restreindre la liste des lettres proposées dans le formulaire d’abonnement
  • Abonnement au choix de l’utilisateur en version texte brut ou multipart simultané HTML + texte brut [1]
  • Possibilité de forcer la version dans le formulaire d’abonnement
  • Récupération des contenus HTML et texte brut à partir de deux squelettes ou deux URL, donc utilisation de squelettes SPIP dédiés voire même de contenus externes au site
  • Automatisation des envois avec une fréquence quotidienne, hebdomadaire (multiples jours de la semaine possibles) ou mensuelle
  • Automatisation des inscriptions depuis un fichier distant

Mise en place du plugin

Télécharger le paquet ci-joint et placer son contenu dans votre dossier plugins/.

Avant d’activer CleverMail dans l’interface de gestion des plugins, vous devrez installer les plugins Facteur et SPIP Bonux.

Présentation de l’interface dans l’espace privé

Une fois le plugin activé, le sous menu CleverMail est crée dans le menu Edition.

Le menu de CleverMail permet de :

  • Lister les lettres existantes
  • Créer une nouvelle lettre
  • Lister les abonnés
  • Ajouter des abonnés
  • Paramétrer le plugin

Tableau de bord

Le tableau de bord général de CleverMail affiche la liste des newsletters et leurs caractéristiques principales :

Différentes actions sont disponibles

  • Modifier : Permet de modifier une lettre
  • Supprimer : Une lettre peut être supprimer seulement si aucun abonné n’y est inscrit.
  • Nouveau Message

Création / Modification d’un lettre d’information

Une lettre se compose de la façon suivante :

  • Nom : Le nom de la lettre est important car c’est par leurs noms que les lettres sont triées et classées par catégorie. “01. Ma Catégorie/02. Ma Lettre”
“01.” Ordre de la catégorie (peut commencer à 00. )
“Ma Catégorie” Nom de la catégorie (= Nom du type de publication)
“/” séparateur sans espace entre le nom de la catégorie et le nom de la lettre
“02.” Numéro d’ordre de la lettre (peut commencer à 00. )
“Ma Lettre” Nom de la lettre
  • Description : Explication back office de la lettre, par défaut ce champ n’apparait pas en front office .
  • Modération :
    • Ouverte : tout le monde peut s’inscrire sans confirmation
    • E-mail : tout le monde peut s’inscrire après confirmation par e-mail
    • Fermée : personne ne peut s’inscrire, utile pour tester avant ouverture, ou fermer temporairement
  • E-mail du modérateur : (Champ obligatoire) Le modérateur reçoit un mail dès qu’un utilisateur confirme sont inscription à une lettre. Plusieurs adresses peuvent être saisies en les séparant par des virgules.
  • Préfixe : Préfixe les sujets des messages avec le nom de la lettre d’information (ex : [Rapport annuel] Confirmation de votre inscription). Pour le formulaire multiple, en cas d’inscription à plusieurs lettres en même temps, ce champ n’est pas pris en compte.
  • Sujet et description d’une inscription : Message d’inscription qui sera envoyé par mail à l’utilisateur en cas de modération par E-mail. En cas d’abonnement multiple le message envoyé pour toutes les lettres est celui paramétré dans la section «paramétrage»
  • Sujet et description d’une désinscription : Message de désinscription qui sera envoyé par mail à l’utilisateur.
  • Version HTML : Nom du squelette [2] ou URL de la page permettant d’obtenir le contenu de la lettre en version HTML.
  • Version texte brut : Nom du squelette [3] ou URL de la page permettant d’obtenir le contenu de la lettre en version texte brut.
  • Automatisation des envois : Les envois des lettres d’information peuvent être fait manuellement ou être automatisés
    • Envois quotidiens : Les dernières publications [4] seront envoyées tous les jours à partir de l’heure précisée dans le champ “Heure de création du message”. Les publications publiées après cette heure seront envoyées le lendemain.
    • Envois hebdomadaires : Les dernières publications seront envoyées toutes les semaines le jour et à l’heure précisés dans les champs “Jour(s) de la semaine” et “Heure de création du message”.
    • Envois mensuels : Les dernières publications seront envoyées tous les mois au jour et à l’heure précisés dans les champs “Jour du mois” et “Heure de création du message”.
  • Mode d’abonnement : mode d’abonnement à la liste par défaut si aucun mode d’abonnement n’est précisé ou forcé à l’inscription.

Tableau de bord des abonnés

Le tableau de bord des abonnés affiche la liste des abonnés aux newsletters. Il y a une ligne par couple abonné/newletter.

La liste des abonnés peut être filtrée sur une partie de l’adresse e-mail (@example.com par exemple) et/ou sur le nom de la newsletter.

L’administrateur a la possibilité de modifier le mode d’inscription d’un abonné ou de le désinscrire d’une lettre. Dans ce cas l’abonné ne recevra pas de mail de désinscription.

Un lien “Vider les abonnements en attente depuis plus d’un mois” permet de supprimer de la base de données les demandes d’inscriptions en attente de validation depuis plus d’un mois.

Cette fonction nettoie également les adresses de type @example.com qui seraient par erreur [5] restées dans la table des abonnés aux newsletters.

Ajout d’abonnés

Des abonnés peuvent être ajoutés dans l’interface privé à partir d’un fichier CSV ou directement en saisissant les adresses e-mail dans le formulaire.

Dans le fichier ou dans la zone de saisie, mettre une adresse e-mail par ligne, ou séparer les adresses par des virgules ou points virgules.

Paramétrage

La section paramétrage contient les paramètres communs à toutes les lettres.

Les paramètres génériques sont les suivants :

  • E-mail administrateur : par défaut mail du webmestre de SPIP
  • E-mail expéditeur (from et reply-to) : par défaut mail du webmaster de SPIP
  • E-mail return path : par défaut mail du webmaster de SPIP
  • Nombre de messages par envoi : par défaut «50». A chaque traitement de la tache planifiée 50 messages seront envoyés.
  • Sujet et description d’une inscription multiple : Message d’inscription qui sera envoyé par mail à l’utilisateur en cas d’inscription a plusieurs lettres en même temps.

Mécanisme de création et envoi des messages

Envoi automatique

Les messages automatiques sont envoyés via une tache planifiée. Chaque jour, la tache planifiée regarde s’il y a eu de nouvelles publications depuis le dernier envoi et si la date du prochain envoi est atteinte.

Exemple d’une lettre envoyée tous les 15 du mois :

  • Janvier : Nouvelle publication le 10 => 15 du mois => envoi
  • Février : pas de nouvelle publication => 15 du mois => pas d’envoi => nouvelle publication le 17 => envoi => nouvelle publication le 20 => pas d’envoi
  • Mars : pas de nouvelle publication => 15 du mois => envoi de la publication du 20 février

Envoi manuel

Les messages peuvent également être envoyés manuellement depuis le tableau de bord des lettres d’information.

Pour créer un nouveau message, cliquer sur le lien “nouveau message” d’une lettre.

Le lien “1 message” permet d’accéder au tableau de bord des messages d’une lettre.

Ce tableau de bord permet de voir les messages par état : nouveau message, message en cours d’envoi et message envoyé.

Différentes actions sont disponibles sur les messages (selon leur état) :

  • Aperçu HTML : Visualisation de la lettre au format HTML, avant remplacement des balises de personnalisation
  • Aperçu texte : Visualisation de la lettre au format texte, avant remplacement des balises de personnalisation
  • Modifier : Modification du message qui sera envoyé
  • Supprimer : Suppression du message
  • Envoyer : Envoi du message, le message est déposé dans une file d’attente que le Facteur va dépiler au fur et à mesure de l’exécution du génie de SPIP. Le message en attente n’est plus modifiable ni supprimable.

Intégration au site public

La balise #FORMULAIRE_CLEVERMAIL permet d’afficher le formulaire par défaut des listes non filtrées par catégorie.

Il est possible de restreindre le formulaire d’abonnement à une newsletter en précisant l’id de la lettre:
#FORMULAIRE_CLEVERMAIL{1}

Il est aussi possible de restreindre le formulaire d’abonnement à un unique mode en précisant texte ou html :
#FORMULAIRE_CLEVERMAIL{0,html}

Il est enfin possible d’utiliser un formulaire avec des cases à cocher plutôt qu’une liste en passant box en troisième paramètre [6] :
#FORMULAIRE_CLEVERMAIL{0,html,box}

La balise #FORMULAIRE_CLEVERMAIL_MULTIPLE permet d’afficher le formulaire d’abonnement multiple filtrées par catégorie.

Support

En cas de bug ou problème particulier, merci de vérifier sur le Trac de la zone si un ticket existe déjà, et si nécessaire de créer un nouveau ticket avec le « component » “plugins/clevermail” et faire un commentaire ici-même pour signaler ce ticket.

Si vous avez des idées pour améliorer le plugin, même chemin, créez un nouveau ticket avec le « component » “plugins/clevermail” !

Si vous aimez ce plugin, et l’utilisez sur un site public, n’hésitez pas à le signaler sur sa fiche !

Footnotes

[1Attention, Lotus Notes n’aime pas...

[2CleverMail en propose un par défaut

[3CleverMail en propose aussi un par défaut

[4C’est à dire depuis l’envoi précédant.

[5Un bug depuis corrigé pouvait conduire à cette erreur

[6Le code impose pour l’instant de préciser les deux premiers paramètres, ce sera amélioré ultérieurement...

updated on 2 October 2019

Discussion

193 discussions

  • 3

    Je bosse en local et j’ai le même souci. j’ai mis à jour et ça marche plus.

    • Et moi aussi, j’ai ce problème : je clique “Nouveau message” et la page précédente se réaffiche.
      Aucun moyen d’envoyer une nouvelle news.

      Merci de nous donner une réponse...

    • Je me réponds...

      Résolu !

      Suite à éclaircissement de “Jack” (http://www.pyrat.net), il faut que tous les éléments qui constituent la newsletter soient dans une zone à accès non restreint pour que ça marche.

      Je viens de tester, et ... ça marche, en effet.

      Le problème est donc, pour moi, résolu.

    • Bonjour,

      La description du plugin me motivait à l’utiliser, mais j’ai besoin de diffuser par newslettre des informations issues de zones à accès restreint, pour les auteurs membres de la zone en question. Je pourrais composer 2 newslettres, l’une pour les infos publiques, l’autre pour les infos restreintes ... Mais je crois comprendre que cela ne marcherais pas.

      Une astuce ?

    Reply to this message

  • Serait-il possible de définir des autorisations pour ce plugin, car par défaut tout le monde peut y accéder ?

    Les liens pour cela ne sont pas affichés pour les administrateurs restreints et les rédacteurs, mais en mettant ?exec=clevermail_lists dans l’url de l’espace privé, cela affiche la page d’administration de CleverMail avec tous les droits.

    Reply to this message

  • Greeting,
    I’ve installed the Clevermail Plugin [3.0.11] to latest SPIP 3.0.19, everything fine exept I could not create a new email to send it to a list.

    When I go to the page

    /ecrire/?exec=clevermail_post_edit&new=oui

    I see only error message:
    “Impossible, ce message n’existe pas.”

    Is any ideas or solutions for this matter?
    Thanks in advance,
    Serge

    Reply to this message

  • obiwanriko

    Pour ceux que ça intéresse j’ai depuis maintenant plus de deux ans réussit sans soucis de stabilité ou conflits quelconques à faire fonctionner mon clevermail sous SPIP 3 dernière mouture comprise... Je peux faire un zip du plugin tel que je l’ai bien sûr... Mais de là où je suis pas de SVN que du FTP possible...

    Reply to this message

  • 4

    bonjour
    Je suis sur SPIP 2.1.24, j’utilise CleverMail 2.6.12 et facteur 1.8.9 et spip bonus 2.3.2
    J’ai déjà utilisé ce plugin qui fonctionnait correctement sur ce même site.
    Lorsque je clique sur nouveau message ça mouline et puis ça reste sur la même page avec en url :
    http://****-***.fr/ecrire/?exec=clevermail_lists&err_lst=1&err_msg=erreur_contenu_vide#lst1
    J’ai regardé dans le fichier mysql.log
    Dec 17 07:58:44 65.55.213.72 (pid 30880) Table ’nomdebase.POUR’ doesn’t exist - SHOW CREATE TABLE `POUR`
    Et dans prive_clevermail.log
    Dec 17 09:46:23 86.74.89.18 (pid 1448) Création d’un message dans la liste « Association du Locked-In Syndrome - Newsletter n°4 » (id=1) impossible, contenu vide à http://****-***.fr/spip.php?page=clevermail_nouveautes_html&date=1970-01-02&lst_id=1 et http://alis-asso.fr/spip.php?page=clevermail_nouveautes_text&date=1970-01-02&lst_id=1

    j’ai éssayé cette même version de clevermail sur un SPIP 2.1.12 en local et j’ai éxactement le même résultat :
    http://localhost/alis/ecrire/?exec=clevermail_lists&err_lst=1&err_msg=erreur_contenu_vide#lst1
    Contenu_vide ? j’ai pourtant du contenu à afficher ..(!!??)

    Merci pour l’aide q vous pourrez m’apporter
    Manu

    • ? un cas isolé ? .....incompatibilités de versions ? merci

    • quelqu’un pourrait-il m’aider ? j’me sens un peu seul là..

    • Bonjour,
      J’ai le même problème avec mon site Edition999 qui est en version 2.1.24
      Tout fonctionnait jusqu’à la mise à jour en version 2.1.24
      J’ai fait toutes les mises à jour possibles.
      J’avais envoyé plus de 50 newsletters avant ce problème.
      Merci de votre aide.
      Jean-Michel

    • Je bosse en local et j’ai le même souci. j’ai mis à jour et ça marche plus.

    Reply to this message

  • 2

    Bonjour,

    (Spip +clevermail+facteur)

    je voudrais supprimer l’intégralité des mes abonnés (plusieurs miliers !), afin de repartir sur une liste “saine”.
    Pour l’instant je n’ai trouvé que la supression un à un via l’interface utilisateur en cliquant pour chaque abonné sur “désabonner”.

    Il n’y aurait pas un fichier ç nettoyer ou supprimer pour supprimer tous les contacts d’un coup ?

    Merci d’avance !

    • Pourquoi ne pas tout simplement créer une nouvelle liste ?

    • Le moyen le plus sur pour faire un ménage massif sur la liste des abonnés est surement de vider la table spip_cm_subscribers via PhpMyadmin.
      En fait si on veut réinitialiser toute la mécanique il faut vider toutes les table spip_cm_xxxx et refaire une installation propre du plugin.
      Je donne cet avis car je n’ai pas trouvé d’autre méthode, mais je ne suis pas un expert.

    Reply to this message

  • obiwanriko

    Bonjour

    J’ai un problème avec le lien de désinscription dans mes lettres : http://www.xxxxxxx.fr/@@URL_DESINSCRIPTION@@ ne fonctionne pas, je ne suis redirigé vers aucun script ou fonction... Quelle est la syntaxe que doit prendre un lien de désinscription Clevermail ?
    J’ai cherché ici et dans la doc et j’ai rien trouvé...

    Merci d’avance

    Reply to this message

  • Bonjour,

    J’ai le pulgin Clevermail + facteur.
    L’interface de gestion des abonnés est pas terrible à mon goût : il ne peuvent être traités que un par un !

    Je voudrais totalement supprimer l’intégralité de mes abonnés (plusieurs milliers !), et à la main, c’est looooong !

    Je suppose qu’il y a un tmp ou un fichier qui contient toutes ces adresses, non ?

    Il est où le fichier pour que je puisse le supprimer ?
    Comment faire pour supprimer tous mes abonnés d’un seul coup ?

    Reply to this message

  • Bonjour,

    Lorque l’on envoie le message aux 27 abonnés, voici ce qui est mentionné

    ◦Modération des inscriptions : Ouverte
    ◦Automatisation des envois : Aucune automatisation
    ◦27 abonnés | Exporter la liste des abonnés
    ◦1 message : aucun en attente, aucun en cours d’envoi, 1 envoyé

    le mode modération est “ouverte”

    Impossible d’envoyer aux 27 abonnés

    merci

    cordialement

    Reply to this message

  • 1
    Christian.D

    Toujours embêté par la nouvelle version.

    J’ai les anciennes lettres et je voulais en créer une nouvelle, mais impossible. C’est peut-être ce qui explique le fait que je ne puisse pas modifier une ancienne lettre?

    Si quelqu’un a une solution, car ce plugin fonctionne super bien et ça m’ennuierait d’en changer.

    • ChristianD.

      Bonjour,

      Je viens de trouver la raison de mes difficultés.

      En fait, ne voulant pas perdre les anciennes versions de Clevermail, j’avais simplement renommé les anciens répertoires tout en installant la nouvelle version. Et ce soir, j’ai pris mon courage à deux mains et j’ai supprimé tous les anciens répertoires Clevermail. Et bien, figurez-vous que tout refonctionne.

      Dans la page Plugin, je revois tous ceux qui ont été installés. Et les modifications que je fais sont maintenant conservés. Ce plugin est toujours aussi bien, même en 3.0. C’est simplement son utilisateur qui n’allait pas ;-).

      Comme le dirait Droopy : “You know what? I’m happy”.

    Reply to this message

Comment on this article

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