SPIP-Listes permet la gestion et l’envoi de lettres d’information (newsletters) au moyen d’un courriel au format html ou texte.
Il est possible d’envoyer des messages aux abonnés qui se sont formellement inscrits à une ou plusieurs lettres d’information via un formulaire d’inscription.
Consulter la foire aux questions de SPIP-listes
Fonctionnalités
- Système personnalisé de gestion des abonnements (inscription, résiliation, changement de format),
- Envoi de messages électroniques au format texte ou html,
- Possibilité de composer une newsletter à partir de l’éditeur de SPIP,
- Possibilité de composer automatiquement une newsletter au moyen d’un squelette SPIP,
- Possibilité de déclencher manuellement l’envoi des messages ou de programmer un envoi automatique à échéance régulière,
- Prévisualisation des newsletters avant envoi,
- Archivage des newsletters envoyées,
- Gestion Multi-listes,
- Module d’importation et d’exportation de liste d’adresses électroniques,
- Option d’envoi par SMTP, avec le support éventuel de SSL.
Nota : Depuis la [version 1.9.2] l’installation du plugin crée deux nouvelles tables dans la base de donnée de SPIP. Le plugin utilise également les auteurs et les visiteurs inscrits dans la base du site.
Mise en place du plugin
** Installation **
Téléchargez SPIP-listes. Placez le contenu du fichier « zip » dans le répertoire /plugins (voir aussi la doc de SPIP), et activer le plugin SPIP-Listes.
Seuls les administrateurs du site ont les droits suffisants pour configurer et utiliser SPIP-listes.
Lorsque vous mettez à jour votre site SPIP de la version 1.8 à 1.9, vous devez :
- installer le plugin en même temps que la version 1.9 de SPIP sous peine de perdre les listes déjà crées...
- nettoyer votre fichier « ecrire/mes_fonctions.php » des codes de l’ancienne version de SPIP-listes (champs extras, includes).
** Ajouts aux squelettes **
Dans vos squelettes où vous souhaitez gérer les formulaires d’inscription, de résiliation et de modification des abonnements, insérez les balises #FORMULAIRE_ABONNEMENT et #FORMULAIRE_MODIF_ABONNEMENT.
Par defaut la page abonnement.html propose ces formulaires.
Un formulaire simplifié facile a modifier (CVT en SPIP 2) est également disponible, #FORMULAIRE_SPIP_LISTES_INSCRIPTION
. Idéal pour la page d’accueil su site par exemple.
Vous pouvez également personnaliser le formulaire d’abonnement.
Placer la balise #SPIP_CRON sur les pages du site public (si elle n’y est pas déjà).
** Boucles, balises, filtres et formulaires de SPIP-Listes **
Formulaires
- #FORMULAIRE_ABONNEMENT : Affiche le formulaire d’inscription. Ce formulaire peut être personnalisé (cf. l’article sur les Formulaires)
- #FORMULAIRE_MODIF_ABONNEMENT : affiche le formulaire de modification personnel d’un abonné
- #FORMULAIRE_INSCRIVEZ_VOUS (SPIP-Listes 1.9.3) pour s’incrire en un clic. Ce formulaire peut être personnalisé (cf. Formulaire d’inscription en un clic)
Balises
- #DATE_MODIF_SITE : date de la dernière publication (article ou brève) sur le site
- #DATE_MODIF_FORUM : date de la dernière publication d’un message de forum
Filtres
- (#DATE : affiche « depuis le » avant le nombre de jours précédant un envoi.
- (#TEXTE : permet d’afficher le texte dans une boucle MESSAGES.
Boucles
- <BOUCLE_archives(MESSAGES) {!par date}>
: affiche les derniers messages envoyés
MAJ avec spip 1.9.2 la boucle devient - <BOUCLE_archives(COURRIERS) {!par date}>
exemple complet :
<BOUCLE_archives(MESSAGES) {!par date}>
<a href="spip.php?page=courrier&id_message=#ID_MESSAGE">#TITRE - (#DATE)</a>
</BOUCLE_archives>
Note : si vous utilisez les messages de la messagerie spip ou que vous avez besoin de distinguer les courriers des messages automatiques, alors vous aurez peut-être besoin de préciser le critère {type=nl} ou {type=auto}
dans la boucle.
- <BOUCLE_1(ARTICLES) {statut=liste}>
: Affiche les listes d’information disponibles
MAJ avec spip 1.9.2 la boucle devient - <BOUCLE_1(LISTES) {statut=liste}>
- Et pour afficher un courrier envoyé dans un squelette courrier.html par ex :
<BOUCLE_courrier(MESSAGES) {id_message}>
<strong>#TITRE</strong><br />
[(#TEXTE|supprimer_destinataires)]
</BOUCLE_courrier>
<a name="#courrier"></a>
Envoi d’un nouveau courrier
Cette fonction vous permet de rédiger un e-mail pour l’envoyer à une liste d’abonnés. Comme pour un message traditionnel dans la messagerie de SPIP, les raccourcis SPIP et le Html sont acceptés.
Vous pouvez pré-visualiser le courrier jusqu’à ce que le contenu et la forme vous conviennent.
Vous pouvez choisir de l’envoyer à tous les abonnés, ou aux abonnés d’une liste en particulier (voir section « Nouvelle liste de diffusion »).
** Rédiger un courrier HTML **
Cas 1 : Entrez le texte du courrier et son code html dans l’éditeur de SPIP-listes.
Cas 2 : Vous pouvez aussi vous appuyer sur un patron (voir la section « Définir des patrons ») en important dans l’éditeur le code html qu’il génère. Il vous suffira de modifier ou de compléter ce code après l’import. Cliquez sur « Nouveau courrier », puis « Choisir un patron pour le courrier » (en sélectionner un), puis « Générer le message », ensuite cliquez sur « Valider », puis « Confirmer » et enfin « Modifier ».
Attention : si les boucles du patron ne retiennent aucun contenu (exemple : il n’y a pas eu de nouveautés), vous importerez un message vide...
Important : si vous utilisez un éditeur Html externe ou un patron, ne copiez dans le corps du message à envoyer que ce qui est strictement compris entre les balises <BODY> ... </BODY>
(ne copiez pas les balises BODY...).
N’oubliez pas que les messages html vont être lus par des clients de messagerie (et non par des navigateurs). Aussi, vos messages et patrons ne doivent contenir que des balises html simples et les styles css dans les balises html (<div style="styles ici">
). Pour les images, utilisez des adresses absolues (exemple : http://mon-site.fr/puce.png). Par défaut, les images et documents joints ne sont pas envoyées avec le message, mais chargés depuis l’Internet à l’ouverture du courriel.
Afficher des images avec des adresses absolues
Voici quelques exemples
- [(#LOGO_ARTICLE||abs_url)]
- [<img src="#URL_SITE_SPIP/(#LOGO|fichier)" >]
- [<img src="#URL_SITE_SPIP/(#FICHIER)" >]
Attention n’envoyez pas des messages trop lourds : considérez que 10ko est un maximum !
Présentation de l’interface dans l’espace privé
L’installation du plugin crée un sous-menu « Lettres d’information » dans le menu « Édition » de Spip.
******* ici bientôt une magnifique capture ***********
L’interface de gestion par défaut présente trois onglets sous le menu général de Spip :
« Historique des envois », « Listes de diffusion » et « Suivi des abonnements »
******* ici bientôt une magnifique capture ***********
et un menu « Raccourcis » avec les items :
« Nouveau courrier » « Nouvelle liste de diffusion » « Import / Export » « Configuration »
******* ici bientôt une magnifique capture ***********
Configuration de SPIP-listes
** Mode d’inscription des visiteurs **
Abonnement simple : no comment...
Abonnement avec code d’accès : vos abonnés ont également un code d’ accès à l’espace public (statut visiteur).
L’abonnement en tant qu’auteur est également possible
******* ici bientôt une magnifique capture ***********
** Méthode d’envoi des courriels **
Fonction php (attention si elle est désactivée sur votre hébergement, vous ne pourrez pas utiliser SPIP-listes)
Envoi par serveur SMTP (optionnel) : renseigner les champs hôte (nom du serveur) et port (en général : 25)
******* ici bientôt une magnifique capture ***********
** Patrons disponibles **
(voir la section « Définir des patrons »)
******* ici bientôt une magnifique capture ***********
Tableau de bord
******* ici bientôt une magnifique capture ***********
Import / Export
L’importation d’une liste d’abonnés s’effectue avec un fichier texte (*.txt) ne comportant qu’une adresse e-mail par ligne. L’exportation utilise le même format.
Nouvelle liste de diffusion
** Intérêt de la fonctionnalité **
Si vous souhaitez pouvoir programmer un envoi automatique régulier ou proposer plusieurs listes d’abonnement, vous devez créer une ou plusieurs listes de diffusion.
Vous pourrez définir un rythme d’envoi automatique différent pour chacune des listes créées. (voir la section « Configuration de la liste et programmation de l’envoi automatique »)
Si vous décidez de ne pas utiliser la création d’une liste pour votre newsletter, consultez la section « envoi de courriers ».
Nota : le formulaire d’inscription sur le site public s’adapte en fonction de l’absence ou de l’existence d’une ou de plusieurs listes de diffusion. Il laisse naturellement à l’internaute le choix de s’inscrire à une ou plusieurs des listes proposées.
Le mail n’est envoyé qu’aux abonnés qui se sont formellement inscrits à la lettre d’information.
Le choix du format de réception est déterminé à l’inscription et chaque abonné peut modifier ses options d’abonnement en suivant une procédure d’identification par e-mail.
** Création d’une liste **
Pour créer une liste, cliquez sur « Nouvelle liste de diffusion » et tapez un titre (par exemple :« Actualité du site ») et validez.
Le masque suivant permet de configurer et de programmer un envoi automatique à destination de la liste. Ce masque peut être complété plus tard : pour cela il suffit de cliquer sur l’onglet « Listes de diffusion » et de cliquer sur le nom de la liste à modifier.
La composition du contenu d’un message automatique s’opère au moyen d’un squelette appelé « patron » (voir la section « Définir des patrons »).
** Configuration de la liste et programmation de l’envoi automatique **
- Le lien « Modifier cette liste » vous permet de modifier le nom de la liste et son descriptif.
- Dans la liste déroulante choisissez le type « publique » ou « interne ». Le formulaire d’inscription ne propose un abonnement qu’aux seules listes publiques. La liste interne n’est donc pas affichée dans le formulaire d’inscription public, ce type de liste a une vocation de test ou de listes réservées par exemple aux admins ou aux responsables du site.
- Si elle est différente de l’adresse du webmestre, indiquer une adresse de retour.
- Activez l’option « Programmer un envoi automatique », puis effectuez le choix du patron (voir la rubrique « patrons ») et indiquez la fréquence d’envoi (en jours). Le patron sera envoyé à la liste tous les X jours. Vous pouvez décider d’activer un envoi immédiat pour initialiser la newsletter automatique : en cochant la case, la date de référence du patron sera fixée à X jour dans le passé pour le premier envoi, X correspondant à la période indiquée.
** L’envoi de la newsletter **
L’envoi est traité par SPIP-listes grâce à un script appelé en tâche de fond par les pages de SPIP via le cron. Tant que le message n’est pas envoyé à tous les destinataires inscrits, la console d’administration de SPIP-listes indique que le message est en cours d’envoi. Lorsque le message a été envoyé à tous les destinataires, il est passé en archives.
Les abonnés recoivent :
- le message en Html
- ou une version traduite automatiquement en format texte
Définir des patrons
Les patrons sont des squelettes que l’on dépose dans le répertoire /patrons du plugin par ftp. Ils permettent de définir le contenu d’un message. Ils peuvent être employés lors de la rédaction d’un courrier ou pour un envoi automatique régulier à destination d’une liste.
De la même manière que les squelettes de votre site, vous devez donc définir les patrons que vous allez utiliser. Le plus simple, pour commencer, est de modifier le patron « nouveautes.html » en y ajoutant les boucles et le code HTML que vous désirez.
Important : Pour les messages automatiques, dans le code des patrons, le critère {age_relatif<=0}
permet de n’envoyer que les éléments publiés depuis le dernier envoi (chaque liste se souvient de la date du dernier envoi, et cette date est passée au patron au moment de l’envoi).
Vous pouvez créer autant de patrons que vous le souhaitez. Si vous avez réalisé des patrons, merci de contribuer au projet SPIP-listes en les partageant sur cette page du site : bourse aux patrons.
Les patrons proposés par défaut :
- patron « nouveautés » : envoi de l’introduction des derniers articles
- patron « nouveauté_forum » : envoi des derniers messages publiés dans les forums
Le suivi des abonnements
Les administrateurs ont une vue générale des abonnements. Ils peuvent le cas échéant modifier le statut d’abonnement pour un abonné en particulier.
Tous les courriers sont archivés
SPIP-listes garde en archive tous les messages envoyés et signale le fait qu’une lettre des nouveautés n’a pas pu être envoyée, faute de contenu suffisamment récent.
Ce qu’il reste à faire
Pour tout le monde :
- faire de beaux squelettes/patrons et les partager
Pour les codeurs :
- Voir la TODO
Vous pouvez laisser vos questions, vos retours, vos idées sur le forum, et si le script vous plaît et vous rend service, ça serait sympa d’inscrire votre site dans la liste des sites qui utilisent spip-listes.
Amusez-vous bien.
Discussions par date d’activité
737 discussions
Bonjour
La génération des courriers à partir d’un age relatif ne fonctionne plus.
Je choisis « Créer un courrier »,
je sélectionne le patron « Nouveautés »,
J’indique une date très antérieures (pour être sûr d’attraper des nouveautés).
Je coche « A partir de la date définie ci-dessus », ou je décoche => même résultat.
Je clique sur « Générer et Aperçu »
=> Le début du courrier est bien généré « Bonjour, voici les nouveautés publiées.... »
Mais ensuite, c’est vide.
J’ai analysé et tenté de modifier le patron nouveautes.html. Il semble qu’il y ait un problème par rapport au critère de boucle age_relatif. J’ai l’impression que la date prise comme référence ne soit pas bien lue dans le contexte.
J’ai ce problème depuis la migration sous SPIP3. Plus aucune de mes listes ne fonctionnent. Pourtant j’ai bien mis à jour le plugin et j’ai la dernière version.
MERCI DE VOTRE AIDE.
Je confirme !
SPIP 3.0.11 + spip-listes v3.0.11 : il semble qu’on n’ait plus le choix dans la date. Si je peux me permettre d’être crétin. C’était mieux avant :-)
Dans créer un nouveau courrier/Générer le contenu/Contenu à partir de cette date : 16 août 2013 à 16h00min, la date est bloquée au présent.
Qu’on la change par le calendrier ou dans la champ input du formulaire n’a l’air d’avoir aucune influence sur le contenu qui reste bloqué : « Contenu à partir de cette date : 16 août 2013 à 16h00min »
Répondre à ce message
J’ai essayé de comprendre pourquoi il y avait un bug entre autre au moment du passage du patron « Nouveautés ».
Il semble qu’il n’y a pas de transmission de la date qui reste un champ vide.
C’est une piste mais je ne sais pas la résoudre.
à suivre
Répondre à ce message
Bonjour,
Dans l’interface d’administration, sous IE10, pour le choix du destinataire, la destination « liste de diffusion » ne s’affiche pas ainsi que le bouton « Valider ».
OK sous FF.
bc
Répondre à ce message
Bonjour à tous,
CONFIG = SPIP 2.1.23—
- SPIP-Listes 2.234.4-67343 <1.98> jQuery 1.4.4
- CFG — COUTEAU SUISSE
depuis le passage à la branche SPIP 2.1 les patrons affichent page blanche pour les articles ( le logo site et message de bienvenu sont affichés ainsi que date et NOUVEAUTE)
J’ai suivi quelques conseils sur les forums dédiés mais rien n’y fait
Une idée pour m’aider ?
Merci d’avance
Ostokin
Pas de suggestion ?
Petit complément quand je génère un appercu avec le patron NOUVEAUTE
J’obtiens :
Cr�er un courrier
Si je donne un titre c’est ce titre qui apparait en remplacement de « crée un courrier »
Merci de votre aide
OSTOKIN
Répondre à ce message
J’ai installé Spip-Listes 3.0.11 sur mon site Spip 3.0.10 et impossible de générer le contenu à partir du patron « nouveautés ». Tous les autres fonctionnent mais pas celui-là et ce quelque soit la date que je demande à prendre en considération pour générer le courrier.
Le message généré reste désespérément vide.
Quelqu’un aurait-il une explication serait-ce un bug ?
C’est plutôt embêtant c’était une fonctionnalité intéressante.
Répondre à ce message
Bonjour,
je rencontre deux « bugs » étranges lorsque que je configure l’envoi automatique d’une liste de diffusion. Je choisis « tous les 1 jour » puis « la date d’expédition » et pour finir « envoyer maintenant », lorsque je confirme l’envoi, la date/heure d’expédition ne correspond pas à celle que j’ai choisie et dans le casier à courrier l’envoi ne se fait pas (mouline) et il est indiqué a coté du nom de la liste de diffusion « (aucun abonné) ».
Pour le reste le plugin fonctionnement parfaitement lorsque que je fais un envoi de courrier « simple » en choisissant la liste de diffusion, le problème est uniquement sur l’envoi automatique journalier.
Merci par avance.
Répondre à ce message
Bonjour,
Je travaille à un patron pour lister une partie du texte des articles ayant un mot clé donné.
Quand je construis le lien de l’article du site, #URL_ARTICLE me donne par exemple : http://www.cinehorloge.fr/ecrire/spip.php?article763 . Comment obtenir un lien sans « ecrire » :
http://www.cinehorloge.fr/spip.php?article763
Ma boucle est :
#INTRODUCTION
[
(#TITRE)
]
Salut,
pour l’url des articles, j’ai :
[(#URL_ARTICLE|url_absolue)]
Répondre à ce message
Bonjour à tous
J’ai un problème de taille qui est survenu de lui-même, aussi étonnant que cela puisse paraître.
je vais essayer de faire le plus cour et le plus complet possible.
Je suis sous
Spip : 2.1.12
SPIP-Listes 2.0200-48788 <1.98> jQuery 1.4.4
- Sur mon site j’ai une mailing list qui génère automatiquement un courrier par semaine.
- Jusqu’il y a quelque temps, la mailing list de mon site fonctionnait parfaitement.
- Cependant, voila que depuis un certain temps, les emails ne sont plus envoyé
au début j’ai cru que le mail n’avait pas été envoyé car il n’y avait pas eu de nouveaux articles publiés, mais ce n’est pas le cas.
Cherchant la solution j’ai pu me rendre compte que :
1- dans la page « édition ->liste de diffusion », mon casier à courrier contient bien mes « courriers automatiques publiés » chaque semaine comme prévu. cependant aucun destinataire n’as reçu les dit courriers (depuis quelques semaines)
2- dans la page "édition ->liste de diffusion -> onglet liste de diffusion, ma « liste publique hebdomadaire » existe toujours bien et compte toujours ses 729 abonnés (dont seulement 3 n’on pas choisi de mode d’envoi html/txt).
3- dans la page qui précède, je rentre dans ma liste et si je « force l’envoi » (en entrant dans les détails de ma liste de diffusion et cochant « envoyer maintenant » et validant (2 fois), le courrier soit-disant envoyer apparait dans les « courriers automatiques publiés » mentionnés en 1, ou non ??? selon ??? du coup je commence à plus savoir ce qui ce passe.
4- pour faire un test simple j’ai créer une nouvelle liste de diffusion dont je suis le seul destinataire.
je crée un courrier
4.1- si dans « destination », je choisi « tester par email » et l’adresse mail de mon login apparait (ce qui me convient)
quand je valide l’envoi à 2 reprises, ce courrier apparait dans la page « édition ->liste de diffusion » comme un courrier « en cours de rédaction » ne comptant « aucun destinataire »
4.2 -si dans « destination », je choisi « ma nouvelle mailing list dont je suis seul inscrit » quand je valide l’envoi à 2 reprises, ce courrier apparait dans la page « édition ->liste de diffusion » courrier publié" cependant je ne le reçoit pas
J’ai effectuer ces différents tests afin de vérifier si le problème venait de la mailing list elle-même ou de l’envoi et je pense pouvoir dire que cela vient de l’envois.
mais que faire ?
pourquoi la les envois ne s’effectuent plus ? (j’administre le site, mais il est hébergé chez un prestataire qui administre le service et je n’ai pas eu vent de modifications ou autre qui puisse entrainer ce genre de problèmes)
J’ai beau lire l’aide de spip-liste et regarder dans les configurations, je ne vois pas ce que je pourrais faire de plus.
jusqu’à présent, la « méthode d’envoie » utilisée est « utiliser la fonction mail de php »
Si l’un d’entre vous peut m’aider à régler ce problème j’apprécierais grandement toutes propositions.
Avec un grand merci pour votre attention
Bien cordialement
Jonathan
Bonjour,
dans un cas similaire, j’ai pu remonter à l’hébergeur (OVH) qui m’avait bloqué l’envoi des mails automatique, en raison d’un retour d’erreur supérieur à 5% (adresses erronées)
Si cela peut aider certains !!!
Cordialement, Alain
Répondre à ce message
Bonjour,
pour info,
le lien vers la bourse aux patrons est mort
http://contrib.spip.net/SPIP-Listes#patron
Répondre à ce message
Bonjour,
Je viens de vouloir installer Spip-liste sur un spip 3.0.10 mais lorsque je veux modifier un article, le formulaire n’apparait plus meme après avoir purger le cache.
Liste des plugins installés :
Recherche avancées
activité éditoriales
agenda
api de verification
autorité
champs extras
interface champs extras
compositions
compteur graphique
facteur
interface thelia
le couteau suiss
mini calendrier
poluhierarchie
recommander à un ami
saisies pour formulaire
sauvegarde auto
social tags
spip bonux
tinymce
yaml
Merci pour votre réponse si vous avez une solution au problème.
Olivier
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 : |