SPIP-Listes

Une lettre d’information avec SPIP

Publié le : 30 novembre 2006 – Dernière modification le 21 décembre 2021 – par BoOz, Paladin, Stanislas – 2109 commentaires

144 votes

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.

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

Télécharger 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.