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

  • gnsic2000

    Bonjour,
    Super plugin, simple et efficace, sauf que je ne peux le faire marcher que sous l’identité de webmestre du site ; si me logge comme simple administrateur d’une rubrique, je n’ai plus accés au plugin dans le menu Edition.
    Est-ce normal ?
    Merci

    Versions : spip 3.0.8 et plugin « Ma lettre » = 3.2.0

    Répondre à ce message

  • 4
    jeronimo74

    Bonjour,
    Quand je veux générer ma lettre j’ai le message suivant :

    Fatal error : Call to undefined function lire_config() in /web/monsite/www/plugins/auto/ma-lettre_3_0/formulaires/editer_malettre.php on line 89

    D’autre part, je ne vois plus les archives de la version précédente. Pourant les fichiers lettres sont dans /IMG/lettre. Une asctuce ?

    SPIP 3.0.1 [19436] / Ma lettre3.0.1

    • jeronimo74

      La ligne 89 correspond à cela :

      $id_article_edito = lire_config(« malettre/id_article_edito ») ;

      Lors de l’envoi j’ai également ceci :

      Warning : Invalid argument supplied for foreach() in /web/monsite/www/plugins/auto/ma-lettre_3_0/formulaires/envoi_malettre.php on line 145

      Merci d’avance pour votre aide.

    • bonjour

      avez vous configuré le plugin dans le panel de configuration ?

      pour les anciens messages, oui c’est normal, il faut que j’écrire un script pour importer les anciennes archives dans la base de données (qui est une nouveauté de cette nouvelle version).

    • jeronimo74

      Bonjour,
      Oui, j’ai bien revalidé la configuration. D’ailleurs il avait conservé tous les éléments de la version précédente.

    • Bonjour,

      Je souhaite passer mon site de lettre à Spip 3.0.11 et installer la version de Ma-lettre 3.0
      Je n’ai pas trouvé le script dont il est fait référence dans ce fil :

      Le 8 juin 2012 à 09:04 par jeronimo74 En réponse à : Ma-lettre
      Bonjour,
      D’autre part, je ne vois plus les archives de la version précédente. Pourant les fichiers lettres sont dans /IMG/lettre. Une asctuce ? SPIP 3.0.1 [19436] / Ma lettre3.0.1
      Le 8 juin 2012 à 09:59 par erational En réponse à : Ma-lettre
      bonjour
      pour les anciens messages, oui c’est normal, il faut que j’écrire un script pour importer les anciennes archives dans la base de données (qui est une nouveauté de cette nouvelle version).

      Quelqu’un aurait-il une solution pour remplir la base de données ? Par avance je vous remercie

      GeF

    Répondre à ce message

  • 4

    bonjour,

    merçi pour ce plugin très fonctionnel.
    J’ai un message d’erreur lors de l’envoi du courrier : Erreur lors de l’envoi du mail
    alors que le mail est bien envoyé et bien reçu.
    j’utilise « Facteur », avec une configuration en smtp

    j’ai le meme message d’erreur avec la version spip2 et spip3

    • Bonjour,
      même chose chez moi.
      Il suffit de modifier le fichier formulaires/envoi_malettre.php en remplaçant la ligne 204 :
      $envoyer_mail($adresse,$lettre_title,$corps);
      par
      $res = $envoyer_mail($adresse,$lettre_title,$corps);
      Cordialement

    • merci beaucoup yvan pour tous vos correctifs que j’ai comité 68279 dans la version 3.0.5 du plugin.

      n"hésitez pas à comiter directement vos corrections sur la zone SVN

      cordialement

    • haqqtiviste

      bonjour
      je viens d’installer aujourd’hui la dernière version

      j’ai les mêmes erreurs d’envoi. j’utilise aussi facteur. je suis chez ovh. le test de facteur fonctionne, donc les paramètres sont ok.

      merci en tout cas pour vos contributions

    • l’envoi par facteur était bugé.
      normalement le bug est resolu avec la version 3.1.0 du plugin.

    Répondre à ce message

  • 1

    Bonjour
    Je viens d’installer ce super plugins mais j’ai un problème quand j’envoie les mails mes logos m’apparaissent pas.

    • Bonjour,

      votre site est-il accessible en https, utilisez-vous le plugin « Redirection HTTPS » ? Si oui, et si le certificat de votre serveur web n’est pas signé par une autorité de certification, alors vous ne visualiserez pas les logos dans la lettre dans un client mail comme Thunderbird. Il faut, dans ce cas, importer votre certificat dans votre logiciel de courrier.

      Cordialement

    Répondre à ce message

  • 3

    Bonjour,

    Ce plugin est super, mais j’ai quelques soucis :
    -  le fichier de langue n’est pas pris en compte
    -  Je ne sais pas quoi modifier pour que le titre de la lettre apparaisse dans l’objet du message
    -  je ne sais pas comment récupérer l’URL de la lettre et l’indiquer dans le corps de la lettre pour qu’elle puisse être consultée en ligne si elle ne s’affiche pas correctement. Mais ce n’est peut-être pas possible

    Je suis en spip2.1.19 et j’utilise la version 2.3.2 du plugin.

    Merci de l’aide
    Martine

    • J’ai trouvé la réponse à mes 2 premiers problèmes :

      1) pour la prise en compte du fichier de langue, il faut corriger par exemple <:malettre:lire_en_ligne :> au lieu de <:lire_en_ligne :>

      2) l’objet apparaît lorsqu’on envoie la lettre via sympa, mais pas lors de l’envoi à une adresse seulement

      Mais je ne sais pas comment je récupère l’URL de la lettre avec la balise #URL_MALETTRE. Ca ne semble pas marché.

      Martine

    • bonjour

      pour indiquer l’adresse de la lettre, il faut utiliser la pseudo balise {URL_MALETTRE} et non #URL_MALETTRE (qui sert uniquement une fois que la lettre envoyée si vous voulez lister des archives depuis la partie publique de votre site)

    • Merci beaucoup.

      Ca fonctionne.
      Cordialement. Martine

    Répondre à ce message

  • 1

    Bonjour,

    J’ai un problème avec la puce.

    Quand il y a une liste à puce dans un article qui sert pour la newsletter, les puces sont changées par une image dont l’adresse est « ../prive/puce_prive.gif ». Ce qui génère une erreur.

    Je ne vois pas comment changer ce lien.

    Quelqu’un sait ?

    • J’ai trouvé la solution :

      dans le fichier malettre.html, il faut ajouter dans la boucle "<BOUCLE_selection_bonux...", et après la balise #TEXTE, le filtre "|liens_absolus"

      Ce qui donne :

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

    Répondre à ce message

  • Bonjour,

    est-il possible d’ajouter plus de 7 destinataire ?
    ne pourrait-on pas tous simplement sélectionner les destinataire par la liste des auteurs ?

    cdlt

    Répondre à ce message

  • 2

    Bonjour,

    je viens de tester ce fabuleux plugin, mais je n’arrive pas à le configurer,

    je n’arrive tout simplement pas a trouver la page de configuration :(

    pouvez-vous m’envoyer un lien svp

    merci beaucoup

    • La page de configuration de Ma lettre se trouve

      • SPIP 2 : ecrire/ ?exec=cfg&cfg=malettre (il faut avoir le plugin cfg installé)
      • SPIP 3 : ecrire/ ?exec=configurer_malettre (aucun plugin requis)
    • Bonjour,

      merci pour votre réponse, en effet il me manquais le plugin cfg =)

      encore merci et bonne journée

    Répondre à ce message

  • 4

    Bonjour,

    lorsque je coche des articles, rien n’est généré ni en HTML ni en txt ???

    Je viens d’installer le plugin 2.3 sur SPIP 2.1.10

    Merci

    • Je viens de tester une installation nue avec Ma Lettre2.3 & SPIP 2.1.11.
      Aucun problème à signaler.

      Vérifier peut-être :

      • que le répertoire IMG/lettre est présent ? vérifier ses droits en écriture (CHMOD 755)
      • est ce que le répertoire IMG/lettre contient des fichiers ?
    • Le répertoire est présent, les bons droits et les fichiers aussi.

      Je cherche à désinstaller complètement le plugin pour repartir sur une base propre.

      Quelles sont les précautions à prendre ?

    • Aucune précaution à prendre puisque le plugin ne requiert aucune table de base de données.

    • Aurelien

      J’ai le même problème que toi Damien, aurais-tu trouvé une solution ?
      D’avance merci.
      ++

    Répondre à ce message

  • 7

    Bonjour.
    Avec la dernière version de ma-lettre Version : 2.3 [43720] et sous Spip 2.1.8.
    La liste des articles a disparu.

    Bug ou paramétrage différent ?

    • je n’arrive pas à reproduire votre bug
      je viens de tester sur le plugin en version 2.3 [43720] sur SPIP 2.1.10. Tout fonctionne bien, on voit bien la liste des articles.

    • Bonjour,
      je rencontre le même problème (SPIP 2.0.15 [17661]).
      Avec Ma-lettre 2.2 [38854] tout fonctionne bien, avec version 2.3 [43720] la liste des articles à cocher ainsi que le champ articles par numéro et le bouton « ajouter à la lettre » ne sont pas visibles.
      bonne journée
      joz

    • depuis la version 2.3, il faut passer par Config pour choisir les objets que vous voulez lister / cocher :

      • rien hormis l’édito (par défaut)
      • articles (à cocher si vous voulez retrouver l’ancien mode de fonctionnement)
      • événements (si vous avez le plugin Agenda)
    • merci ça marche :)

    • Bonjour,
      même problème aussi, sur SPIP 2.1.10 : Ma-lettre 2.3 ne semble pas non plus afficher les articles à cocher, et se borne à enregistrer les changements de numéro d’article d’édito, d’expéditeurs et de destinataires dans CFG, sans envoyer les messages... Se pourrait-il que j’aie oublié quelque chose ?
      Merci

    • La version 2.3 permet de choisir ce que vous voulez sélectionner.(voir le message précédent)

      Pour résoudre votre problème :

      1. aller dans le panneau de configuration (CFG)
      2. Liste des objets à lister : cocher « articles »
      3. enregistrer
        Vous retrouverez le mode de fonctionnement précédent.
    • C’est bon ça marche !
      Je n’avais pas vu l’onglet Ma-Lettre dans la zone « Edition » de l’interface privée de Spip. :/

    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