Ressources Spip-Agora Clever Age

Utilisation des lettres d’informations, le 6 avril 2005

Ou comment s’en sortir avec les newsletters

Réaliser un modèle de lettre

Dans "Administration du site" / "Lettres d’information" / "Créer une nouvelle lettre d’information"

Dans un 1er temps, le plus important est d’indiquer quels squelettes devront être utilisés ainsi que le nombre d’articles composants la newsletter, ça se passe tout en bas :

Illust : newsletterA, 4.3 ko, 515x270

Dans mon exemple, j’utiliserais donc pour ma newsletter HTML le squelette nommé mon_squelette.html se trouvant dans mon dossier squelette (définit dans mes_options.php3, par défaut "afficher") et mon_squelette_txt.html pour ma newsletter TXT.

Si vous souhaitez modérer les inscriptions de votre newsletter, n’oubliez pas de préciser dans le texte des "Messages systèmes" pour l’inscription #URL# qui sert à générer l’URL de confirmation d’inscription et pour la désinscription #UNSUBSCRIBE# qui vous l’aurez compris sert à générer l’URL de désinscription. [1]

Pensez à configurer les quelques paramètres de votre module de newsletter ici "Administration du site" / "Configuration du site" / "Intéractivité" / "Configuration du module de lettres d’informations".

Gérer les destinataires

Les destinataires se gérent en fonction d’une newsletter, donc ça se passe ici : "Administration du site" / "Lettres d’information" / "votre newsletter" / "Gestion des..."

Illust : newsletterB, 2.8 ko, 200x188

Spip Agora distingue les destinataires des utilisateurs... familiarisez vous d’abord avec les utilisateurs.

Réalisation des squelettes

Exemple d’un squelette HTML :
<BOUCLE_newsletter(ARTICLES){id_post_newsletter}>
<html>
<head>
<title>#TITRE</title>
</head>
<body>
#TEXTE
<p>Si vous souhaitez vous désabonner de cette newsletter, cliquez sur le lien prévu 
à cet effet : <a href="#UNSUBSCRIBE#">Se désinscrire</a></p>
</body>
</html>
</BOUCLE_newsletter>

Exemple d’un squelette TXT :
<?php header ("Content-Type: text/plain;"); ?>
<BOUCLE_newsletter(ARTICLES){id_post_newsletter}>
[(#TITRE|version_texte)]
[(#TEXTE|version_texte)]
Si vous souhaitez vous désabonner de cette newsletter, cliquez sur le lien prévu 
à cet effet : #UNSUBSCRIBE#
</BOUCLE_newsletter>
<?php $flag_preserver = true; ?>

Composer une newsletter

Il vous faut simplement composer un article, le publier en ligne et retenir son ID !

Sélectionner/Envoyer une newsletter

Cette fois ça se passe dans "Edition du site" / "Lettres d’information". Choisissez le modèle que vous avez créé puis faites "Composer une nouvelle lettre".
Suivez les 3 étapes en précisant à l’étape 2 l’ID article que vous avez retenu...

Si tout va bien votre lettre est "en préparation" ; vous pouvez, avant de choisir de l’envoyer, prévisualiser votre newsletter :

Illust : newsletterC, 926 octets, 211x68

Maintenant vous pouvez choisir d’envoyer la newsletter, mais il reste une petite astuce car le fait de cliquer sur "Envoyer la Lettre d’information" ne sert qu’à remplir une table de la base de données... il vous faut lancer à la main la page ecrire/include/clevermail/admin/queue_process.php  [2] ou alors en ligne de commande.

Côté Front Office

La balise #FORMULAIRE_INSCRIPTION_NEWSLETTER permet d’afficher le formulaire d’inscription à la (aux) newsletter(s) mais c’est aussi lui qui valide les désinscriptions ; c’est pourquoi l’URL générée avec #UNSUBSCRIBE# doit pointer vers ce formulaire.

Illust : newsletterD, 1.8 ko, 163x221

[1] Si vous choisissez le type de modération "Fermée", personne ne pourra s’inscrire mais personne ne pourra non plus se désinscrire de votre newsletter !

[2] Il est désormais possible d’envoyer la newsletter sans cron