Comment utiliser l'outil de Newsletter "PloneGazette"

Après avoir correctement installé le produit PloneGazette (en tant qu'administrateur du site, Configuration du site --> Ajout/Supression de produits), différents nouveaux types de contenus sont alors disponibles :

• NewsletterTheme
• Subscriber

Le principe est d'ajouter un thème de newsletter (NewsletterTheme) dans lequel on pourra alors ajouter régulièrement diverses lettres d'informations (Newsletter).  Il est dès lors possible d'avoir plusieurs thèmes : par exemple une lettre d'informations communale, une lettre d'informations culturelle, ...  Le visiteur aura alors le choix de s'inscrire à l'une ou l'autre des lettres d'informations disponibles (ou à toutes évidemment).

Ajout d'un NewsletterTheme

Lors de l'ajout d'un thème de newsletter, divers champs devront obligatoirement être remplis en plus des champs habituels (Titre, Description) :

• Format par défaut des newsletter : l'inscrit peut choisir de recevoir la newsletter au format HTML ou au format Texte brut.  Choisissez ici le format par défaut qui sera proposé au visiteur
• E-mail de test : afin d'effectuer quelques tests d'envoi de newsletter, entrez un e-mail de test auquel les newsletter testées seront envoyées
• E-mail de l'auteur de la newsletter : ce champ renseigne l'adresse e-mail de l'auteur de la newsletter
• Reply-to : entrez ici l'adresse qui sera utilisée si la personne qui reçoit la newsletter répond à cette dernière
• Sujet du mail d'activation de l'abonné : lorsqu'un visiteur souhaite s'inscrire, un e-mail de confirmation lui est envoyé avec un lien qui lui permettra d'activer son inscription.  Renseignez dans ce champ le sujet de l'e-mail qui lui sera envoyé
• Texte du mail d'activation de l'abonné : lorsqu'un visiteur souhaite s'inscrire, un e-mail de confirmation lui est envoyé avec un lien qui lui permettra d'activer son inscription.  Renseignez dans ce champ le corps du texte de l'e-mail qui lui sera envoyé.  Attention, il est nécessaire dans ce cas de garder certaines variables telles que %(url)s qui contient l'url de confirmation de l'inscription
• Newsletter footer text : renseignez ici ce qui apparaîtra au bas de la newsletter envoyée aux inscrits.  Il y est notamment intéressant d'y spécifier un lien vers les préférences de l'inscrit ou la possibilité de se désinscrire
• Recevoir une notification pour chaque nouvel abonné, à l'adresse email de test : si cette case est cochée, un e-mail sera envoyé à l'adresse e-mail de test renseignée plus haut lorsqu'un nouvel abonné sera inscrit
• Template de rendu de la newsletter (TALES) : il est possible de décorer différemment la newsletter envoyée aux abonnés.  Par exemple, ajouter un entête, un pied de page, un logo, ...  Par défaut, le modèle de rendu n'ajoute rien d'autre que ce qui est renseigné dans la zone Newsletter footer text (zone ajoutée au bas de la Newsletter).  Il est possible cependant de définir un autre modèle de rendu.  C'est dans ce champ qu'il sera nécessaire d'en préciser l'identifiant
• Destinataires suplémentaires de la newsletter (TALES) : il est possible d'envoyer la newsletter à une source supplémentaire d'inscrits que la source par défaut (c'est-à-dire les abonnés s'étant inscrits via le site web).  Par exemple des inscrits présents dans une base de données externe, un fichier CSV, ...  Spécifiez dans cette zone la méthode python qui retourne ces destinataires supplémentaires
• Commande Shell Lynx : chemin vers la commande lynx nécessaire pour le fonctionnement de la newsletter.  Par défaut, il ne faut rien mettre dans cette zone
• Lynx options : spécifiez ici les options de la commande lynx nécessaire pour le fonctionnement de la newsletter.  Par défaut, il ne faut rien mettre dans cette zone
• Identifiant du dossier stockant les abonnés : PloneGazette propose un dossier particulier pour y stocker tous les abonnés du NewsletterTheme.  Lors de l'ajout du NewsletterTheme, ce dossier n'existe pas, voici la marche à suivre : ne rien y spécifier lors de la création du NewsletterTheme, enregistrer le NewsletterTheme, ensuite, ajouter un Plone Large Folder dans le NewsletterTheme (le nommer par exemple "abonnés"), rééditer le NewsletterTheme et y spécifier cette fois l'identifiant du Plone Large Folder dernièrement ajouté.  Si nécessaire le dossier contenant les abonnés (Plone Large Folder) devra être renommé avant d'en spécifier l'identifiant dans le NewsletterTheme car l'identifiant généré est du type : newsletterbtree.2007-10-26.0221239877...

Les onglets d'un NewsletterTheme

Lorsqu'un NewsletterTheme a été correctement ajouté et configuré, différents nouveaux onglets apparaissent alors :

Outre les habituels onglets "Contenu", "Voir", "Modifier" et "Propriétés", certaines nouvelles actions sont disponibles :

• Subscribe : cette action permet d'ajouter un abonné ou à un visiteur de s'abonner
• Informations : cette action donne à l'administrateur du NewsletterTheme une information détaillée sur les abonnés : nombre, adresse e-mail, format de la newsletter choisi, état de l'activation de l'inscription, ...
• Liste du contenu du dossier : cette action a le même comportement que l'action "contenu"
• Import : il est possible via cette action d'importer une liste d'abonnés via un fichier CSV

Ajout du portlet d'inscription

Lorsqu'un NewsletterTheme a été ajouté, le portlet d'inscription peut alors être ajouté dans la partie droite ou gauche du site (right_slots ou left_slots) en ajoutant la ligne : here/portlet_gazette/macros/portlet

Gestion des lettres d'informations d'un NewsletterTheme

Lorsque le NewsletterTheme a été correctement ajouté et configuré, il est alors possible d'ajouter une lettre d'information (Newsletter) dans celui-ci.  Pour ce faire, il faut passer par le menu "Ajout d'un élément" et sélectionner "Newsletter".  Une Newsletter se comporte comme un Document (Titre, Description, Corps du texte) mais avec une date d'émission supplémentaire qui peut être spécifiée.  Après avoir sauvegardé la Newsletter, un onglet particulier apparaît :

L'onglet "Test" : cet onglet permet de tester l'envoi ou l'aspect de la newsletter.  Il est possible de :

• visualiser la Newsletter au format HTML
• visualiser la Newsletter au format texte brut
• envoyer la Newsletter à l'e-mail de test définit dans le NewsletterTheme (pour celà, il faut ne faut pas que la Newsletter soit dans l'état "privé")

