Pour publier une lettre d’actualité avec le modèle fourni par défaut, vous pouvez vous contenter de configurer le plugin. Si au contraire vous souhaitez créer votre propre modèle de lettre, des étapes supplémentaires sont nécessaires.
Créer son modèle de lettre
Avertissement : si vous n’êtes pas familier de l’envoi de mail en HTML, il est fortement recommandé de consulter des articles spécialisés [1] avant de se lancer : le support des balises HTML et des divers styles CSS varient fortement d’un client de messagerie à l’autre.
Un autre pré-requis est de comprendre la syntaxe des squelettes SPIP. En effet, un modèle de lettre n’est autre qu’un squelette SPIP. Un article spécifique vous indique quelles balises utiliser pour quel résultat dans votre squelette.
Enfin, il vous faudra accéder au serveur hébergeant votre site, afin de déposer votre squelette et le faire reconnaitre par le site. Par exemple, si vous avez créé un squelette dans le fichier malettre.html, il vous faudra accéder au répertoire plugins/sibactu de votre serveur et placer le fichier html dans le sous-répertoire squelettes.
Il vous faudra également modifier le contenu du fichier templates.yaml de la manière suivante :
Au dessus de la dernière ligne, qui référence la lettre par défaut, vous devrez ajouter une entrée pour votre squelette malettre et donner une brève description qui apparaitra dans le formulaire Sibactu.
Configurer les lettres d’actualités
Tout comme Sibmail, Sibactu se configure depuis le menu de configuration des plugins dans l’espace privé de SPIP. Des titres par défaut sont proposés pour les différentes sections de la lettre : ces titres apparaitront dans le formulaire de création de la lettre d’actualité, mais pourront être changés également à ce niveau.
Configurer la notification des événements
Depuis la 4.2, si vous avez installé le plugin Agenda de Spip, Sibactu permet de générer automatiquement des lettres d’information présentant les événements à venir. Les notifications se configurent depuis l’espace privé de SPIP, au niveau du plugin Sibactu comme illustré ci-dessous.
Le modèle de lettre choisi ("notification" dans l’illustration [2]) doit correspondre à un squelette de message, et être placé dans le même répertoire que les squelettes de lettres d’actualités (plugins/sibactu/squelettes/notification.html dans le cas de l’exemple). Toutefois, le nom de ce squelette ne doit pas être listé dans le fichier templates.yaml cité précédemment.
Par défaut, la recherche d’événements est lancée toutes les 6 heures.
Le délai d’anticipation définit un horizon de recherche d’événements. Si le délai vaut N, les événements recherchés seront ceux dont la date de début est comprise entre demain et aujourd’hui + N jours.
Depuis la 4.3, un délai R de répit est instauré. Si un événement nouveau est détecté dans l’horizon de N jours, et uniquement dans ce cas, l’horizon est étendu à N+R jours. Comme Sibactu s’assure qu’un même événement n’est pas annoncé deux fois, ceci procure un répit aux destinataires et évite les avalanches de messages. Pour la même raison, la nouvelle version a supprimé le rappel la veille de l’événement. [3]
Notes:
[1] Par exemple sur le site Alsacreations.
[2] Les squelettes notification et exemple_agenda font partie de la distribution de Sibactu : le premier est complet et fonctionnel ; le second, beaucoup plus simple, est fourni à titre d’exemple pédagogique.
[3] En effet, avant cette modification, si par exemple des événements étaient programmés aux dates N, N+1 et N+2, les destinataires recevaient des messages trois jours de suite, et également trois rappels de suite la veille de chaque événement.