Ma-lettre

Compose et envoie des lettres d’informations (newsletters)

Permet de composer sur mesure une lettre d’information (newsletter) en sélectionnant manuellement les articles, événements que l’on désire ajouter pour l’envoyer à un logiciel de gestion de listes extérieur à SPIP (de type SYMPA, Mailman...).

Objectifs du plugin

Le plugin Ma Lettre sert uniquement à composer des newsletters au format HTML et texte (brut) pour les envoyer à un logiciel tiers spécialisé dans la gestion des mailings-listes (comme SYMPA, Mailman, ...).

Le plugin est volontairement simple et élémentaire. Il ne gère donc pas les abonnés, les formulaires d’inscription, ...
Si vous avez besoin d’un plugin de gestions de newsletter complet intégré dans SPIP, utilisez plutôt alors Newsletters.

Fonctionnalités

Elles sont volontairement restreintes :

  • Création de newsletter au format HTML et TXT
  • Archiver et gérer des lettres envoyés
  • Charger la dernière lettre
  • Créer un lien pour consulter la newsletter en ligne

A partir de la version 4.0 l’envoi des emails est délégué au plugin Facteur.

Installation

Après son activation, il est recommandé de configurer le plugin

Vous pouvez configurer :

  • le numéro de votre article édito
  • quels objets vous voulez sélectionner : rien, articles, événements (requiert le plugin Agenda)
  • vos expéditeurs
  • destinataires courants.
Configuration de ma-lettre
astuce il est possible de configurer à minima et de détourner l’utilisation classique du plugin. Par exemple vous pouvez le configurer sans d’édito ni d’articles ou événements à cocher. Dans ce cas, le rédacteur de la lettre ne rentre que le titre de la lettre. C’est à vous alors d’écrire un patron de lettre basé sur une autre logique (par ex. une sélection d’articles à base de mots-clés ou un critère d’âge).

Composer une lettre

Etape 1 : Choisir les éléments qui composent votre newsletter

Chaque lettre est composée :

  • d’un édito (un article fixe dans SPIP)
  • d’une sélection d’articles que vous pouvez choisir en les cochant OU / ET entrant les numéros (pour déterminer un ordre particulier ou sélectionner de vieux articles)
  • d’une sélection d’événements que vous pouvez choisir en les cochant OU / ET entrant les numéros (pour déterminer un ordre particulier ou sélectionner de vieux articles)
sélection des derniers articles (en cochant)


sélection des derniers articles : on coche

sélection libre d’articles


sélection libre d’articles : on indique les numéros

Etape 2 : Choisir les expéditeurs et destinataires

choix expéditeurs / destinataires


Choisir les éléments qui composent votre newsletter

apercu de la lettre


Et vérifier si l’aperçu HTML et texte convient

Cliquer sur le bouton pour envoyer la lettre !
Après l’envoi, la lettre est archivée dans le répertoire IMG/lettre/

Personnaliser la lettre

version 3 et suivantes
Il suffit de surcharger les patrons livrés par défaut

public/malettre.html patron de la lettre (format HTML)
public/malettre_txt.html patron de la lettre (format texte)

version 2.1 et suivantes
2 fichiers uniquement définissent le patron des lettres envoyées

nom fichierdescription
malettre.html patron de la lettre (format HTML)
malettre_txt.html patron de la lettre (format texte)

Bien étudier ces deux fichiers qui utilisent des boucles POUR qui permettent de boucler sur la sélection d’articles de la newsletter.

version 2.0
Il suffit d’éditer les fichiers squelette contenus dans le répertoire ma-lettre

positionnom fichierdescription
1 malettre_header.html boucle l’entête de la lettre (incluant les styles)
2 malettre_edito.html boucle pour l’édito
3 malettre_item.html boucle pour un article
4 malettre_footer.html boucle pour le pied de la lettre

la même chose pour les fichiers malettre_txt_... qui décrivent l’affichage au format texte

Pseudo Balises

Dans vos squelettes, il est possible d’insérer les codes suivants

