Ma-lettre

Compose et envoie des lettres d’informations (newsletters)

Publié le : 21 août 2008 – Dernière modification le 31 juillet 2023 – par erational – 132 commentaires

Español, français
1
2
3
4
5
31 votes

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

5 ans 1 an 3 mois Sans limite
par date
Filtrer

48 discussions

  • 1
    maxou

    Bonjour
    Je viens d’installer le plugin Ma Lettre sur mon site.J’utilise une liste de distribution et Sympa. Tout fonctionne bien. Une question : est-il possible de ne pas faire paraître l’adresse du destinataire dans le message, par exemple comme dans CCI ?

    • maxou

      Bonjour
      Je me réponds à moi même.
      Ce que je demande dans mon message n’est peut-être pas réalisable ou d’un intérêt mineur.
      Merci pour une éventuelle réponse

    Répondre à ce message

  • 1
    fredjust

    bonjour

    je viens de tester Ma-lettre, qui marche très bien sauf si l’on sélectionne des articles qui sont dans une zone restreinte par le plugin accès restreint, ils n’apparaissent alors pas dans la lettre :-(
    est ce volontaire ?
    y a t il moyen de contourner cela ?

    merci

    • fredjust

      après lecture de la doc d’accès restreint je pense que le filtre

      {tout_voir}

      devait régler le problème

    Répondre à ce message

  • Gerard FONTAINE

    Bonjour,

    J’ai un souci d’affichage des caractères accentués avec le plugin Ma Lettre dans la zone qui affiche la lettre ; ils sont tous remplacés par des caractères bizarres ; dans firefox, si je change le codage en cliquant sur utf-8 et en renvoyant la page tout les accents sont rétablis.

    Pourtant mon site spip est en utf-8 (dans langues).

    J’utilise ckeditor pour rédiger les articles version 3.6 pour ckeditor et 0.15 pour le plugin, version 2.1 pour malettre.

    Que faire ?

    Cordialement,
    GeF

    Répondre à ce message

  • Brunof

    Bonjour,
    constat d’un bug qui survient sur spip 2.1.
    Lors de la génération de la lettre les paramètres #URL_SITE_SPIP/ présent dans les boucles du gabarit malettre.html sont ignorés.
    Résultat les liens sont tous à reprendre. Cela a bien fonctionné pour les 40 lettres précédentes et la sans aucune intervention particulière pft !
    Une piste, une idée ?

    Répondre à ce message

  • 3
    Hélène

    Bonjour,
    Le commentaire précédent répond à l’une de mes questions : je cherchais à joindre des images à ma lettre. Je me demandais si c’était une histoire de boucle. C’est vraiment dommage. Spip lettres le fait mais il n’est pas modifiable aussi facilement, en termes de CSS.

    Par ailleurs, pour notre association, j’utilise malettre pour différentes branches d’activités (festival, revue, activités au cours de l’année) et je change de patron en fonction (en renommant à chaque fois des fichiers adéquats). Ce serait super si le plugin proposait cette fonctionnalité : la possibilité de sélectionner tel ou tel « patron » en fonction des « thèmes » du site.

    Merci.

    • erational

      attention la question précédente cherchait à inclure les images dans le corps de l’email (images embarquées). Ce qui n’est pas forcement la meilleure méthode car vos emails seront beaucoup plus lourds pour chaque envoi.

      Vous pouvez toujours utiliser la méthode en indiquant des images embarquées ce qui permet de conserver de conserver des lettres légères tout en placant les images

      par exemple regardez cette lettre

      Pour la notion de thèmes, c’est une bonne idée, qu’il faudra intégrer, il faut juste la programmer ...

    • Hélène

      Merci pour votre réponse. Je ne comprends pas bien la différence entre les 2 possibilités (intégrer les images au mail ou les indiquer comme embarquées).

      L’exemple de lettre que vous m’indiquez affiche les images seulement si on lit la lettre « en dehors » de sa messagerie (en cliquant sur l’adresse de la lettre), c’est bien cela ? Quand vous parlez d’images embarquées, c’est en utilisant  ? ou et fonctionnent aussi ?

      Désolée pour ces questions de néophyte.

    • AAstudio

      Perso je n’aime pas non plus l’idée d’inclure les images dans le corps du texte. Je répondais juste à une demande client que ne comprenait pas pourquoi ses images n’apparaissaient pas dans Entourage (sauf si on clique sur « Télécharger les images »). ;)

    Répondre à ce message

  • 3
    aastudio

    Bonjour,

    Y a-t-il moyen de mettre les images : en pièces jointes et converties en base64 ?

    Merci,
    AA

    • erational

      Pour l’instant non : tout se fait par des liens vers des documents distants.

      Techniquement comme le plugin utilise phpmailer pour ses envois, il serait possible de réaliser ce que tu demandes. Il faut juste le programmer ... (voir par ex. le plugin spip-lettres qui intègre déjà les pièces jointes et les images en base64)

    • AAstudio

      Ok je vais regarder cependant Spip-Listes n’a pas l’air de le gérer non plus.

      Je vais voir du côté du Facteur s’il y a quelque chose à reprendre.

      Si d’ici là tu as une piste, n’hésite pas, merci ;)

      AA

    • AAstudio

      Effectivement Facteur le fait, en revanche je ne vois pas comment l’intégrer à Ma-Lettre. C’est dommage car ça rendrait le plugin « parfait » ;)

      A+,
      AA

    Répondre à ce message

  • 1
    Aurélien

    bonjour,

    est-ce que l’envoi fonctionne en local ?
    j’ai le message « Erreur lors de l’envoi ».

    Merci
    Aurélien

    • erational

      Tout dépend de ta configuration locale...

      Il faut avoir l’envoi mail() PHP active sur sa machine de dév et peut être le SMTP. Par expérience, je sais que sur wampserver windows de « base » l’envoi ne fonctionne pas de suite. Il faut juste affiner sa configuration serveur pour que cela passe.

    Répondre à ce message

  • 1
    Daniel

    Bonjour,
    merci pour ce plugin simple et utile.
    j’ai toutefois un probleme avec les adresses orange qui ne passent pas..
    j’ai bien :lettre bien envoyée à xxx.orange.fr mais je ne recois rien
    j’ai essayé sur 2 comptes orange differents et c’est pareil.
    sur gmail ca passe sans probleme...
    avez vous des pistes ?
    merci

    • Daniel

      Bon,
      en fait c’est un probleme entre OVH et Orange.
      j’espere que ça se reglera vite.
      Desolé pour le dérangement...

    Répondre à ce message

  • Ben

    Bonjour
    plugin efficace permettant en effet de composer de belles lettres d’info.
    Cependant un destinataire s’est plaint de recevoir sa lettre au format HTML avec plein de
    \n\n\n\n\n\n et de \t\t\t\t\t\t\t\t\t rendant illisible le résultat...
    Je ne m’explique pas cela (il faut dire que la messagerie c’est pas mon fort)
    Je précise que je suis en SPIP 2.1.0 [15608] et que la version du plugin utilisée est la Version : 2.2 [38854]
    Je l’utilise avec MesAbonnes Version : 0.1 [38656]
    Est-ce que ça parle à quelqu’un ?
    Merci

    Répondre à ce message

  • 2
    Stephane

    Bonjour.
    J’utilise de plugin sur le site de mon club photo.
    Comment utilisé le texte d’introduction ?

    • erational

      bonjour il suffit de modifier l’article qui sert d’édito. Cet article est défini via le panneau de configuration (plugin cfg)

      Si vous pouvez modifier en profondeur l’affichage de votre newsletter, vous pouvez aussi modifier ou surcharger le squelette malettre.html

    • Stephane

      Merci cela fonctionne.

    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