SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

290 Plugins, 198 contribs sur SPIP-Zone, 104 visiteurs en ce moment

Accueil > Interactivité, échanges > Email, Newsletters, listes de diffusion > Ma-Lettre > Ma-lettre

Ma-lettre

Compose et envoie des lettres d’informations (newsletters)

21 août 2008 – par erational – 117 commentaires

Toutes les versions de cet article : [Español] [français]

29 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 SPIP-Lettres.

Téléchargement

Version de SPIPZipPlugins requis
SPIP 3.0 ma-lettre_3_0.zip Saisies
SPIP 2.0 ma-lettre_2_0.zip SPIP-Bonux, Cfg
SPIP 1.9.2 ma-lettre_1_9.zip aucun

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

Installation

  1. Copier dans le répertoire habituel ./plugins/ et activer le depuis le menu plugins
  2. Il est recommandé de configurer le plugin
    Configuration de ma-lettre
    Grâce à config (cfg), indiquer :
  • 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.
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

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

Télécharger

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

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

Télécharger

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

  1. #CONFIG{malettre-titre}
  2. #CONFIG{malettre-selection_id_article_edito}
  3. #CONFIG{malettre-selection}
  4. #CONFIG{malettre-selection_eve}

Télécharger

Historique

versiondateremarque
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

Voir en ligne : https://plugins.spip.net/malettre

Dernière modification de cette page le 7 septembre 2018

Retour en haut de la page

Tout afficher

Vos commentaires

  • Le 29 janvier 2013 à 18:21, par Martine En réponse à : Ma-lettre

    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

    • Le 30 janvier 2013 à 21:33, par Martine En réponse à : Ma-lettre

      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

    • Le 1er février 2013 à 00:54, par erational En réponse à : Ma-lettre

      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)

    • Le 1er février 2013 à 11:25, par Martine En réponse à : Ma-lettre

      Merci beaucoup.

      Ca fonctionne.
      Cordialement. Martine

    Répondre à ce message

  • Le 2 octobre 2012 à 11:50, par gilles En réponse à : Ma-lettre

    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 ?

    • Le 2 octobre 2012 à 12:29, par gilles En réponse à : Ma-lettre

      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

  • Le 31 juillet 2012 à 09:31, par Antoine En réponse à : Ma-lettre

    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

  • Le 26 juillet 2012 à 10:50, par David En réponse à : Ma-lettre

    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

    • Le 31 juillet 2012 à 06:04, par erational En réponse à : Ma-lettre

      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)
    • Le 31 juillet 2012 à 09:23, par Davd En réponse à : Ma-lettre

      Bonjour,

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

      encore merci et bonne journée

    Répondre à ce message

  • Le 28 septembre 2011 à 21:32, par Damien En réponse à : Ma-lettre

    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

    • Le 29 septembre 2011 à 03:51, par erational En réponse à : Ma-lettre

      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 30 septembre 2011 à 00:20, par Damien En réponse à : Ma-lettre

      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 ?

    • Le 30 septembre 2011 à 01:45, par erational En réponse à : Ma-lettre

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

    • Le 9 mars 2012 à 15:45, par Aurelien En réponse à : Ma-lettre

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

    Répondre à ce message

  • Le 14 juin 2011 à 14:32, par ? En réponse à : Ma-lettre

    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 ?

    • Le 16 juin 2011 à 05:42, par erational En réponse à : Ma-lettre

      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.

    • Le 23 août 2011 à 13:08, par joz En réponse à : Ma-lettre

      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

    • Le 14 septembre 2011 à 03:05, par erational En réponse à : Ma-lettre

      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)
    • Le 20 septembre 2011 à 11:42, par joz En réponse à : Ma-lettre

      merci ça marche :)

    • Le 29 novembre 2011 à 13:18, par coco98 En réponse à : Ma-lettre

      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

    • Le 30 novembre 2011 à 00:51, par erational En réponse à : Ma-lettre

      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.
    • Le 30 novembre 2011 à 22:49, par coco98 En réponse à : Ma-lettre

      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

  • Le 24 octobre 2011 à 19:32, par maxou En réponse à : Ma-lettre

    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 ?

    • Le 5 novembre 2011 à 16:15, par maxou En réponse à : Ma-lettre

      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

  • Le 17 octobre 2011 à 22:31, par fredjust En réponse à : Ma-lettre

    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

    • Le 17 octobre 2011 à 23:05, par fredjust En réponse à : Ma-lettre

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

      devait régler le problème

    Répondre à ce message

  • Le 31 août 2011 à 18:41, par Gerard FONTAINE En réponse à : Ma-lettre

    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

  • Le 12 mai 2011 à 20:09, par Brunof En réponse à : Ma-lettre

    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

Répondre à cet article

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 Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Owl Carousel 2

    30 novembre 2017 – 29 commentaires

    Owl Carousel est un diaporama jQuery adaptable aux différentes tailles d’écran, qu’on peut actionner par glisser, il utilise CSS3 mais il est compatible avec les vieux navigateurs, et il est aussi paramétrable. Le présent plugin permet d’utiliser (...)

  • Configuration des traitements de Formidable

    12 mai – 13 commentaires

    Une fois le formulaire et les champs créés formidable propose de « configurer les traitements » Cet article vise à préciser ou compléter quand ça semble nécessaire certains choix présents. Le premier choix consiste à savoir si on veut : « Poster par (...)

  • Menus

    18 août 2009 – 1005 commentaires

    Créez enfin vos menus facilement !

  • PHANTOM (HTML5UP)

    18 juillet – 29 commentaires

    Squelette SPIP pour intégrer le modèle Phantom de HTML5UP. https://html5up.net/phantom Installation A l’activation, le plugin installe aussi les plugins suivants : crayons, favicon, metasplus+, Couleur d’objet, champs extras, SPIP reset centre (...)

  • À propos des plugins actifs

    13 novembre 2010 – 28 commentaires

    À propos des plugins actifs affiche dans la partie publique de votre site la version de SPIP utilisée et la liste des Plugins activés avec affichage de l’icône, le nom, la version, l’état et une introduction de sa fonction. Si le Plugin n’a pas (...)