SPIP-Listes

Une lettre d’information avec SPIP

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.

******* 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 **

  1. Le lien « Modifier cette liste » vous permet de modifier le nom de la liste et son descriptif.
  2. 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.
  3. Si elle est différente de l’adresse du webmestre, indiquer une adresse de retour.
  4. 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.

Télécharger SPIP-listes

Discussion

737 discussions

  • 1

    Bonjour,
    quelqu’un a-t-il déjà essayé de passer ce plugin en SPIP 4 ? Un retour sur la question ?
    Merci ;)

    • Je ne pense pas. La trilogie mailshot/mailsubscriber/newsletter remplace efficacement ce plugin, et est maintenu.

    Répondre à ce message

  • 3

    Bonjour,

    Pour info pas de souci pour moi sur SPIP 3.2.0, après avoir corrigé du JS :

    Fichier : javascript/spiplistes_courrier_edit.js :
    -  remplacer « async:false » par « async:true »
    -  remplacer « $(this).attr(’checked’) » par « $(this).is(’:checked’) » (trois fois)

    Et fichier paquet.xml :
    => mettre compatibilite=« [3.0.0 ;3.2.*] »

    Si ça peut servir à quelqu’un ;)

    • Pourrais tu regarder si tes modifs js casse la compatibilité avec 3.0 et 3.1 ?

      Si ce n’est pas le cas, on modifiera directement la version distribuée, sinon il faudra en faire une nouvelle.

    • Bonjour.
      Je viens de faire les modifs indiquées pour un site spip 3.2.0 et j’ai créé une liste test. Pas de soucis si ce n’est que quand je vais sur les listes de diffusion et quand je clique sur la liste test j’arrive sur une page blanche...donc plus aucun moyen de la modifier.
      Une idée ?

    • Bonjour,
      quelqu’un a-t-il déjà essayé de passer ce plugin en SPIP 4 ? Un retour sur la question ?
      Merci ;)

    Répondre à ce message

  • 1
    Philippe Robin

    sous Spip 2.1 + facteur à jour + spip liste à jour + mailjet à jour : impossible d’envoyer un courrier via spip liste, alors que tous les autres plugin de mail fonctionne (je les ai tous essayé...)
    Même le test avec le plugin Facteur fonctionne bien.
    indice : à la création du courriel :

    Vérifier les droits d'écriture
     
    Le système a rencontré une erreur lors de l'écriture du fichier ../tmp/sessions/1_5880362669748885de4dc999e008da68.php. Veuillez, en tant qu'administrateur du site, vérifier les droits d'écriture sur le répertoire tmp/sessions.
    • Philippe Robin

      je me réponds : le bug est entre la chaise et le clavier

    Répondre à ce message

  • Bonjour

    Je déménage un spip 2.1.30 d’un serveur à un autre. Pour divers raisons, j’ai dû tranferer la base par un dump spip, et les composants de spip-listes ne sont pas tous passés sur le site 2.

    Aujourd’hui sur mon site 2, j’ai bien mes 1200 abonnés qui sont présents en tant que visiteurs mais ils n’ont pas le statut d’abonnés à ma newsletter.

    Si j’utilise la fonction export depuis mon site 1 puis import vers mon site 2, ça ne bouge pas, alors qu’il me signale qu’ils ont été inscrits.

    SI je « force les abonnements pour cette liste » ça m’en abonne 4 parfois...

    Comment faire pour que tous mes 1200 visiteurs deviennent des abonnés ?

    Répondre à ce message

  • 1

    Bonjour,
    J’ai mis a jour mon site vers spip 3.1.3 et mon plugin ne fonctionne plus, j’ai vraiment besoin d’aide pour adapter le plugin spip-liste a mon site. Merci de votre aide

    Répondre à ce message

  • 1

    Merci pour ce plugin génial et très souple avec ses patrons !
    Cela fait des années que je l’utilise et je le trouve simple et efficace pour l’utilisation prévue !

    Tout passe en spip 3.1 quand cela doit-il se produire pour ce super boulot ?

    • Le dernier commit « sérieux » sur ce plugin date d’il y a 20 mois : http://zone.spip.org/trac/spip-zone....

      SPIP-Newsletter est plus suivi désormais et la transition pas trop compliquée.

      Après, si des gens reprennent SPIP-Listes et l’adaptent, super hein ! Je n’ai d’actions ni dans l’un ni dans l’autre plugin...

    Répondre à ce message

  • 3

    Bonjour,

    J’utilise la version 3.0.11 de Spip-Liste et sur ma page de connexion à l’espace d’administration j’ai le message suivant : Warning : Illegal string offset ’id_auteur’ in /../../plugins/auto/spip-listes-spip3/balise/formulaire_abonnement.php on line 318.

    Quelqu’un a-t-il déjà eu cet avertissement et/ou saurait-il comment le corriger ?

    Cordialement,

    • Eric Luyckx

      J’ai le même problème.
      Avez-vous trouvé une solution ?

      Merci d’avance
      Eric

    • Eric Luyckx

      en faisant une recherche google sur la fin du warning
      « /balise/formulaire_abonnement.php on line 318 »
      on tombe sur plein de résultats de formulaires d’abonnement spip-listes :-/
      le bug est donc assez répandu

    • Eric Luyckx

      bon j’ai fait une modif qui semble fonctionner
      remplacer la ligne 318 par
      else if($connect_id_auteur = intval($GLOBALS['auteur_session']))
      sous réserve de tester plus en détail

    Répondre à ce message

  • 4

    Est-ce que quelqu’un a déjà essayé ce plugin sous spip 3.1 ??? Si oui, est-ce qu’il fonctionne ?

    • Bonjour.
      Non cela ne fonctionne pas. Version incompatible.

      Cordialement.

    • Merci pour la réponse. Je suis passé sous spip 3.1 début janvier. Une mise-à-jour est-elle prévue ou ce plugin est-il abandonné ?

    • Voilà, je viens d’installer, dans l’ordre, les plugins (Mailsubscribers, Mailshot et Newsletters) !

      Ensuite, j’ai désinstallé le plugin SPIP-Listes. J’ai pu ainsi retrouver intacte la liste de mes abonnés qui ont été parfaitement importé ainsi que mes anciens envois.

      Pour le patron (Newsletters appelle cela gabarit), j’ai simplement copié l’exemple fournit par le plugin Newsletters (newsletters/letter.html) dans mon répertoire squelettes/newsletters. Tout est bien expliqué sur la page du plugin.

      J’ai ensuite pris mon ancien patron, j’ai copié tout le contenu entre les balise body et j’ai remplacé le code dans le fichier letter.html entre la balises fermante des styles jusqu’à la la balise fermate de body.

      Et tout a fonctionné parfaitement ! :-)

    • Bonjour.
      Je viens de faire votre install également sur un serveur de test. Et en effet cela fonctionne.
      Je regarde en profondeur avant de passer en prod. à ces plugins.

      Maintenant il faut que je trouve l’équivalent de CKeditor

      Merci.

    Répondre à ce message

  • Courrier vide après validation de l’aperçu.

    Bonjour

    j’utilise SPIP liste, je crée un courrier à partir d’un patron et je clique sur générer l’aperçu. J’obtiens bien le bon résultat en haut de ma page, quand je clique sur valider sous cet aperçu, rien ne se passe !

    Par contre une action sur le bouton valider situé sous la zone texte du courrier, me produit un courrier vide. Ce qui est logique.

    Ai-je fais une mauvaise manipulation ?

    Merci par avance.

    Répondre à ce message

  • 1

    Bonjour, je rencontre cette erreur avec Spip-Listes (v3.0.11) Rév. 84222 du 17/08/14.

    Fatal error : Call to undefined function format_mysql_date() in /var/www/vhosts/.../httpdocs/plugins/auto/spip-listes-spip3/exec/spiplistes_courrier_previsu.php on line 102

    Une idée pour résoudre ce problème ?

    Merci

    • Finalement, la solution est là :

      A l’installation du plugin de spip-liste sur spip3, tout se passe bien mais quand vous souhaitez voir une de votre newsletter, là, ben, patatra.... Erreur fatal.....

      Alors, si comme moi vous avez cette erreur

      Fatal error : Cannot redeclare format_mysql_date() .

      Il faut pour cela allez dans le fichier spiplistes_courrier_previsu.php et il faut enlever la function format_mysql_date qui se trouve à la ligne 362 (102 chez moi), car cette function existe déjà dans spip 3 c’est pour ça qu’il ne peut pas redéclarer la date puisqu’elle a déjà été déclarée.

      Une fois enlevée Hop ça fonctionne ;)

      Voilà j’espère que cela vous aidera. N’hésitez pas à me le dire ;)
      Le javascript est inactif sur votre navigateur. Certaines fonctionnalités de cet outil seront inactives ...

      https://www.webforcom.fr/?plugin-spip-liste-pour-spip3

    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