Pseudo-codeDescriptifRemarques
{URL_MALETTRE} Lien absolu de la lettre archivée sur le serveur
{TITRE_MALETTRE} Titre de la lettre (déterminé au moment de l’envoi)
{NOM_LISTE} Nom de la liste destinataire (défini dans le panneau du configuration) A partir de Ma lettre 3.2.0

Exemple d’utilisation dans un patron de lettre

<a href="{URL_MALETTRE}">Consulter cette lettre directement en ligne</a>
...
<h3>Lettre d'information </h3>
....
<a href="mailto:sympa@listes.domaine.org?subject=unsubscribe%20{NOM_LISTE}>Se désinscrire de la liste {NOM_LISTE}</a>

Gérer vos archives

Depuis la version 3, le plugin introduit une boucle MESLETTRES qui permet de lister les lettres envoyées depuis l’espace public

<B_archive><h3>Archives de la lettre d'information</h3>
<ul>
<BOUCLE_archive(MESLETTRES){pagination 5}{!par date}>
[<li><a href="(#CHEMIN{IMG/#URL_HTML})">#TITRE</a> envoyé le  [(#DATE|affdate_court)]</li>]
</BOUCLE_archive>
</ul>
[<div class="pagination">(#PAGINATION)</div>]
</B_archive>

Utiliser ma-lettre dans d’autres plugins

Depuis la version 3.3.4, la sélection de la dernière lettre (les id des articles, événements, édito et le titre) sont stockés dans la table spip_metas.

Cela permet d’utiliser le plugin malettre comme outil de composition et de sélection pour l’utiliser dans d’autres plugins (par exemple dans un template d’un plugin newsletter)

Voici le code pour récupérer ces données

#CONFIG{malettre-titre}
#CONFIG{malettre-selection_id_article_edito}
#CONFIG{malettre-selection}
#CONFIG{malettre-selection_eve}

Historique

versiondateremarque
4.1 2023 portage pour SPIP 4.1
4.0 juin 2022 portage pour SPIP 4.0
3.3 février 2014 destinataires « autres » multiples
3.2 novembre 2013 ajout de {NOM_LISTE}
3.0 juin 2012 portage pour SPIP 3
2.3 janvier 2011 configuration choix des objets à sélectionner : articles , événements
2.2 juin 2010 compatible avec le plugin Mes abonnés de gestions d’abonnement
2.1 novembre 2009 un seul squelette pour gérer l’ensemble de la lettre
2.0 janvier 2009 version compatible SPIP 2
0.91 décembre 2008 support du multilinguisme, ajout de langue : NL
0.9 octobre 2008 lien vers les archives publiques
0.86 mars 2008 sortie publique du plugin

Discussion

48 discussions

  • Bonjour,
    Je viens d’installer le plugin ma_lettre sous spip 1.9.2 . Je n’arrive pas à avoir le lien actif vers l’url_malettre. Que dois-je faire ?
    Merci pour les tuyaux

    Répondre à ce message

  • Bonjour,

    -  Je viens de passer à la version 2.1.1 de Spip. Pas de changement sur le fonctionnement du plugin chez moi. A propos de version, celle de ton plugin apparaît comme étant la 2.0 sur cette page de Spip Contrib (on mouse over sur le lien de téléchargement)... et non la 2.2 ?

    -  Je constate que l’insertion d’articles en dehors de ceux qui sont sélectionnés par des cases à cocher est aléatoire. Si j’indique le n° 5600, il est inséré, si j’essaye un autre, ça ne marche pas. L’édito n’est toujours pas inséré dans la lettre (y a-t-il une limite en nombre de caractères ?) même si je peux le prévisualiser.

    -  Par ailleurs, je viens de trouver un message sur un forum qui semble faire un lien entre le dysfonctionnement de ton plugin et « le htaccess et htpassword » :

    http://www.mail-archive.com/spip-zone@rezo.net/msg18881.html

    Cordialement,
    Kolote

    Répondre à ce message

  • 3

    Bonjour,

    Le plugin m’intéresse bigrement mais :

    -  la sélection d’articles ne marche pas
    -  l’envoi de lettre non plus

    Spip 2.1.0 Squelette Ahuntsic 1.0.0

    Que faire ?

    • Je me réponds à moi-même en partie : l’ajout par sélection (case à cocher) fonctionne bien, la lettre est bien envoyée mais :
      -  l’édito, visible avant la génération de la lettre, ne l’est plus ensuite.
      -  l’ajout manuel d’articles ne fonctionne pas.

      Pour moi, en tous cas.

      Une idée ?

    • pouvez vous préciser version de spip, du plugin, hébergeur,... ?
      je viens de re-tester en local en spip 2.1.1, ma lettre 2.2 [38854] avec succès.

    • Bonjour,

      Merci pour réponse.

      Je compte vraiment sur votre plugin...

      Je suis sous :
      -  Spip 2.1.0
      -  Plugin Ma Lettre : 2.2
      -  Hébergeur : O2Switch

      Cordialement,
      Kolote

    Répondre à ce message

  • 1
    chantelavie

    Bonjour,
    j’administre sans pb une base spip 2.1 sous free.fr.
    J’ai installé et activé le plug-in ma-lettre. Tout va bien pour l’édito, le choix des articles, mais impossible d’aller plus loin. En particulier pas d’aperçu de la lettre préparée.
    Par contre l’envoi vers les destinataires se déroule normalement... avec bien sûr un message vide.

    J’ai fait un test avec un autre fournisseur FAI, c’est ok. Pour que Ma-lettre soit fonctionnelle, que faut-il configurer de plus que SPIP avec les hébergements Free ?

    Merci d’avance.

    • c’est peut-être un problème de droits sous free.
      vérifier que le plugin arrive bien à créer le réperoire IMG/lettre/ sinon le créer à la main en le placant en chmod 777.

    Répondre à ce message

  • 2

    Bonjour,
    Je viens d’installer le plugin sur un Spip 1.9.2d, et le formulaire de selection d’articles (à cocher) n’apparait pas.
    Y a-t-il incompatibilité avec la derniere version du plugin ?

    Sinon, installé sans problème sur un autre site en 2.1, plugin simple et très efficace ! Merci aux devs !

    Répondre à ce message

  • bonjour,
    je rencontre une difficulté avec le plugin ma lettre version : 2.2 [38854] sur un site spip 2.0.10 dont l’accès public est restreint par un htaccess et htpassword,
    la prévisu du texte de la lettre est correcte mais l’envoi définitif est vide, si je supprime le htaccess et htpassword tout rentre dans l’ordre.
    vous auriez une idée, des pistes pour essayer de faire une adaptation ?
    merci d’avance

    Répondre à ce message

  • 2

    Bonjour,

    J’utilises le plugin en version 3.2 sur un site SPIP en 1.9.2e

    Parfois, et c’est la 2e fois avec aujourd’hui (mais pas pour les 3 précédentes news), le test est ok, par contre l’envoi de la news voit sa version HTML vide si bien que le mail est vide lui aussi, à part le titre et l’expéditeur...

    J’ai regardé la table spip_lettres et le cham message_html (de type BLOB) fait 0.

    Savez-vous ce qui peut provoquer cela ?

    Merci

    • êtes vous sur d’être sur le bon forum ?
      Le plugin ma-lettre

      • ne crée aucune table
      • la dernière version disponible est la 2.2 pour SPIP 2.x.

      A mon avis votre plugin est plutot spip-listes ou spip_lettre ...

    • Désolé, mon message correspond au plugin spip-lettres

    Répondre à ce message

  • 4
    jeronimo

    Bonjour,
    Je viens d’installer la dernière version et je me rend compte que les articles ENTIERS sont générés alors que dans mon ancienne version seuls les descriptifs constituait la lettre.
    Comment est-il possible de modifier cela ?
    Merci d’avance.

    • bonjour

      il suffit de modifier le patron de la lettre de base ou de le surcharger le fichier malettre.htm

      pour ne pas plus avoir les articles en entier,
      modifier la ligne 55 de malettre.html

       [<div style="font-family:Arial;font-size:0.8em;color:#848484;">(#TEXTE|image_reduire{600}|liens_absolus)</div><br />]

      par exemple ,
      si vous voulez uniquement les résumés de premières lignes :

       [<div style="font-family:Arial;font-size:0.8em;color:#848484;">(#INTRODUCTION)</div>]
    • jeronimo

      Bonjour,
      Merci pour la rapidité de la réponse. Tout fonctionne comme je le souhaite.
      Me reste un pb d’images qui ne s’affichent pas dans la lettre (cadre avec croix rouge).
      Une idée ?

    • verifie tes chemins de tes images et fichiers, la syntaxe est du genre
      #URL_SITE_SPIP/#CHEMIN{images/monfichier.jpg}
      et / ou les filtres
      |liens_absolus, |url_absolue

    • jeronimo

      Merci beaucoup !
      (#INTRODUCTION) devient (#INTRODUCTION|liens_absolus) et ça fonctionne.

    Répondre à ce message

  • 6

    Est-il possible de mettre des brèves dans la lettre ?

    • oui, rien ne vous empeche d’ajouter une boucle brève
      par ex. dans le squelette malettre_edito.html

      <B_bref>
      <div class="block">
      <h3 class="info"><:breves:></h3>
      <BOUCLE_bref(BREVES){lang}{!par date}{0,5}>
      <a href="#URL_SITE_SPIP/#URL_BREVE">[<span>(#DATE|affdate_court)</span> &ndash; ]#TITRE</a><br />
      </BOUCLE_bref>

      par contre, il n’est pas possible de sélectionner les brèves à la manière des articles en les cochant mais vous pouvez appliquer un critère de date ou un mot-clé ...

    • janvier 2009 : le plugin est maintenance disponible pour SPIP 2 ! Champagne !
      veuillez bien télécharger la version qui correspond à votre version de spip

    • Bonjour,

      Ma-lettre s’accommode bien par son côté manuel à notre site qui a un rythme de publication irrégulier. On peut aussi la compléter avec un texte ancien. Mais comme nous publions autant de brèves que d’articles, se limiter aux articles était regrettable.

      Je me suis donc retroussé les manches car je ne suis qu’un vieux bidouilleur par rapport à vous. J’ai fait cette modi qui permet de choisir, parmi les 20 dernières brèves et les 30 derniers articles, par exemple, ceux qui seront publiés en lettre et ajouter les brèves et/ou les articles plus anciens.

      Les modifications ne sont pas très importantes mais trop longues pour être recopiées ici. Si vous êtes intéressé, toutes les modifs sont : ICI

      Mais j’aimerais savoir si l’usage de la balise #ENV** avec un appel à une fonction placée dans mes_fonctions.php n’introduit pas un problème de sécurité.

    • Bonjour,

      L’avantage de Ma-Lettre est de pouvoir sélectionner ce qu’on veut publier. L’inconvénient est de ne pas gérer les listes de diffusion. A l’inverse le plugin SPIP-Listes gère très bien les listes des diffusions mais repose sur une élaboration automatique des messages. Comment profiter des avantages de l’un et de l’autre ?

      J’ai modifié le code de malettre.php pour qu’au moment où on envoie la lettre vers le destinataire celle-ci soit passée à la table spip_courriers dans la base de telle sorte qu’elle soit vue comme un message prêt à être envoyé par SPIP-Listes.

      Autour de la ligne 170 dans malettre.php, avant la ligne « fin examen requete », j’ai inséré ceci (pas facile de faire tenir le code dans la fenêtre) :

      // passe Ma-lettre à SPIP-Listes 
      // via la base sql
      
      $texte = $sourceHTML;
      $message_texte = $sourceTXT;
      $titre = $lettre_title
      	." (ne pas r&eacute;pondre)";
      // affichage correct de 
      // l'apostrophe dans l'email
      $titre= ereg_replace("'","&apos;",$titre);  			
      $statut = "redac";
      $type = "nl";
      $id_courrier = sql_insert(
      	'spip_courriers',
      	"(titre,texte,message_texte,date,
      	statut,type,id_auteur)", "("
      	.sql_quote($titre).","
      	.sql_quote($texte).","
      	.sql_quote($message_texte)	
      	.",NOW(),"
      	.sql_quote($statut).","
      	.sql_quote($type).","
      	.sql_quote($connect_id_auteur).")"
      	);
       
       }  // fin examen requete		

      Après avoir installé le plugin SPIP-Listes, l’avoir configuré et défini la liste de diffusion (sans indiquer de patron),
      -  Dans Ma-Lettre je prépare une lettre et je l’envoie ;
      -  Dans le « Casier à courrier » de SPIP-Listes, je retrouve ma lettre dans les « Courriers en cours de rédaction » prête à être envoyée.

      Qu’en pensez-vous ?

    • Bonjour,

      merci pour vos suggestions (brèves, spip-listes, ....)

      L’idée de passer les lettres composées par Ma-lettre vers SPIP-Listes est simple et originale.

      Si cela interesse d’autres personnes, on pourrait imager une option dans cfg « Destinataire : SPIP-Listes » et intégrer votre code.

    • Bonjour erational,

      Très bonne idée de donner le choix dans Config d’envoyer la lettre vers SPIP-Listes.

      Pour avoir essayé les 3 plugins disponibles, Ma Lettre est celui qui permet d’envoyer une newsletter avec le minimum de travail : l’image pour la bannière et un peu d’adaptation css pour le decorum si on veut.

      Merci encore pour ce plugin.

      Henri

      Ps. : SPIP-Listes ne traite pas (du tout ?) l’objet de l’email comme le fait Ma-Lettre,

      Avec Ma-Lettre :

      Subject: =?iso-8859-1?Q?Lettre_d’information?=
      
      From: =?iso-8859-1?Q?xxxxx=E9_Aujourd=27hui?= <xxxx@yahoo.fr>

      Avec SPIP-Listes :

      Subject: Lettre d&#8217;information
      
      From: =?iso-8859-1?Q?xxxxx=E9_Aujourd=27hui?= <xxxx@yahoo.fr>

      C’est la raison pour laquelle, je remplace l’apostrophe par &apos;. Il y a sûrement le même problème avec les autres caractères.

    Répondre à ce message

  • 2
    Christophe

    Bonjour,

    J’ai installé ce plugin cette semaine et j’ai envoyé la première newsletter nouvelle formule avec.

    J’apprécie la simplicité de gestion, les images, c’est vraiment une merveille de plugin ;-)

    Par contre, certains destinataires me disent que les caractères accentués sont remplacés par un point d’interrogation, ce que je n’ai pas vérifié sur ma messagerie et sur l’aperçu de la lettre. Existe-t-il un moyen pour corriger ce problème et rendre la newsletter compatible à toutes les messageries ?

    Merci d’avance.

    • Bonjour,il s’agit typiquement d’un problème d’encodage.
      L’ideal est de travailler en unicode (UTF-8) sur le site et pour la lettre et généralement cela se passe bien sur tous les clients.

      Ma-lettre envoie aussi le lettre en format HTML et Texte brut pour passer sur le maximum de messagerie (dont les vieux webmails).

    • Bonjour,

      Merci pour ce plugin qui va nous rendre un bon service.

      Le site sous SPIP est en iso-8859-1. L’édito et tous les articles sont évidemment dans le même encodage. Dans la page malettre.html, le cadre édito est en utf-8 ... le vrac. C’est la même chose pour les articles sélectionnés. Le mail est envoyé en utf-8 et à la réception : s’il y a un caractère spécial dans l’objet de l’email, l’objet est remplacé par un unique � quant au texte dans son contenu tous les caractères spéciaux sont remplacés par ce caractère. C’est la cause de nos problèmes. C’est visible en lisant le fichier source de l’email où les 2 encodages sont mélangés.

      Il y a beaucoup de discussions sur l’intérêt de l’utf-8 et de l’iso-8859-1. L’objectif est d’abord d’être lisible par le plus grand nombre de visiteurs. Par défaut SPIP est en iso-8859-1. Bien qu’il soit possible de passer le site sous utf-8, ceci n’est pas une petite affaire d’après ce que j’ai pu en lire. C’est pourquoi j’ai décidé de passer le plugin sous iso-8859-1 car nos visiteurs sont francophones.

      Pour passer sous iso-8859-1, voir :

      -  malettre_edito.html dans la balise #HTTP_HEADER, remplacer utf-8 par iso-8859-1

      -  malettre.php $mail->CharSet = « utf-8 », remplacer utf-8 par iso-8859-1

      Les emails sont maintenant lus correctement.

      Cordialement.

    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