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.
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) | |
{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
version | date | remarque |
---|---|---|
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 |
Discussions par date d’activité
48 discussions
Bonjour,
Super plugin, simple et efficace, sauf que je ne peux le faire marcher que sous l’identité de webmestre du site ; si me logge comme simple administrateur d’une rubrique, je n’ai plus accés au plugin dans le menu Edition.
Est-ce normal ?
Merci
Versions : spip 3.0.8 et plugin « Ma lettre » = 3.2.0
Répondre à ce message
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
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.
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).
Bonjour,
Oui, j’ai bien revalidé la configuration. D’ailleurs il avait conservé tous les éléments de la version précédente.
Bonjour,
Je souhaite passer mon site de lettre à Spip 3.0.11 et installer la version de Ma-lettre 3.0
Je n’ai pas trouvé le script dont il est fait référence dans ce fil :
Le 8 juin 2012 à 09:04 par jeronimo74 En réponse à : Ma-lettre
Bonjour,
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:59 par erational En réponse à : Ma-lettre
bonjour
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).
Quelqu’un aurait-il une solution pour remplir la base de données ? Par avance je vous remercie
GeF
Répondre à ce message
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
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
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
bonjour
je viens d’installer aujourd’hui la dernière version
j’ai les mêmes erreurs d’envoi. j’utilise aussi facteur. je suis chez ovh. le test de facteur fonctionne, donc les paramètres sont ok.
merci en tout cas pour vos contributions
l’envoi par facteur était bugé.
normalement le bug est resolu avec la version 3.1.0 du plugin.
Répondre à ce message
Bonjour
Je viens d’installer ce super plugins mais j’ai un problème quand j’envoie les mails mes logos m’apparaissent pas.
Bonjour,
votre site est-il accessible en https, utilisez-vous le plugin « Redirection HTTPS » ? Si oui, et si le certificat de votre serveur web n’est pas signé par une autorité de certification, alors vous ne visualiserez pas les logos dans la lettre dans un client mail comme Thunderbird. Il faut, dans ce cas, importer votre certificat dans votre logiciel de courrier.
Cordialement
Répondre à ce message
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
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
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)Merci beaucoup.
Ca fonctionne.
Cordialement. Martine
Répondre à ce message
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 ?
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 :
Répondre à ce message
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
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
La page de configuration de Ma lettre se trouve
Bonjour,
merci pour votre réponse, en effet il me manquais le plugin cfg =)
encore merci et bonne journée
Répondre à ce message
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
Je viens de tester une installation nue avec Ma Lettre2.3 & SPIP 2.1.11.
Aucun problème à signaler.
Vérifier peut-être :
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 ?
Aucune précaution à prendre puisque le plugin ne requiert aucune table de base de données.
J’ai le même problème que toi Damien, aurais-tu trouvé une solution ?
D’avance merci.
++
Répondre à ce message
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 ?
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.
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
depuis la version 2.3, il faut passer par Config pour choisir les objets que vous voulez lister / cocher :
merci ça marche :)
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
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.
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
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
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.
Suivre les commentaires : |