Cela pourrait bien vous servir
Rédigez pour le web
Générateur de formulaires
Editez vous-mêmes vos formulaires et consultez leurs résultats depuis l’espace privé de SPIP avec notre nouveau plugin SPIP-Formulaires.
Documentation technique
Boucles LETTRES
Une boucle de lettres d’information se code en plaçant LETTRES entre parenthèses :
<BOUCLEn(LETTRES) {critères...}>...</BOUCLEn>
Les critères de sélection :
-
{id_rubrique}retourne la liste des lettres d’information contenues dans la rubrique id_rubrique -
{id_secteur}retourne les lettres d’information contenues dans ce secteur -
{branche} -
{id_auteur}retourne les lettres d’information liées à cet identifiant auteur -
{id_mot},{titre_mot=xxxx}, ou{type_mot=yyyy}retourne les lettres d’information liées au mot-clé dont l’identifiant de mot-clé est id_mot, ou le nom est « xxxx », ou liées à des mots-clés du groupe de mots-clés « yyyy ». Attention, on ne peut pas utiliser plusieurs critères titre_mot=xxxx ou type_mot=yyyy dans une même boucle. Il faut aussi que vous ayez activé le plugin SPIP-Mots -
{id_groupe=zzzz}permet de sélectionner les lettres d’informations liées à un groupe de mots-clés ; principe identique au type_mot précédent, mais puisque l’on travaille avec un identifiant (numéro du groupe), la syntaxe sera plus « propre ». -
{lang}sélectionne les lettres d’information de la langue demandée dans l’adresse de la page. -
{recherche}trouve les lettres d’information pour le mot recherché
A moins que vous ne soyez en train de prévisualiser une lettre en cours de rédaction depuis l’espace privé (squelettes lettre_html.html et lettre_texte.html), seules les lettres au statut "envoyee" sont affichées dans le squelette lettre.html.
Les balises de la boucle :
-
#ID_LETTRE -
#TITRE -
#DESCRIPTIF -
#TEXTE -
#DATE -
#LOGO_LETTRE -
#URL_LETTRE
Boucles ARTICLES
Il est possible d’associer des articles aux lettres si vous activez cette option dans la configuration du plugin. A ce moment-là il devient possible d’intégrer des <BOUCLE_test(ARTICLES) {id_lettre}>...</BOUCLE_test> dans vos boucles.
#FORMULAIRE_LETTRES
Présent dans le répertoire formulaires/ du plugin SPIP-Lettres, ce formulaire sert à la gestion de l’abonnement d’un abonné :
- abonnement
- désabonnement
- changement de format
Ce formulaire va de paire avec le formulaire #FORMULAIRE_LETTRES_MESSAGES qui a pour vocation d’afficher le résultat d’une action déclenchée par #FORMULAIRE_LETTRES.
Dans votre dossier des squelettes, vous pouvez créer à l’intérieur du répertoire formulaires/ les squelettes formulaire_lettres.html et formulaire_lettres_messages.html en vous inspirant du code fourni par le plugin.
Personnaliser les lettres d’information
Par défaut les squelettes lettre_html.html et lettre_texte.html servent à générer les lettres d’information respectivement HTML et texte.
Vous pouvez changer ces paramètres dans la configuration de votre site SPIP.
Personnaliser les notifications
Vous pouvez de la même manière personnaliser les squelettes des notifications. Toutes les notifications de SPIP-Lettres sont présentes dans le répertoire notifications/ du plugin, vous pouvez vous en inspirer. Rangez vos notifications dans un répertoire notifications/ dans le dossier de vos squelettes.
Si vous gérez un fichier d’abonnés dans un logiciel externe, pour vos clients par exemple, vous pouvez être notifiés lors de la suppression d’un abonné pour éviter d’importer à nouveau cette personne.
Pour cela il vous suffit d’activer l’option correspondante dans l’admin de SPIP-Lettres.
Balises propres au plugin
-
%%URL_VALIDATION_ABONNEMENTS%%se place en principe dans les notifications liées aux abonnements, il sert à valider les abonnements -
%%URL_VALIDATION_DESABONNEMENTS%%se place soit dans les notifications liées aux désabonnements, soit dans une lettre d’information -
%%URL_VALIDATION_CHANGEMENT_FORMAT%%se place dans les notifications liées au changement de format de l’abonné -
#URL_FORMULAIRE_LETTRESretourne l’adresse où figure le#FORMULAIRE_LETTRESque vous avez renseignée dans la configuration du site. Par défaut il s’agit despip.php?page=lettres
Champs extra sur les abonnés
Nous avons ajouter la possibilité de récupérer des informations supplémentaires au sujet des abonnés en utilisant les champs extra. Suivez les étapes suivantes :
1. mes_options.php
Il faut déclarer ces champs extra dans votre fichier ecrire/mes_options.php :
<?php
// exemple avec un champ extra 'prenom'
// obligatoire (d'où le point d'exclamation)
$GLOBALS['champs_extra'] = Array (
'abonnes' => Array (
"prenom!" => "ligne|brut|Prénom"
)
);
?>
Bien entendu, intégrez ces lignes dans les vôtres. Reportez-vous à l’article sur spip-contrib.net pour une documentation sur les champs extra avec SPIP.
Pour rendre un champ obligatoire, ce champ extra doit se terminer par un point d’exclamation "!".
2. #FORMULAIRE_LETTRES
Il vous reste à ajouter du HTML dans votre le #FORMULAIRE_LETTRES, ça n’est pas automatique :
...
[(#REM) champ extra prenom! ]
<dl>
<dt><label for="prenom">Prénom</label></dt>
<dd><input type="text" name="prenom!" id="prenom" value="" /></dd>
</dl>
...
3. Personnalisez vos lettres
Dans vos lettres d’information, vous pourrez utiliser des raccourcis typographiques de la forme : %%NOM_DU_CHAMP_EXTRA|texte sinon%%, la casse du nom du champ est importante.
Dans l’exemple précédent, vous pourriez mettre dans le texte d’une lettre : Bonjour %%PRENOM!%%, comment ça va ? ou encore : Bonjour %%PRENOM!|à toi%%, comment ça va ?.
Ces raccourcis sont remplacés à l’envoi de la lettre seulement, vous obtiendrez %%PRENOM!%% lors de la prévisualisation d’une lettre d’information.
Dernier recours
Si vous avez lu toute la documentation et que vous ne trouvez pas les informations cherchées, adressez-nous votre question en remplissant le formulaire ci-dessous.