Modèle de rendu de la Newsletter

Par défaut, une Newsletter est envoyée telle quelle aux abonnés en y ajoutant la partie Newsletter footer text définie sur le NewsletterTheme.  Il est possible de créer un nouveau modèle de rendu (à définir dans la zone Template de rendu de la newsletter (TALES) du NewsletterTheme) qui permettra de personnaliser les styles et dispositions de la Newsletter envoyée.  Attention, le modèle de rendu n'est appliqué que lors de l'envoi de la Newsletter aux abonnés.

Conseils d'utilisation

• Tant que le NewsletterTheme est privé, il n'est pas visible par les anonymes et donc, les visiteurs ne peuvent s'y inscrire.  L'idéal est de laisser le NewsletterTheme dans l'état "brouillon" ou "publié" afin que les visiteurs puissent déjà s'y abonner même si aucune Newsletter n'est encore disponible
• Lors des tests ou de l'édition d'une nouvelle Newsletter, il suffit d'ajouter une Newsletter au NewsletterTheme et de mettre cette Newsletter dans l'état "privé".  De la sorte, la Newsletter n'est pas visible par les visiteurs anonymes et on a le loisir de faire les tests nécessaires
• Lors de la rédaction de la newsletter, si des images doivent être ajoutées, il est nécessaire d'utiliser des url absolues et non plus des urls relatives car l'e-mail envoyé aux abonnés n'a pas de notion d'urls relatives et les images n'y apparaîtront pas!  Dans tous les cas, avant l'envoi de la Newsletter, il faut effectuer les 3 tests disponibles (prévisualisation HTML et texte brut et envoi à l'e-mail de test)