Version 5 — Février 2011 — JLuc
Rédaction participative en cours. Vous êtes invité à compléter ou donner votre avis.
Voir http://www.spip-contrib.net/ecrire/?exec=naviguer&id_rubrique=1417
Il contient les champs suivants :
- #TITRE, #TEXTE : toujours renseignés
- #DESCRIPTIF, #CHAPO, ... : renseignés si la configuration le demande
- #MESSAGE_HTML et #MESSAGE_TEXTE : ces champs renvoient le texte au format HTML et TEXTE de la lettre.
Ces valeurs sont calculées grâce aux squelettes spécifiés dans l’onglet de « Configuration avancée du plugin » :
Le résultat est stocké dans la base de donnée. En particulier, ce calcul est figé au début de l’envoi de la lettre, et c’est cette valeur qui est resservie ensuite à chaque fois, même si par exemple le squelette ou la base de donnée a changé entre temps.
Cela évite que les boucles renvoient des résultats différents au cours de l’envoi, et assure que tous les abonnés reçoivent la même lettre !
Les raccourcis tels que %%URL_VALIDATION_ABONNEMENTS%% ou %%EMAIL%%, apparaissent tels quels dans ces champs, car leur valeur dépend du destinataire de la lettre, et n’est calculée qu’au moment de l’envoi à un destinataire particulier.
A l’intérieur d’une boucle LETTRE, les champs #MESSAGE_TEXTE et #MESSAGE_HTML renvoient la valeur du message texte et html tel qu’il pourra être envoyé dans la lettre, ou tel qu’il a été envoyé , si la lettre a déjà été envoyée . Une fois envoyée, la valeur de ces 2 champs est figée.
A tester et mieux documenter
- #URL_FORMULAIRE_LETTRES renvoie l’adresse publique du formulaire d’inscription aux lettres
- #URL_LETTRE renvoie l’url de la page publique d’une lettre
Il y a une syntaxe spécifique pour des « raccourcis personnalisés » dont la valeur sera calculée au moment de l’envoi d’une lettre à un abonné particulier, et dont la valeur dépend de cet abonné.
5 raccourcis simples sont utilisés :
- %%URL_VALIDATION_ABONNEMENTS%%
- %%URL_VALIDATION_DESABONNEMENTS%%
- %%URL_VALIDATION_CHANGEMENT_FORMAT%%
- %%EMAIL%%
- %%CODE%%
Les 3 premiers intègrent l’adresse d’abonnement, utilisable pour un lien dans le mail, avec l’email de l’abonné cliquant sur le lien, et un code permettant l’authentification de la demande.
Les autres raccourcis concernent les champs NOM et les EXTRAS éventuellement définis sur les abonnés. Comme leurs valeurs sont facultatives, ils bénéficient d’une syntaxe enrichie, permettant de spécifier une valeur par défaut dans le squelette de la lettre :
- %%NOM|valeurpardefaut%%
renvoie le nom de l’abonné s’il est défini, ou valeurpardefaut
sinon