Carnet Wiki

Référence des boucles, balises et raccourcis etc de Spip-Lettres

Version 2 — Décembre 2010 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

1 - MESSAGE_TEXTE et #MESSAGE_HTML

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.

Ce calcul se fait à partir des squelettes spécifiés dans l’onglet de « Configuration avancée du plugin » :
-  squelette emails/lettre_html, par défaut, pour le MESSAGE_HTML
-  squelette emails/lettre_texte, par défaut, pour le MESSAGE_TEXTE

Ce calcul n’intègre pas la valeur des raccourcis tels que %%URL_VALIDATION_ABONNEMENTS%% ou %%EMAIL%%, dont la valeur dépend du destinataire de la lettre, et n’est calculé qu’au moment de l’envoi.

2 - Raccourcis personnalisés pour les emails

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