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, ... Il n’utilise pas de base de données, vous pouvez donc l’installer et le désinstaller sans aucune crainte.
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
- Télécharger la dernière version du plugin Ma-lettre (pour SPIP 2)
- Télécharger l’archive du plugin Ma-lettre (pour SPIP 192)
A partir de la version 2.1, le plugin requiert SPIP-Bonux
Fonctionnalités
Elles sont volontairement restreintes :
- Création de newsletter au format HTML et TXT en multilingue
- 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 2.2, le plugin intègre automatiquement les abonnés du plugin Mes abonnés s’il est installé.. Il s’agit d’un support expérimental et pour l’instant ne gère pas les envois massifs (centaines d’emails)
Le plugin est sur la zone. Les contributions sont les bienvenues ...
Installation
- Copier dans le répertoire habituel ./plugins/ et activer le depuis le menu plugins
- Il est recommandé d’utiliser Config (cfg)
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) nouveautés janvier 2011
- vos expéditeurs
- destinataires courants.
Composer une lettre
Etape 0 : Choix de la langue nouveautés déc. 2008
Pour les sites multilingues, il est possible de choisir la langue dans laquelle on rédige la 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 : on coche
sélection libre d’articles : on indique les numéros
Etape 2 : Choisir les expéditeurs et destinataires
Choisir les éléments qui composent votre newsletter
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 2.1 et suivantes
2 fichiers uniquement définissent le patron des lettres envoyées
| nom fichier | description |
|---|---|
| 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 et précedentes
Il suffit d’éditer les fichiers squelette contenus dans le répertoire ma-lettre
| position | nom fichier | description |
|---|---|---|
| 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-code | Descriptif | Remarques |
|---|---|---|
{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) | version SPIP 2 uniquement |
Historique
| version | date | remarque |
|---|---|---|
| 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 |
plugin ma-lettre
Vos commentaires
# 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 :
# 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 :
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 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 :
# 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.
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
# Le 14 mars 2011 à 22:52, par Hélène
En réponse à : Ma-lettre
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.
# Le 15 mars 2011 à 00:23, par erational
En réponse à : Ma-lettre
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 ...
# Le 15 mars 2011 à 09:34, par Hélène
En réponse à : Ma-lettre
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.
# Le 15 mars 2011 à 15:26, par AAstudio
En réponse à : Ma-lettre
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
# 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