CleverMail

Publié le : 20 janvier 2010 – Dernière modification le 5 juin 2022 – par Nicolas Hoizey, scaron – 645 commentaires

1
2
3
4
5
82 votes

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 !

Notes

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

[2] CleverMail en propose un par défaut

[3] CleverMail en propose aussi un par défaut

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

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

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

Discussion

5 ans 1 an 3 mois Sans limite
par date
Filtrer

195 discussions

  • Lili29

    Bonjour à tous,

    je viens d’installer CleverMail, tout fonctionne impecablement, sauf une chose :

    La désinscription, la page s’ouvre avec une vingtaine de fois la ligne :

    Warning: cannot yet handle MBCS in html_entity_decode()! in /web/lesite/www/plugins/auto/clevermail_pour_spip2/balise/clevermail_unsubscribe.php on line 38

    le ligne 38 donne ça :

    	      $subject = (intval($list['lst_subject_tag']) == 1 ? '['.$template['@@NOM_COMPLET@@'].'] ' : '').html_entity_decode($list['lst_unsubscribe_subject'], ENT_QUOTES,'UTF-8');

    Je n’y comprends pas grand chose, ça dépasse mes compétences. Quelqu’un peut-il m’aider

    Par avance merci

    Répondre à ce message

  • 1
    fredjust

    Bonjour

    je viens de recevoir une lettre vide ?!
    est ce le fonctionnement normal ?
    je pensais que si aucun article n’était publié
    il n’y avait pas de lettre d’envoyée

    Merci

    • fredjust

      je viens de comprendre mon erreur
      en modifiant le squelette de lettre, j’avais supprimé la boucle conditionelle principale
      la lettre ne contenait pas d’article mais n’était pas vide pour le plugin

    Répondre à ce message

  • 1
    jc

    bonjour

    petit problème concernant ce plugin :

    lorsque je clique sur le lien de desincription, je recois bien un mail de confirmation.

    Probleme : lorsque je clique sur ce lien (dans l’email donc) il m’envoie sur une page me disant ceci :

    « Validation d’une opération

    Cette opération a déjà été validée. Désolé. »

    or après verif dans la partie admin, je suis toujours inscrit.... :-(

    une idée ?

    merci beaucoup !

    Répondre à ce message

  • chantoine

    Bonjour,
    Je teste Clevermail en remplacement de Spip_Listes. Mis à part l’export des abonnés à une liste, il me convient parfaitement.
    Par contre, chose bizarre, l’envoi d’une lettre à 135 abonnés donne le résultat suivant :
    Créé le 29/10/2011 à 12:33
    Envoyé le 29/10/2011 à 13:07
    42 messages envoyés
    Pourquoi 42 et pas 135 ?
    Merci Christophe

    Répondre à ce message

  • fredjust

    bonjour

    j’ai un léger problème avec la version de la lettre archivée sur le site
    le lien a href=« @@URL_LETTRE@@ » pointe sur .../spip.php ?page=clevermail_lettre&id=xx mais la page est vide !?
    par contre en apercu via l’interface privée le lien est .../spip.php ?page=clevermail_post_preview_html&pst_id=xx qui contient bien la lettre.

    J’ai modifié le squellete de la lettre en reprenant celui du plugin malettre le probleme peut il venir il de la ?

    merci

    Répondre à ce message

  • 5
    Gérard

    Bonjour,
    J’utilise Cleververmail sans souci depuis plusieurs mois sur http://cubacoop.org/ et je voudrais améliorer la présentation des résumés d’articles en y ajoutant les images des logos dans la version HTML.
    Quelqu’un pourrait-il m’aider en m’indiquant la meilleure façon de procéder pour modifier le fichier HTML de base livré avec le plugin et quelle serait la modification à faire pour ajouter l’affichage des logos ?

    Encore merci pour ce plugin qui marche sans soucis avec plus de 5000 abonnés à la newsletter mensuelle !

    • Gérard

      Pour infos, voici ci-dessous comment j’envisage de modifier le fichier HTML de base par l’ajout de la ligne 12 et l’ajout de l’affichage des brèves à la fin du fichier.
      Merci de me dire si cela est correct.

      #CACHE{0}#HTTP_HEADER{Content-type: text/html; charset=#CHARSET}
<B_articles>#SET{news,''}
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'><html>
<head><title>[(#ENV{date}|strtotime|=={82800}|?{#SET{news,"Les nouveautés n°1"},#SET{news,Les nouveautés depuis le #ENV{date}|affdate}})][(#GET{news}|textebrut)]</title></head>
<body>
<h1>@@NOM_LETTRE@@</h1>

<div>@@DESCRIPTION@@</div>
<p><a href="@@URL_LETTRE@@" title="<:clevermail:lire_en_ligne:>"><:clevermail:mauvais_affichage:></a>.</p>
<BOUCLE_articles(ARTICLES){age_relatif<=0}{par date}{inverse}{0,20}>
[<h2><a href="[(#URL_ARTICLE|url_absolue)]">(#TITRE)</a></h2>]
<p>[par (#LESAUTEURS|textebrut)][ le (#DATE|affdate)]</p>
[(#LOGO_ARTICLE|left|#URL_ARTICLE)]
[<div>
(#CHAPO|sinon{#INTRODUCTION})</div>]
</BOUCLE_articles>

<BOUCLE_breves(BREVES){age_relatif<=0}{par date}{inverse}{0,20}>
[<h2><a href="[(#URL_BREVE|url_absolue)]">(#TITRE)</a></h2>]
</BOUCLE_breves>

<p>Cliquez sur le lien suivant pour vous désinscrire : <a href="@@URL_DESINSCRIPTION@@">@@URL_DESINSCRIPTION@@</a></p>
</body></html>
</B_articles>
    • Gérard

      Pour tester, j’ai créé un fichier html que j’ai placé dans le répertoire du plugin clevermail et je déclenche l’envoi manuellement à moi-même en créant une lettre test avec ma pomme comme seul abonné.
      ça semble fonctionner malgré le message d’erreur ci-dessous que je n’arrive pas à interpréter :

      Multiple Choices

      The document name you requested (/spip.php) could not be found on this server. However, we found documents with names similar to the one you requested.
      Available documents :

      /spip ?page=type_urls&exec=clevermail_posts&lst_id=3 (common basename)

      Cela vient peut-être du fait que j’ai mis le fichier au mauvais endroit ?

    • Nicolas Hoizey

      Pour tester, j’ai créé un fichier html que j’ai placé dans le répertoire du plugin clevermail

      Le mieux serait que tu places ce fichier parmi tes squelettes, ce n’est pas très « propre » de le mettre dans le plugin.

      ça semble fonctionner malgré le message d’erreur ci-dessous

      Jamais vu, aucune idée de ce que cela peut signifier.

    • Gérard

      Merci Nicolas pour le conseil, j’ai donc placé mon fichier modifié dans le répertoire squelettes et ça fonctionne, le message bizarre apparaît toujours, il ne vient donc pas de la localisation du fichier.

    • fredjust

      Bonjour

      j’ai eu également envie d’améliorer la présentation de la lettre,
      car hormis ce détail ce plugin est parfait.
      N’étant pas compétant en CSS j’ai simplement repris la mise en forme
      que le plugin ma-lettre propose.
      Il suffit pour cela de partir du fichier squelette malettre.html et de modifier la sélection des
      articles en reprenant celle de clevermail_nouveautes_html.html.
      (Cela serait une bonne amélioration que de proposer d’autres squelettes de lettre).
      J’utlise donc maintenant les 2 plugins clevermail pour les envois automatiques des dernieres nouveautés et malettre pour envoyer une sélection d’article.

      a+

    Répondre à ce message

  • mirobolus

    Bonjour Nicolas !
    Je suis une grande fidèle de Clevermail et j’ai une nouvelle question pour toi : j’utilise Inscription2 pour enregistrer des données complètes sur mes visiteurs et leur proposer un formulaire d’inscription à un événement programmé par mon client dans son agenda.
    Les inscrits via ce moyen héritent du statut de « visiteurs ».
    Existe-t-il une combine pour que ces visiteurs soient automatiquement inscrits à la newsletter de Clevermail, quitte à ce qu’ensuite ils se désabonnent par les moyens classiques que tu proposes ?
    Je te remercie.

    Répondre à ce message

  • 1
    sabah

    Bonjour merci pour ce plugin fantastique.
    Le seul souci que j’ai c’est l’envoi à mes 1800 abonnés qui met plus d’une semaine, si j’ai bien compris c’est le nombre de visites sur le site qui déclenche l’envoi. Mon souci c’est que le site n’est pas très visité, et la news ne déclenche pas non plus un grand nombre de visites car elle annonce juste la date de la prochaine exposition. J’ai essayé différents réglages mais sans grand succès. J’envoie la lettre par lot de 50, avec la fonction mail de php, avec le smtp c’est pire. Mon site est hébergé chez ovh.
    Y a-t-il une astuce pour accélérer l’envoi ? Un utilisateur m’a conseillé de réduire le déali du cache ce que j’ai fait, mais l’amélioration est à peine visible. En 4 heures j’ai envoyé 18 emails à ce rythme-là…

    merci

    • Nicolas Hoizey

      Tu peux faire une bête page SPIP sans cache que tu requêtes toutes les minutes depuis un cron, cela simulera des visiteurs...

    Répondre à ce message

  • sabah

    Bonjour merci pour ce plugin.

    Le seul souci que j’ai c’est l’envoi à mes 1800 abonnés qui met plus d’une semaine, si j’ai bien compris c’est le nombre de visites sur le site qui déclenche l’envoi. Mon souci c’est que le site n’est pas très visité, et la news ne déclenche pas non plus un grand nombre de visites car elle annonce juste la date de la prochaine exposition. J’ai essayé différents réglages mais sans grand succès. J’envoie la lettre par lot de 50, avec la fonction mail de php, avec le smtp c’est pire. Mon site est hébergé chez ovh.
    Y a-t-il une astuce pour accélérer l’envoi ? Un utilisateur m’a conseillé de réduire le déali du cache ce que j’ai fait, mais l’amélioration est à peine visible. En 4 heures j’ai envoyé 18 emails à ce rythme-là…

    merci

    Répondre à ce message

  • JPADAL

    Bonjour,

    Je découvre Clevermail et j’ai un petit pb : quand je clique sur un lien, celui-ci est une invitation a accéder à la partie privée. Exemple :
    http://www.dunkerque-benevolat.fr/ecrire/?exec=articles&id_article=504
    Comment obtenir des liens pointant directement le bon article ?

    Question subsidiaire : comment s’envoyer la newsletter à soi même uniquement afin de corriger d’éventuelles « erreurs ».

    Merci à vous !

    Jean-Pierre

    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 :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

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

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom