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 !
Discussions par date d’activité
195 discussions
Une autre question Nicolas : est-il possible d’indiquer plusieurs destinataires dans le champ ’E-mail return path’ ? Merci.
Il ne me semble pas que ce soit autorisé par les serveurs SMTP, à confirmer.
Ok, merci Nicolas.
Répondre à ce message
Bonjour !
J’ai définitivement adopté Clevermail sur les sites que je développe. Aujourd’hui, je dois l’installer sur un site multilingue. Avant de me lancer dans des traductions aléatoires, je voudrais savoir si quelqu’un a déjà traduit le fichier lang en : anglais ; espagnol ; portugais (eh oui...).
Merci d’avance !!
J’ai identifié 9 chaines qui concerneraient l’affichage public. Voici les traduc de mon cru (merci le web !!!!) mais s’il y a des portugais, espagnols et anglais, les corrections sont les bienvenues ;-)
Ce qui donne avec les caractères accentués :
Merci.
Pourrais-tu modifier directement cela sur la zone ?
Je vais attendre les corrections éventuelles à faire et je posterai les traducs définitives sur la zone. OK.
Répondre à ce message
Bonjour,
J’aimerais faire un système de newsletter qu’un éditeur ou admin pourrait modifier simplement à « la main » avant chaque envoi.
Du côté de la newsletter HTML, je pense avoir trouvé la ruse en faisant pointer la newsletter vers un article dédié que les utilisateurs du site peuvent modifier dans l’interface privée comme n’importe quel article avant l’envoi.
Par contre je ne sais pas trop comment je pourrais obtenir un rendu texte seul de ce même article pour la news...
Avez vous des idées ? Ma démarche est bonne ou je tords le coup au plugin en faisant ça ?
Merci d’avance !
:-)
La version texte de démo est produite automatiquement à partir de la version HTML, donc ça devrait aller aussi.
Merci Nicolas, je testerai tout ça.
Répondre à ce message
Bonjour,
Nous avons installé Clevermail sur plusieurs sites, un client vient de nous faire remarquer que les fichiers d’abonnés sont en libre accès dans le répertoire IMG/ de chaque site, exemple : http://votrenomdedomaine.com/IMG/liste_1_25_May_2011_10_20_47.csv
Créer un fichier index.html à la racine de IMG et un robot.txt pour éviter cette faille de sécurité
A corriger lors d’une prochaine version, merci
Je ne vois pas le rapport avec CleverMail. D’où vient ce fichier CSV ?
C’est la liste d’abonnés générée par Clevermail
CleverMail ne génère pas de listes d’abonnés, c’est d’ailleurs un manque signalé ici à plusieurs reprises ! ;-)
Répondre à ce message
Bonjour Nicolas,
J’utilise Clevermail depuis 2 mois et je viens seulement de comprendre qu’il peut envoyer des mails automatiquement ;-)...
Cette fonctionnalité m’intéresse mais entre la fréquence hebdomadaire et la fréquence mensuelle, il n’y a rien. En fait, un rythme toutes les 2 semaines serait super.
Il y a une astuce pour le faire sans casser tout ?
Merci d’avance.
Christian
Le problème est de réussir à ajouter cela sans surcharger l’interface qui est déjà bien complète.
On devrait pouvoir ajouter une fréquence « tous les n jours », et tu mettrais 14, mais je n’ai vraiment pas le temps de me pencher dessus pour l’instant...
Bon, pas d’urgence.
Je triche en mettant « automatisation/hebdomadaire » une semaine sur 2 :-).
Bonjour
Je suis sous spip 2.1.8 / Facteur 1.6.2 / CM 2.5.2 (tout à jour). Et je ne comprend pas pourquoi j’ai ça :
Alors que j’ai qu’un seul gabarit lettre.html (placé dans squelettes). Pourquoi me l’envoit-il en double avec 2 dates différentes ? Et là il est prêt à me refaire le coup avec le 20 mars et le 27 mars ??? Voici les logs :
Quelle est la configuration de la lettre ?
Merci de vous pencher sur ce problème dont je ne vois toujours pas l’origine.
Voici la configuration :
Et voici la version texte brut du squelette, qui est plus simple à lire que la version html :
Pour résumer il faut lancer 2 fois « nouveau message ». Il nous fabrique 2 lettre avec 2 dates différentes. On supprime la première et on envoie la seconde. C’est pas très grave, mais bon du coup on ne peut pas faire en automatique, sinon il envoie la newsletter avec la date de la semaine passée. Pour rappel le tout 1er envoi datait du 2 janvier 1970, un quelqu’onque rapport avec l’an 0 de l’ère informatique ?
La date de l’envoi précédent est passé en paramètre lors de la création du message, pour éviter d’envoyer un contenu déjà envoyé la fois précédente.
Du coup, c’est effectivement le 2 janvier 1970 qui est passé en paramètre pour le premier envoi (le 1er janvier provoque un bug).
Dans ton squelette, #DATE indique donc la date de l’envoi précédent, logique que ce soit la date de la semaine passée pour un envoi hebdomadaire.
Il faudrait juste que tu n’utilises pas #DATE pour indiquer la date d’envoi.
Hmm et donc une solution pourrait consister à par exemple placer un
En dehors de la boucle et un
à l’intérieur pour être définitivement débarrassé de ce problème ?
Répondre à ce message
Bonjour, une erreur lors de l’installation du plugin ce jour :
« Installation du plugin CleverMail pour SPIP 2.0
Warning : Invalid argument supplied for foreach() in D :\xampp\htdocs\ac\ecrire\req\mysql.php on line 646
OK »
Merci pour le plugin
J’ai aussi constaté cette erreur, mais pas encore trouvé d’où elle vient. Elle ne semble de toute façon pas avoir d’impact.
Répondre à ce message
Bonjour Nicolas,
Ca y est, je commen à maitriser CleverMail après 4 mois. Il serait temps ;-).
Je viens de faire un nouvel envoi mais j’ai l’impression que les courriers ne sont pas partis pour tous. Je me suis inscrit dans la liste des abonnés, pour voir ce qui arrivait, et je n’ai pas reçu le mail. D’où ma question.
Comment voir-suivre les messages effectivement sortis ? Quand je dis message, il faut plutôt comprendre les adresses mails qui ont fait l’objet d’un envoi effectif. J’ai d’un côté la liste des abonnés et le fichier préparé en visu. Il ne manque que les envois traités.
Ca existe quelque part ?
Merci d’avance.
Christian
Il n’y a pas d’interface prévues, mais les données sont en base.
Répondre à ce message
Bonjour,
j’ai un petit soucis avec les Tags spécifiques @@NOM_TAG@@.
sur le visu public de la lettre (via le lien qui est indiqué dans le mail de l’abonné) j’ai ceci :
et tt en bas :
je suis sur un spip 2.1.10, clevermail 2.5.4, facteur 1.6.2
merci pour votre aide
PY
La prévisualisation est par essence non personnalisée, donc ces variables ne sont pas remplacées, c’est normal.
Répondre à ce message
Problème résolu !
Problème résolu !
Répondre à ce message
Bonjour,
Tout d’abord bravo et merci pour ce plugin très pratique.
Au cours de mes tests, je m’aperçois que, dans un message envoyant aux abonnés les dernières nouveautés, apparaissent les liens vers des articles situés dans des zones d’accès restreint. Bien évidemment, si le lecteur clique sur ce lien, il est dirigé vers la page d’authentification, mais j’aimerais savoir s’il est possible de filtrer ces articles en amont pour qu’ils n’apparaissent pas du tout dans le message ; mes maigres connaissances de SPIP ne me permettent pas, pour l’instant, de savoir comment modifier le squelette pour y parvenir. Pourriez-vous m’indiquer une piste ?
Merci
Thierry
Le contenu est généré par un squelette, donc si les contenus sont en accès restreint (on parle bien du plugin éponyme ?), ils ne sont listés lors de la génération du contenu que si on le génère manuellement, en étant connecté avec un compte y ayant accès.
Il faudrait tester en générant le contenu depuis un compte n’ayant pas accès, pour vérifier.
Merci, vous devez avoir raison, je vais voir comment ça se passe pour un envoi automatique.
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 : |