DocSpipLettres

Quelques brides de doc issues du cache de google ...

Une documentation destinée aux utilisateurs de SPIP-Lettres. Elle couvre les points essentiels du plugin.

Le fonctionnement de SPIP-Lettres a changé depuis sa version 2.6. Les abonnés ne s’abonnent plus aux lettres mais aux rubriques, ce qui permet de créer une lettre par campagne d’envoi et de gérer plus facilement vos abonnés.
Les rubriques comme abonnements
PNG

Les abonnés sont désormais associés aux rubriques de votre site SPIP. Chaque rubrique à laquelle est associé un abonné est un abonnement.

Le choix des rubriques que vous associez à un abonné est important car c’est lui qui définit quelles lettres il recevra.

Exemple 1 : un abonné associé à la rubrique Racine > Nos produits > Fromages recevra seulement les lettres rédigées dans la rubrique Fromages et ses sous-rubriques. On peut considérer que les lettres rédigées dans Racine > Nos produits > Saucissons ne l’intéressent pas.

Exemple 2 : un abonné associé à la racine du site recevra toutes les lettres, on peut considérer que tout l’intéresse.
Configuration du formulaire d’abonnement
PNG

Les internautes peuvent s’abonner à un nombre restreint de rubriques depuis le formulaire d’abonnement situé sur la partie publique de votre site. Vous pouvez limiter le choix de ces rubriques depuis l’espace privé. Rendez-vous à la page « Configuration > Lettres d’information », onglet « Configuration du formulaire d’abonnement » :

* sélectionnez la rubrique à laquelle les internautes pourront s’abonner
* donnez-lui un nom

Cela constitue un thème.

Si la liste comporte déjà des thèmes, c’est la mise à jour qui les a créées : ces thèmes correspondent aux rubriques dans lesquelles vous aviez publié des lettres d’information.

Pour modifier le nom d’un thème :

* supprimez le thème en question
* ajoutez un nouveau thème

Cela n’a pas d’incidence sur les abonnés de ces rubriques.
PNG

Cette restriction n’est valable que sur la partie publique puisque vous êtes libres de gérer les abonnements comme bon vous semble dans l’espace privé. Il s’agit uniquement de la configuration du formulaire d’abonnement.
Envois de lettres d’information

La différence majeure avec les versions antérieures à la 2.6 est la création d’une lettre par campagne d’envois.

Vous commencez par créer une lettre et tant qu’elle n’a pas été envoyée elle reste en cours de rédaction. Une fois la lettre envoyée, elle n’est plus éditable et elle est automatiquement archivée.

Le choix de la rubrique dans laquelle vous écrivez votre lettre définit qui recevra cette lettre : cf « Les rubriques comme abonnements ».

En bas de chaque lettre d’information en cours de rédaction figure une liste des abonnés qui recevront la lettre d’information. Il s’agit des d’abonnés :

* directs : ils sont abonnés à la rubrique dans laquelle se trouve la lettre d’information
* indirects : ils sont abonnés à une rubrique parente de la rubrique dans laquelle se trouve la lettre d’information

PNG

Lorsque vous visualisez une lettre en cours de rédaction, vous pouvez, au choix :

* tester son envoi avec pour destinataires les auteurs associés à la lettre
* l’envoyer
* la copier
* la supprimer

L’envoi des lettres se fait via un javascript, qui délivre les lettres 100 par 100. Les envois programmés ont été supprimés car les tâches de fond spip manquent de fiabilité.
Lettres envoyées

Selon le nombre d’abonnés qui reçoivent vos lettres, l’envoi peut prendre plus ou moins longtemps. L’état « en cours d’envoi » est donc intermédiaire. L’envoi terminé, vous aurez accès au taux d’ouverture de vos lettres, et vous pourrez visualiser les liens (contenus dans votre texte) les plus populaires. Ces statistiques ne sont disponibles que pour les lettres envoyées après la mise à jour SPIP-Lettres 2.6.

-------
[doctechartego<-]
La doc technique ARTEGO (juin 2008 - V. 2.6 du plugin)

Voir les copies de pages de archive.org :

Une documentation pour savoir comment personnaliser les squelettes de votre plugin SPIP-Lettres avec les boucles, critères, balises et formulaires spécifiques.

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_LETTRES retourne l’adresse où figure le #FORMULAIRE_LETTRES que vous avez renseignée dans la configuration du site. Par défaut il s’agit de spip.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.