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

  • erational

    sortie de la nouvelle version du plugin.

    Les squelettes des lettres sont maintenant gérés par un seul fichier (un pour le HTML et un pour la version TXT) ce qui facilite l’intégration, le développement et la maintenance

    le plugin requiert maintenant SPIP-Bonux

    Répondre à ce message

  • ivandps

    Bonjour

    bravo pour ce plugin simple et qui a marché à la première utilisation (2.0).
    j’aurais aimé pouvoir modifié le code à partir de l’aperçu et sauvegarder la version ainsi créée (patron). Au cas ou... Merci

    Répondre à ce message

  • 2
    ATH

    Je souhaite créer une page d’archives de la lettre sur le site public, un peu à l’image de la page Archives de la lettre dans l’espace d’administration. Cela doit permettre d’insérer :
    1. des liens vers les dix dernières lettres dans un squelette spip, avec éventuellement de la pagination.
    2. le contenu de la dernière lettre dans un squelette spip afin de permettre.

    Est-ce-que vous avez un exemple d’utilisation du lien URL_MALETTRE dans un squelette spip ?

    Merci pour votre aide.

    • Je relance la question, serait-t-il possible de mettre en place un accès public aux archives de la liste ?
      Peut-on imaginer une sorte de boucle MALETTRE ?
      Merci par avance,
      ATH

    • erational

      oui c’est possible. je l’ajoute dans la liste des choses à faire mais pour l’instant ce n’est pas ma priorité. En attendant vous pouvez toujours le faire en PHP (il suffit de lister le contenu du répertoire IMG/lettre)

    Répondre à ce message

  • 2
    val

    j’ai été voire ce que disait la ligne 22 de la page php en question

    if (function_exists(’file_get_contents’)) return file_get_contents($file) ; // >php4.3

    et je sais que mon hébergeur est passé à php5 penssez-vous que celà puisse avoir un rappor avec l’érreur ?

    • erational

      oui c’est possible. cette fonction est refusée par certains hébergeurs (DRI, ...) le plugin a été ré-écrit pour ne plus d’utiliser cette fonction. On passe maintenant par les mécanismes internes de spip. essayez donc d’installer la nouvelle version.

    • Stefan

      Merci beaucoup, tout semble bien fonctionner à présent !

      Cordialement,
      Stefan (le même qu’un peu plus bas)

    Répondre à ce message

  • 3
    Stefan

    Bonjour,

    J’ai récemment installé votre plugin et je suis confronté à une erreur lors de l’élaboration de la lettre. Après avoir choisi mes articles, et cliqué sur « ajouter à la lettre », voici le message que j’obtiens :

    Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_header) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_edito&id_article=1) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_item&id_article=11) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_footer) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_txt_header) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_txt_header) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_txt_edito&id_article=1) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_txt_item&id_article=11) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents() [function.file-get-contents]: URL file-access is disabled in the server configuration in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

Warning: file_get_contents(http://stefan.div-yezh.org?page=malettre_txt_footer) [function.file-get-contents]: failed to open stream: no suitable wrapper could be found in /home/httpd/vhosts/div-yezh.org/subdomains/stefan/httpdocs/plugins/ma-lettre/inc_malettre.php on line 22

    Que dois-je faire s’il-vous-plaît ?

    Vous remerciant par avance pour l’aide que vous pourrez m’apporter.

    Stefan

    • val

      J’ai le même problème avez vous trouvé la solution ?
      Merci de me tenir au courant ...

    • val

      ...et moi aussi c’est un problème en ligne 22

    • Regis92

      Eh non toujours pas résolu... mais pas trop cherché non plus de mon côté !

      En l’absence de réponse de l’auteur, il va falloir qu’on se débrouille entre nous ;-)

    Répondre à ce message

  • Regis92

    Bonjour,
    et merci pour ce plugin.

    Quand je fais : Texte d’introduction - éditer ce texte
    Je tombe sur l’article 1 du site :
    http://monsite/ecrire/?exec=articles_edit&id_article=1

    Est-ce que le texte d’intro doit être obligatoirement un article du site (et pourquoi le premier en l’occurence) ?

    Merci.

    Répondre à ce message

  • Corinne

    Bonjour,

    très intéressant ce plugin, simple et certainement efficace, mais je ne reçois pas la lettre ?
    J’ai inséré mon e-mail pour test dans la boite destinataire, je coche bien mon mail et ensuite ... rien.
    Merci d’avance pour votre aide.
    Corinne

    Répondre à ce message

  • 1
    sjpa

    Bonjour

    quel avantage/ différence par rapport à spip-liste ?
    Merci

    • sjpa

      Message précédent posté trop vite :la différence est évidente (gestion des abonnés par exemple)
      Désolé !

    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