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
Bonjour,
Comme souvent je suis un cas à part, j’ai parcouru presque tous les messages et je n’ai pas trouvé réponse, je dois donc être le seul.
Dans les explications sur l’installation, il est indiqué pour les inscriptions à la lettre de mettre la balise #FORMULAIRE_CLEVERMAIL, je suppose que c’est dans un squelette, chez moi ça marche pas, bien sur je suis en local, y a-t-il une explication ?
Merci
Bonjour,
J’ai exactement le même problème ! Où doit-on mettre cette balise ?
Merci d’avance.
Avez-vous modifié le statut de la lettre pour que l’inscription ne soit plus « fermée » mais « ouverte » ou « modérée » ? En l’absence, le formulaire d’abonnement ne s’affichera pas !
Répondre à ce message
Bonjour,
J’ai un problème au sujet de la fonction extraire, qu’il faut apparemment ajouter dans un fichier en php. En effet, quand j’essaie d’afficher ma lettre (reçue en mail) sur le site, j’ai un message d’erreur : la fonction « extraire » n’est pas définie. Quelqu’un avait ce souci, plus bas dans une discussion, mais il n’y avait pas de réponse, alors je retente.
Comme je suis un peu novice, je me demande : faut-il ajouter la fonction extraire (qui se trouve dans le fichier clervermail_lettre_fonction.php) dans le fichier clevermail.php, et le mettre dans le répertoire squelette Sinon que faut-il faire exactement ?
Merci d’avance !
bonjour,
j’ai rencontré le même probleme, j’ai placé le fichier « clevermail_lettre_fonctions.php » qui se trouve dans le dossier plugins, dans mon dossier squelette et ça fonctionne. En revanche pour le moment chez moi, les variables de type « @@DESCRIPTION@@ » ne sont pas remplacées quand elles sont affichées sur le site alors qu’elles le sont bien dans le mail reçu
Répondre à ce message
Bonjour, je commence depuis peu sous SPIP.
J’ai installé clevermail. tout à l’air de bien se passer.
Je souhaiterai créer 2 lettres d’information mais qui chacune ne ferait apparaitre les nouveautés que d’une rubrique.
Je pense qu’il faut modifier ou créer un fichier du genre « clevermail_nouveautes_html » et après l’appeler dans la config de chaque lettre à l’item « URL des templates générés ».
Je ne pense pas que ce soit bien compliqué, mais je ne sais pas comment modifier ce fichier html.
Si quelqu’un peut m’aider ce serait sympa.
Merci d’avance
seb
Bonjour, j’ai essayé rajouter « id_rubrique=3 » comme on me l’a suggéré mais cela ne fonctionne pas. Ca donne :
J’ai fait aussi :
Mais cela ne fonctionne pas.
Erreur de syntaxe ?
Est ce que cela sélectionne également les sous rubrique ?
Merci de votre aide.
seb
Répondre à ce message
Salut
Je ne sais pas si c’est le même problème mais quand je fais un envoi manuel, rien ne se passe mais l’url de la page devient
http://monsite/?exec=clevermail_lists&err_lst=3&err_msg=erreur_contenu_vide#lst3
Je vois bien contenu vide, or les boucles de mon squelette de la lettre d’information renvoie plusieurs articles
Tous les plugins à jour et spip 2.1.10... Une petite idée ?
Merci d’avance
Répondre à ce message
Bonjour à tous,
Il m’est impossible de créer un nouveau message avec CleverMail 2.5.4 et spip 2.1.10 ... Le clic sur « nouveau message » mouline, puis rien...
Je suis sur que ma page n’est pas vide (celle qui générer le message).
La page est bien compilé (vu dans les logs)
Aucune erreurs dans mes log serveur...
Facteur fonctionne, dernière version de spip-bonux...
visiblement, cette adresse :
http://monsite/ecrire/?exec=clevermail_lists&action=clevermail_post_create&arg=1&hash=7b39b8c08eaf6888de65ee476c8b117f610a0b0f&redirect=http%3A%2F%2Fmonsite%2Fecrire%2F%3Fexec%3Dclevermail_posts%26amp%3Blst_id%3D1
est « not found (302) »
Je me suis ’interrogé sur ce type de boucle : , car il me semble que maintenant il faudrait écrire ,mais en fait le problème ne semble pas venir de la...
J’ai lu les anciens postes concernant des problèmes similaire, mais sans y trouver de réponse...
S’agit t-il d’une incompatibilité connue et permanente ?
Sam
Bonjour, j’ai eu le même problème sur mon site en local, même après configuration du facteur avec un compte smtp. Mais une fois mon site hébergé, ça a fonctionné.
Bonjour onix88, je suis déjà en ligne...
Quelles sont tes versions stp ?
Est-ce que cela fonctionne mieux en mettant juste le nom du squelette, plutôt qu’une URL ?
Répondre à ce message
Bonsoir,
après plusieurs mises à jour (SPIP 2.1.10 , CleverMail pour SPIP 2.0
2.5.4 et Facteur 1.7.0), soit j’obtiens un message d’erreur lors de la modification d’un message (ce champs est obligatoire) soit le message part mais en « multipart/alternative » et le code html est affiché en clair dans les messages reçus du genre :
et cela avec mon template modifié ou le template par défaut du plugin :
http://www.gdac.org/spip.php?page=clevermail_nouveautes_html
une idée pour corriger ce comportement ?
Merci d’avance pour l’aide et le plugin,
Tonio
J’avoue ne pas trop savoir où creuser, là.
Des bugs sont apparus dans le Facteur récemment, et ont été vites corrigés.
Sinon, côté CleverMail, il faudrait éventuellement essayer en configurant la lettre avec juste le nom du squelette plutôt que l’URL de sa page résultante,
clevermail_nouveautes_html
plutôt quehttp://www.gdac.org/spip.php?page=clevermail_nouveautes_html
.Répondre à ce message
Bonjour,
Je viens de m’apercevoir que le lien « Si vous ne visualisez pas cet email, lisez-le sur le site. » renvoie vers une page @@URL_LETTRE@@ qui n’existe pas sur le site. Le lien va donc pointer sur la page d’accueil du site.
Ce code ne devrait pas être remplacé par le nom de la page qui est mis dans les paramètres ? Il y a une manip à faire pour voir la page correctement ?
Merci de vos reponses.
Ce comportement est-il constaté lors de la prévisualisation, ou dans une lettre réellement reçue ?
Répondre à ce message
Bonsoir,
je viens d’installer CleverMail sur spip 2.1.10 et rien n’apparait dans le menu « Edition ».
Pas de petite enveloppe Clever Mail, rien.
Une idée ?
Merci
C’est de ma faute, j’ai effacé par erreur les instructions du
plugin.xml
. Je suppose que tu n’utilises pas le plugin Bandeau.Je corrige.
Bonsoir,
Merci pour la rapidité de la réponse. Non je n’utilise pas le plugin bandeau. Par contre Spip Bonux, qui est obligatoire, mets pas mal le bazar avec la version 2.1.10 ! Mais c’est une autre histoire !
Cdlt
Le seul soucis que j’ai avec Bonux est un conflit de fonction doublement déclarée avec Couteau KISS.
Répondre à ce message
Bonjour Nicolas (et les autres),
J’utilisais la version précédente qui fonctionnait très bien. Depuis la mise à jour 2.5.4, je n’ai plus le logo de l’article qui apparait dans les envois.
Pendant que j’écris, je me demande si ce n’est pas moi qui ait modifié le fichier...
Je viens de retrouver mes modifications...
Désolé pour le dérangement et encore une fois, très bon plugin !
Répondre à ce message
Bonjour,
Merci pour ce plugin.
Je l’utilise depuis peu, je suis encore en phase de test et suis confronté à un problème.
J’ai modifié le fichier clevermail_nouveautes_html.html afin qu’il donne le contenu et l’apparence voulue.
plusieurs scripts et css sont automatiquement rajoutés par spip suite à l’installation de plugin, comme par exemple l’appel à JQuery, le couteau_suisse, fancybox, porte plume, etc, etc... Ceci alourdit le mail et certains appel à des css ou des scripts ont l’url en relatifs et ne fonctionne pas.J’ai essayé de simplifié au maximum le squelette afin de ne pas surcharger inutilement le mail envoyé. Mais dans l’entête de la page
Est-il possible de bloquer l’ajout automatique de ce code dans le squelette de clvermail ?
D’avance merci pour vos réponses
As-tu la balise #INSERT_HEAD dans ton squelette ?
Merci pour ta réponse.
Je pense que oui car j’ai activé « Balise #INSERT_HEAD » du plugin « Couteau Suisse ».
C’est à cause de ça ?
Je vais tester en désactivant cette option.
C’est sans doute ça, oui.
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 : |