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é
Une discussion
Bonjour,
J’utilise ce plugin depuis très longtemps et il fonctionne super bien. Merci. Il répond totalement à mes besoins.
Il y a une erreur que je ne suis jamais parvenue à résoudre et qui n’est heureusement pas bloquante :
L’aperçu de la lettre s’affiche bien. Par contre, dans le cadre « version html », le message suivant s’affiche :
Forbidden
et même chose pour la version texte :
Le répertoire lettre a les mêmes droits que tous les sous-répertoires d’IMG à savoir : 775. _malettre et_malettre_txt.html sont générés avec les droits 666.
Est-ce la cause du problème ?
Merci bien pour votre aide. Je ne trouve pas de solution. Mais ça n’est absolument pas bloquant.
Cordialement
Martine
Il y avait un vieux bug qui empêchait l’affichage du source TXT et HML sur certaines configurations.
C’est corrigé avec la version 4.1.1
Bonjour,
Merci beaucoup. J’attends donc de pouvoir télécharger cette version.
Bien cordialement
Martine
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 : |