SPIP-Contrib

SPIP-Contrib

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

288 Plugins, 197 contribs sur SPIP-Zone, 144 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 – 116 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 : http://plugins.spip.net/malettre

Dernière modification de cette page le 22 octobre 2017

Retour en haut de la page

Tout afficher

Vos commentaires

  • Le 11 mars 2011 à 16:22, par aastudio En réponse à : Ma-lettre

    Bonjour,

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

    Merci,
    AA

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

      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)

    • Le 14 mars 2011 à 10:46, par AAstudio En réponse à : Ma-lettre

      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

    • Le 14 mars 2011 à 12:09, par AAstudio En réponse à : Ma-lettre

      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

  • Le 11 mars 2011 à 12:42, par Aurélien En réponse à : Ma-lettre

    bonjour,

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

    Merci
    Aurélien

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

      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

  • Le 26 janvier 2011 à 18:31, par Daniel En réponse à : Ma-lettre

    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

    • Le 26 janvier 2011 à 19:05, par Daniel En réponse à : Ma-lettre

      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

  • Le 23 novembre 2010 à 00:11, par Ben En réponse à : Ma-lettre

    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

  • Le 9 novembre 2010 à 13:59, par Stephane En réponse à : Ma-lettre

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

    • Le 9 novembre 2010 à 14:51, par erational En réponse à : Ma-lettre

      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

    • Le 9 novembre 2010 à 16:37, par Stephane En réponse à : Ma-lettre

      Merci cela fonctionne.

    Répondre à ce message

  • Le 11 octobre 2010 à 17:23, par Bluetak En réponse à : Ma-lettre

    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

  • Le 30 août 2010 à 12:53, par Kolote En réponse à : Ma-lettre

    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

  • Le 14 août 2010 à 23:53, par Kolote En réponse à : Ma-lettre

    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 ?

    • Le 22 août 2010 à 18:21, par Kolote En réponse à : Ma-lettre

      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 ?

    • Le 25 août 2010 à 18:09, par erational En réponse à : Ma-lettre

      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.

    • Le 25 août 2010 à 21:00, par Kolote En réponse à : Ma-lettre

      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

  • Le 13 août 2010 à 17:32, par chantelavie En réponse à : Ma-lettre

    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.

    • Le 25 août 2010 à 17:56, par erational En réponse à : Ma-lettre

      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

  • Le 4 août 2010 à 16:31, par Koala En réponse à : Ma-lettre

    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 !

    • Le 25 août 2010 à 17:49, par erational En réponse à : Ma-lettre

      pour le site en spip 192d :

    • Le 25 août 2010 à 17:52, par Koala En réponse à : Ma-lettre

      Merci erational. J’avais entre temps réglé le problème en passant le site en 2.1 ... il fallait le faire un jour ! ;)

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

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

  • ScolaSPIP 4

    19 janvier 2016 – 276 commentaires

    ScolaSPIP est plugin-squelette responsive personnalisable pour sites Web d’établissements scolaires basé sur SPIPr Présentation de ScolaSPIP Ce plugin pour SPIP 3 est développé par la Dane de l’académie de Versailles pour les webmestres de cette (...)

  • SPIP 3, Agenda et FullCalendar

    6 août 2012 – 317 commentaires

    Depuis SPIP 3, l’affichage d’un agenda sous forme de calendrier par jour/semaine/mois à changé. Les filtres |agenda_memo et apparentés sont désormais obsolètes. Il en est de même pour les filtres agendafull_memo et apparentés du plugin Agenda. (...)

  • cimobile : plugin « détection et aiguillage des téléphones mobiles »

    20 septembre 2011 – 111 commentaires

    Le plugin « cimobile » détecte les téléphones mobiles et les aiguille vers le jeu de squelettes correspondant. Pour détecter un mobile, il prend en compte le « User-Agent », un cookie, un paramètre d’URL, une URL spécifique pour mobile. Il n’utilise pas (...)

  • Couleur de Rubrique

    9 juin 2012 – 58 commentaires

    Le plugin Couleur de rubrique est maintenant adapté à SPIP3. Il permet d’attribuer une couleur par rubrique de façon très simple : un bloc est ajouté sur la page rubrique de l’administration de votre site, qui vous permet de déterminer une couleur, de (...)

  • Passer un site SPIP sous https://

    23 février – 15 commentaires

    Comment migrer simplement votre site SPIP de http:// vers https:// Le protocole https:// devient de plus en plus courant : C’est mieux pour la vie privée de tous La plupart des grands sites l’a déjà adopté Certains navigateurs commencent à afficher (...)