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 SPIP | Zip | Plugins 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
- Copier dans le répertoire habituel ./plugins/ et activer le depuis le menu plugins
- Il est recommandé de configurer le plugin
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.
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 : 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 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 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
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 |
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>
Historique
| version | date | remarque |
|---|---|---|
| 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 |
Version 2.3.2
RSS 2.0
Vos commentaires
# Le 29 janvier à 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 à 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 à 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 à 11:25, par Martine
En réponse à : Ma-lettre
Merci beaucoup.
Ca fonctionne.
Cordialement. Martine
Répondre à ce message
# Le 9 octobre 2012 à 19:44, par didier
En réponse à : Ma-lettre
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
# Le 5 décembre 2012 à 09:03, par yvan
En réponse à : Ma-lettre
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
# Le 10 décembre 2012 à 04:38, par erational
En réponse à : Ma-lettre
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
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
# 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 8 juin 2012 à 09:04, par jeronimo74
En réponse à : Ma-lettre
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
# Le 8 juin 2012 à 09:35, par jeronimo74
En réponse à : Ma-lettre
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.
# Le 8 juin 2012 à 09:59, par erational
En réponse à : Ma-lettre
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).
# Le 11 juin 2012 à 15:27, par jeronimo74
En réponse à : Ma-lettre
Bonjour,
Oui, j’ai bien revalidé la configuration. D’ailleurs il avait conservé tous les éléments de la version précédente.
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.
# 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 :
# 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 :
# 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