Newsletters

Ce plugin permet de composer des Info-lettres.

Par info-lettre, on désigne ici le contenu éditorial qui va être composé et envoyé par courriel à une liste d’adresses abonnées.

Le plugin permet de composer une info-lettre à partir d’un modèle pré-composé, d’un texte que vous pourrez rédiger spécifiquement, et d’une sélection d’articles et/ou de rubriques.
Si vous utilisez un outil externe pour composer vos info-lettres, vous pouvez aussi directement coller le contenu au format HTML (et au format texte pour l’alternative).

Enfin, ce plugin implémente la partie compose de l’API Newsletter.

Installation

Le plugin s’installe classiquement. Il nécessite le plugin Mailsubscribers pour la gestion des inscriptions et le plugin Mailshot pour l’envoi.

Configuration

La seule configuration du plugin concerne la possibilité de masquer certains modèles d’info-lettres. Vous n’en aurez pas besoin au départ, mais le plugin fournit certains modèles par défaut, et une fois que vous aurez choisi et/ou personnalisé celui qui vous convient le mieux, vous pourrez vouloir masquer les autres modèles pour ne pas risquer de vous tromper ou perturber vos rédacteurs.

Documents joints
Vous pouvez permettre de joindre des images ou autres documents aux infolettres, pour les utiliser dans le contenu éditorial spécifique.
Pour cela, allez dans le menu Configuration > Contenu du site, et dans le formulaire Documents joints en bas de page, cochez la case Infolettres en face de Activer le téléversement pour les contenus.

Composition d’une Info-lettre

Administration des info-lettres

Toutes les info-lettres existantes sont consultables depuis le menu Edition > Infolettres.

Composition d’une nouvelle info-lettres

En cliquant sur Créer une infolettre vous arrivez sur le formulaire de composition ci-dessous :

Il vous permet de choisir le modèle pré-composé, de fournir un chapeau et un texte et de faire une sélection d’articles et rubriques qui seront mis en avant dans l’info-lettre.

En bas du formulaire vous disposez d’une case à cocher qui permet de passer en mode édition avancée :

Dans ce mode là, vous composez directement le HTML et le texte qui seront envoyés par courriel. C’est un mode dans lequel vous maîtrisez tout, et qui peut vous servir si vous utilisez un autre outil pour composer le HTML de votre info-lettre.
Ce mode d’édition avancée est aussi le seul qui sera disponible une fois que votre info-lettre sera publiée. Il permet de corriger une éventuelle coquille dans le HTML ou le texte.

Mais revenons au mode d’édition simple en remplissant les différents champs et en faisant une sélection d’articles :

Après enregistrement, vous arrivez sur la page de présentation de l’info-lettre. Vous pouvez alors y associer un logo qui sera éventuellement utilisé dans le modèle pré-composé que vous avez choisi (ici le modèle basic).

Tant que votre info-lettre n’est pas publiée (ou que vous n’êtes pas en mode édition avancée), cette page ne présente que le contenu éditorial.

Pré-visualisation d’une info-lettre

Il faut passer en pré-visualisation pour voir la mise en forme réalisée par le modèle pré-composé qui va utiliser votre contenu éditorial. Cela se fait en cliquant sur le lien Prévisualiser dans le cartouche de gauche. Vous passez alors sur une page spécifique du site public, qui présente votre info-lettre dans sa version HTML [1] :

Cette prévisualisation vous permet par exemple de vérifier son affichage sur un écran de largeur réduite [2] :

Ou de voir aussi la version Texte du mail qui sera envoyé :

Le lien Version HTML email vous montre la version qui sera envoyée dans l’email, alors que le lien Version HTML en ligne vous montre la version qui sera affichée dans le navigateur pour les utilisateurs qui cliquent sur le lien « Voir cette Infolettre dans votre navigateur » présent en début d’email. Les deux versions sont par défaut très proches et ne se distinguent que par des petits détails masqués dans la version navigateur. Mais vous pouvez complètement les distinguer comme il sera vu par la suite.

Si vous avez des modifications à faire suite à cette prévisualisation, vous pouvez retourner modifier l’info-lettre via le formulaire d’édition. A chaque fois que vous faites une modification et enregistrez ou que vous prévisualisez, votre info-lettre est recomposée automatiquement à partir du modèle pré-composé et de vos contenus.

Test d’envoi d’une info-lettres

Une fois composée votre info-lettre, il est souvent nécessaire de l’envoyer par mail pour tester qu’elle s’affiche bien dans un lecteur de mail.
Vous disposez pour cela d’un formulaire sur la page de l’info-lettre :

Tant que vous n’avez pas publié votre info-lettre, vous ne pouvez l’envoyer qu’à une adresse email à la fois. De plus, par précaution, le sujet sera préfixé par l’avertissement [TEST]. Ceci vous évite la moindre confusion.

Publication d’une info-lettre

Après ce test d’envoi, vous pouvez alors publier votre info-lettre :

Votre info-lettre est alors recomposée une dernière fois par sécurité, les images sont copiées dans un dossier IMG/nl/xx/ pour ne pas risquer d’être perdues après l’envoi de l’info-lettre, et elle est passée en mode édition avancée sans possibilité de revenir en arrière.

Vous voyez alors que la page est modifiée dans ce contexte. Vous voyez directement les différentes versions HTML et Texte [3].

Dans ce mode, si vous essayez de modifier votre info-lettre, vous ne pourrez plus accéder qu’aux versions définitives composées, et non plus au contenu éditorial :

Envoi de l’info-lettre

Une fois publiée, vous pouvez envoyer cette info-lettre à l’aide du formulaire d’envoi présent sur la page :

La suite du processus d’envoi est décrite dans la documentation du plugin Mailshot.

Programmation d’une info-lettre

Un usage possible du plugin est de programmer une info-lettre qui sera générée et envoyée automatiquement selon une fréquence programmée.
Pour que cela ait un sens, le contenu de l’info-lettre doit se générer automatiquement à chaque nouvel envoi. Cela ne peut se faire qu’avec un modèle dédié conçu pour cela. Voyons un exemple avec le modèle Nouveautés fourni avec le plugin.

Cliquez sur l’icône Programmer une infolettre depuis la page d’administration des info-lettres. Vous arrivez alors sur un formulaire complet de programmation :

Ce formulaire vous permet de définir le titre, la récurrence de l’envoi, le modèle à utiliser pour composer automatiquement l’info-lettre. Vous pouvez aussi renseigner un chapeau et un texte et faire une sélection d’articles et rubriques, mais cela a souvent moins de sens car il vaut mieux que tout le contenu soit calculé automatiquement par votre modèle.

Pour la récurrence d’envoi, vous fixez une date et heure de début à partir de laquelle l’envoi sera programmé. Puis vous fixez la fréquence de répétition :

  • tous les jours
  • toutes les semaines, avec la possibilité de choisir quel(s) jour(s)
  • tous les mois
  • toutes les années

Dans tous les cas vous pouvez fixer un intervalle (tous les 2 jours, 3 semaines...). Vous pouvez également fixer une fin à l’envoi automatique : après un nombre d’occurrences [4], ou à une date précise.

Pour l’envoi, vous avez deux choix non exclusifs :

  • l’envoi en test à une adresse mail
  • l’envoi direct sur une liste d’inscrits

Choisissez par exemple juste le premier pour recevoir une version de relecture dans votre boîte mail, et vous n’aurez plus qu’à lancer manuellement l’envoi en nombre si cela vous convient.

Une fois tout bien rempli cela donne par exemple, pour un envoi quotidien automatique des nouveautés, à 10h, aux inscrits à la liste newsletter :

Enregistrez pour voir votre info-lettre programmée dans la liste des info-lettres :

Automatisme d’envoi

A chaque nouvelle occurrence de la date programmée, le plugin va essayer de composer la version HTML de l’info-lettre avec le modèle sélectionné. Si celle-ci est vide, il considère qu’il n’y a rien à envoyer et se reprogramme à la date de la prochaine échéance.

Si le contenu composé n’est pas vide, le plugin crée alors une nouvelle info-lettre avec le titre, chapo, texte et sélection d’article qui ont été programmés. La date de l’info-lettre est positionnée à la date de l’occurence et la date de rédaction antérieure de l’info-lettre est fixée à la date du dernier envoi [5]
L’info-lettre est alors composée avec le modèle, et le plugin envoie une version de test sur l’adresse email programmée si nécessaire, puis publie l’info-lettre. Si un envoi à une liste a été défini, celui-ci est automatiquement déclenché.

A noter que si pour une raison ou une autre le plugin rate une échéance (site en panne ou pas de visites sur le site), il fusionnera toutes les occurrences ratées et fera son envoi à la dernière occurrence passée.

Création d’un gabarit

Comme vu plus ci-avant, les Info-lettres sont en général générées à partir de modèles pré-composés que l’on appelera ici gabarits [6]. Ces gabarits sont en fait des squelettes SPIP, rangés dans le dossier newsletters/. Vous pouvez en ajouter dans votre dossier squelettes/newsletters/, ou personnaliser un modèle fourni dans le dossier newsletters/ du plugin en le copiant dans votre dossier squelettes/newsletters/ avant de le modifier.

Un gabarit est constitué au moins d’un squelette pour la version HTML de l’email. Il peut être accompagné de 2 variantes facultatives pour la version Texte de l’email, ainsi que pour la version HTML de l’info-lettre telle qu’affichée dans le navigateur.

Gabarit HTML

Pour créer un gabarit de la version HTML de votre email, créez simplement un fichier mongabarit.html dans votre dossier squelettes/newsletters/.

Il va alors apparaître automatiquement dans la liste des modèles disponibles quand vous créez une nouvelle Info-lettre :

Le nom du fichier gabarit apparaît entre crochets. Pour lui donner un petit nom en clair, ajoutez en début de votre fichier mongabarit.html [7] :

<BOUCLE_rem(CONDITION){si #REM}>
<!-- titre=Mon gabarit à moi -->
</BOUCLE_rem>

Le titre en clair de votre gabarit apparaît alors dans l’interface d’édition des info-lettres :

Mais pour l’instant votre gabarit n’affiche rien. Ajoutons le code minimum suivant :

<BOUCLE_newsletter(NEWSLETTERS){id_newsletter}{statut?}>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>#TITRE</title>
	</head>
	<body>
	<h1>Hello World !</h1>
	</body>
</html>
</BOUCLE_newsletter>
#FILTRE{newsletters_liens_absolus}

On peut voir qu’on a ici :

  • ajouté une boucle NEWSLETTERS : celle-ci doit avoir les deux critères {id_newsletter}{statut?} pour bien s’afficher sur l’info-lettre en cours de composition, quel que soit son statut ;
    • si vous avez configuré l’utilisation des langues sur les newsletters, vous devrez compléter cette boucle avec le critère {lang_select}, et veiller à ce que cette langue soit transmises aux squelettes inclus en passant {lang} aux #INCLURE.
  • inséré dans la boucle le code minimum d’une page HTML :
    • DOCTYPE
    • balises <html>,<head>,<body>
    • un <title> dans le <head>
    • un <h1> dans la page
  • complété avec un appel à #FILTRE{newsletters_liens_absolus} : cet appel vous sera bien utile car il transformera les URLs des liens et des images en URLs absolues qui fonctionneront dans tous les cas [8]

Dans cet exemple minimal, on utilise la balise #TITRE pour récupérer le titre de l’info-lettre tel qu’il aura été rempli dans le formulaire d’édition.

Les balises disponibles dans dans la boucle NEWSLETTERS sont :

  • #TITRE : le titre de l’info-lettre
  • #CHAPO : le contenu du chapeau de l’info-lettre
  • #TEXTE : le contenu du texte de l’info-lettre
  • #URL_NEWSLETTER : l’url publique qui permet de voir l’info-lettre en ligne, dans le navigateur
  • #LANG : la langue de l’info-lettre
  • #DATE : la date de publication de l’info-lettre
  • #DATE_REDAC : la date de rédaction antérieure de l’info-lettre (correspond à la date de la dernière occurrence dans le cas d’une info-lettre programmée)

Par ailleurs, la récupération des articles et rubriques sélectionnées dans une info-lettre se fait au moyen des boucles suivantes :

<ul>
<BOUCLE_selectionarticles(ARTICLES){id_newsletter}>
<li><a href="#URL_ARTICLE">#TITRE</a>
</BOUCLE_selectionarticles>
</ul>

<ul>
<BOUCLE_selectionrubriques(RUBRIQUES){id_newsletter}>
<li><a href="#URL_RUBRIQUE">#TITRE</a>
</BOUCLE_selectionrubriques>
</ul>

Pour la structure HTML de votre info-lettre, vous pourrez avantageusement vous inspirer des ressources suivantes [9] :

Vous pouvez aussi partir des deux gabarits fournis dans le plugin :

  • basic.html est inspiré des gabarits HTML fournis par Mailchimp, avec des améliorations pour prendre en charge l’affichage dans les petits écrans ;
  • letter.html est inspiré des mails HTML envoyés par le service Feedburner ; il repose sur une approche plus simple avec un minimum de stylage pour laisser les styles par défauts des lecteurs de mail.

Si vous faites de beaux gabarits robustes, n’hésitez pas à les ajouter au plugin pour en faire profiter le plus grand nombre.

Pour finir, une petite astuce de travail : pour dégrossir la mise en forme de votre gabarit lors de sa réalisation, vous pouvez directement l’afficher dans votre navigateur (si vous avez bien le statut de webmestre) par l’url spip.php?page=newsletters/mongabarit&id_newsletter=1 en choisissant bien un id_newsletter d’une info-lettre existante. Cela vous permet ainsi de visualiser rapidement toutes vos modifications sans avoir à générer une info-lettre et faire des aller-retour entre le mode prévisualisation et l’espace privé de SPIP.

Gabarit Texte

Les emails HTML sont toujours accompagnés d’une alternative au format texte, qui est affichée dans les lecteurs de mail ne supportant pas le HTML, ou si l’utilisateur à choisi ce réglage dans ses préférences.

Il est donc crucial de bien générer une variante texte du gabarit HTML. Si vous ne fournissez aucun gabarit pour la variante texte, le plugin va automatiquement générer une version texte à partir du HTML. Cette version texte repose sur une conversion au format MarkDown, avec quelques structurations supplémentaires (analyse des structures <table> du mail HTML pour générer des séparations structurelles dans la version texte).

Dans la plupart des cas, la version texte automatique est suffisante. Mais si vous voulez avoir un contrôle fin de ce que vous envoyez, vous pouvez créer un second gabarit pour la version texte : créez un second fichier mongabarit.texte.html dans votre dossier squelettes/newsletters/. Ce gabarit sera alors utilisé pour générer la version texte de votre email.

Mettez y la boucle (NEWSLETTERS) comme dans la version HTML, et composez le contenu de votre email en texte, en utilisant les mêmes boucles et balises que dans la version HTML.

Gabarit HTML pour la version en ligne

Lorsque votre info-lettre est affichée dans le navigateur, c’est par défaut le HTML de l’email envoyé qui est utilisé.

Toutefois, certaines informations ne sont pas pertinentes dans la version en ligne (par exemple le texte qui dit « vous pouvez voir cette infolettre en ligne »).
La feuille de style css/newsletter_inline.css est automatiquement ajoutée dans la page de la version en ligne. Il est ainsi possible de faire de petits ajustements CSS pour masquer certains blocs de texte, ou modifier quelque peu l’apparence de la version affichée dans le navigateur.

Si cela ne vous suffit pas, ou que vous voulez présenter en ligne une version très différente, qui reprend par exemple une partie de la charte graphique du site public, vous pouvez générer une version spécifique de votre info-lettre.

Pour cela créez un second fichier mongabarit.page.html dans votre dossier squelettes/newsletters/. Ce gabarit sera alors utilisé pour générer la version de votre info-lettre affichée dans le navigateur.

Personnalisation des info-lettres

Pour finir abordons l’aspect personnalisation. Dans de l’envoi en nombre il peut être utile et profitable de personnaliser chaque email envoyé en fonction de son destinataire.

Pour cela, le plugin propose un système de variables à deux niveaux, qui sont remplacées au moment de l’envoi, en fonction du destinataire.

Variables simplifiées

Les variables simplifiées s’expriment sous la forme @nomdelavariable@.
Chaque variable qui apparait ainsi dans l’infolettre composée est remplacée par son contenu. Si la variable n’est pas connue ou pas fournie, elle est simplement retirée (remplacée par un contenu vide).

Ces variables peuvent être utilisées dans le gabarit de l’info-lettre, mais aussi dans les champs titre, chapeau et texte de l’info-lettre.

La liste des variables disponibles dépend en fait du plugin d’envoi Mailshot, qui se charge d’appeler cette fonction dite « de contextualisation » juste avant chaque envoi. En plus des variables utilisateurs fournies par Mailshot la date courante est aussi disponible sous le nom date.

Langage SPIP

Pour des besoins plus complexes, il est possible d’utiliser le langage de squelette SPIP pour contextualiser l’info-lettre. Toutes les variables sont disponibles sous la forme #ENV{nomdelavariable}.

L’avantage de ce format est que l’on peut appliquer des filtres sur les valeurs des variables, ou indiquer une valeur par défaut quand la variable n’est pas fournie.

Il est donc possible d’utiliser une balise SPIP de ce type dans les champs titre, chapeau et texte de l’info-lettre : elle sera remplacée au moment de l’envoi.

Par exemple, pour faire un titre d’infolettre programmée qui change automatiquement en fonction de la date d’envoi, on y mettra :
Nouveautés du [(#ENV{date}|affdate)]

Pour utiliser ce formalisme dans les gabarits, il faut faire un peu plus attention. En effet si vous mettez simplement le code

<h1>Bonjour #ENV{nom}</h1>

dans gabarit, #ENV{nom} sera calculé lorsque l’info-lettre est générée et non au moment de l’envoi.

Il faut donc échapper la balise pour qu’elle ne soit pas évaluée lors de la génération, et reste dans l’email pour être évaluée au moment de l’envoi :

<h1>Bonjour \#ENV{nom}</h1>

C’est ainsi comme si on avait mis un @nom@ : c’est une variable de personnalisation, qui est calculée pour chaque destinataire

Le corrollaire de cette fonctionnalité, c’est que si vous voulez écrire du langage SPIP dans le texte votre infolettre envoyée [10], il faudra échapper les balises et les boucles pour éviter que celles-ci ne soient évaluées lors de la contextualisation.

Les variables accessibles par #ENV sont les mêmes que par le système de variables simplifiées [11].

Migration depuis un ancien plugin

Les anciens plugins SPIP-Listes, SPIP-Lettres et autres ne distinguaient pas réellement le contenu éditorial de l’infolettre et son envoi. Ainsi les info-lettres envoyées dans le passé avec ces plugins sont importées dans l’historique des envois par le plugin Mailshot et pas comme objet Newsletter par ce plugin.

Par ailleurs, le passage à ce plugin nécessitera que vous adaptiez vos gabarits selon les consignes indiquées plus haut, ou que vous utilisiez un des gabarits prêt à l’emploi du plugin.

Notes

[1la prévisualisation des différents formats peut ne pas fonctionner sur certains anciens navigateurs. Cliquez sur le lien (afficher sans iframe) pour voir la version HTML de la newsletter dans ce cas

[2les modèles pré-composés fournis avec le plugin gèrent l’affichage sur les petits écrans

[3sauf sur certains anciens navigateurs qui ne permettent pas cet affichage embarqué propre

[4Attention : il s’agit bien du nombre de récurrence de la date, même si aucun mail n’est envoyé faute de contenu

[5Le modèle peut ainsi sélectionner des contenus pertinents depuis le dernier envoi

[6pour éviter la confusion avec les modèles SPIP

[7Attention à bien utiliser le charset UTF-8 pour votre fichier

[8Ce filtre n’est pas automatiquent appliqué si vous ne le mentionnez pas pour vous laisser le contrôle total sur vos liens que vous pouvez choisir de gérer au cas par cas

[9on ne développe pas ici toutes les spécificités et les difficultés à concevoir des mails HTML robustes et qui s’affichent bien dans tous les lecteurs de mail, le web est plein de ressources sur le sujet

[10peut-être vous éditez un site qui s’adresse aux utilisateurs de SPIP ?

[11d’un point de vue technique, les variables simplifiées @nomdelavariable@ sont en fait traduites en #ENV{nomdelavariable,''} avant évaluation

Discussion

244 discussions

  • 1

    Bonjour,

    j’ai un soucis depuis le passage sous SPIP 4.1.7 avec le plugin Newsletters 2.1.0. et PHP 7.4.33.

    J’ai tout d’abord eu le problème des brèves que j’ai résolu en réactivant Brèves dans le site.

    Mais depuis, plus d’erreur visible, la tâche planifiée reprogramme à la semaine suivante chaque semaine en considérant qu’il n’y a pas de nouveaux articles... alors qu’il y en a.

    Le modèle utilisé est « [nouveautes] Nouveautes » mais les autres modèles produisent le même résultat.

    Aurais-je louper quelque chose dans ce passage de la version 3.2 à 4.1 ?

    Merci d’avance pour l’aide que vous pourrez m’apporter.

    • Je me réponds à moi-même, après avoir supprimer les programmations présentes avant la mise à jour puis mise en place de nouvelles avec les mêmes critères, cela fonctionne de nouveau... et c’est le principal ;-)

    Répondre à ce message

  • Bonjour,
    Depuis plusieurs mois, quand on crée des infolettres sur le site https://lyon-ouest.cio.ac-lyon.fr/, les images n’apparaissent pas dans l’envoi par mail. Pas de souci dans l’envoi de la même lettre en mode test avant publication. Mais systématiquement les images sont remplacées par des rectangles blancs après le vrai envoi.
    Une idée de ce qui peut dysfonctionner ?

    Version SPIP : 3.2.16
    Version Newsletters : 1.6.4
    Modèle utilisé : basic
    Version PHP : 7.4.33
    BDD : MariaDB 10.2

    Merci d’avance.

    Répondre à ce message

  • 1

    Sous SPIP 4.1 , Newsletters 2.0.4 , si je veux créer une infolettre non programmée avec le modèle « Nouveautés » j’obtiens des erreurs SQL 1525 :
    SELECT articles.lang, articles.titre FROM spip_articles AS articles WHERE (articles.statut = ’publie’) AND (articles.date <= ’2023-02-12 16:54:13’) AND (articles.date > ’’) AND (articles.id_rubrique > « 0 ») LIMIT 0,1
    dans la boucle calculer_select() sql_select() ;
    Merci de votre aide

    • Solution : après avoir enregistré l’infolettre et avant de la publier , il faut modifier sa « date de rédaction antérieure » en indiquant une date à la place de « 0000 » !

    Répondre à ce message

  • 1

    Bonjour,
    spip 4.1.7, plugin newsletter 2.1.0 php7.4.30 modèle [Basic] simple (une colonne, responsive)
    L’intégration d’un lien avec cette écriture :
    [https:nom_du_site.fr->nom_d_site.fr] produit en fait un lien <https:nom_du_site.fr/ecrire/>
    aussi bien dans le message en html que dans le version texte.
    C’est juste une perturbation. Le reste est bien au point.
    Cordialement alain

    • Je me réponds :
      En relisant le paragraphe langage SPIP, j’ai appliqué la préconisation en écrivant avec l’échappement \ avant -> :
      [https://nom_du_site.fr\->https://nom_du_site.fr]
      et la c’est ok.
      Alain

    Répondre à ce message

  • Bonjour,

    Environement :
    spip 4.1.5 + Newsletters 2.1.0 + php 7.4 + mutualisation sur hébergeur infomaniak

    erreur dans le back office
    Erreur d’exécution ../plugins/newsletters/newsletters/nouveautes.html | File […]/ecrire/inc/filtres.php Line 4879 : Argument 1 passed to generer_objet_introduction() must be of the type int, null given, called in /home/clients/b313813ae3dfa81e21eb5a95d7ad323f/sites/paroisse-benet.fr/tmp/cache/skel/html_dd7209438c0e2e528f16965331aa2302.php on line 319

    erreur courriel
    Erreur d’exécution ../plugins/newsletters/newsletters/nouveautes.html

    Ce que j’ai réalisé :
    https://git.spip.net/spip-contrib-extensions/newsletters/issues/11
    on supprime la ligne 20
    résultat erreur disparais
    1° ) Table SQL « BREVES » inconnue
    2° ) Erreur d’exécution ../plugins/newsletters/newsletters/nouveautes.html | File […]/ecrire/inc/filtres.php Line 4879 : Argument 1 passed to generer_objet_introduction() must be of the type int, null given, called in […]/ecrire/public/composer.php(96) : eval()’d code on line 71

    et on supprime les lignes faisant référence a BREVES
    resultat erreur disparais
    Erreur d’exécution ../plugins/newsletters/newsletters/nouveautes.html | File […]/ecrire/inc/filtres.php Line 4879 : Argument 1 passed to generer_objet_introduction() must be of the type int, null given, called in […]/ecrire/public/composer.php(96) : eval()’d code on line 71

    Cela refonctionne , merci de votre aide ...

    Répondre à ce message

  • 14

    Bonjour,
    Super plugin comme toujours !
    Je me demande si c’est possible de récupérer le contenu des newsletters dans une rubrique.
    J’ai trouvé comment les lister, peut-être pas de la meilleure façon, comme suit :

    <BOUCLE_newsletters_all(NEWSLETTERS)><a href="#URL_NEWSLETTERS"><h4>&gt;&nbsp;#TITRE</h4></a></BOUCLE_newsletters_all>

    Ainsi, on récupère la liste, on peut cliquer pour ouvrir leur version HTML, mais on n’a pas de navigation contextuelle une fois ouverte, c’est le modèle de la news.
    Est-ce qu’il serait possible de les intégrer directement dans un gabarit d’article ?
    Une cliente souhaite rendre leurs archives disponibles sur son site…
    Cordialement,
    Karen

    • tu pourrais créer un modèle https://www.spip.net/fr_article3454.html

      un squelette dans le dossiers modeles, et ensuite tu intégre cela où tu veux :)

    • Bonsoir et merci pour ta réponse rapide !
      J’ai bien tenté cette piste mais je cale.
      En fait j’ai amélioré mon appel dans le squelette « rubrique » dédié, comme suit :

      <B_newsletters>
      <div class="menu menu_articles">
      	<ul>
      		<BOUCLE_newsletters(NEWSLETTERS)>
      			<li><a href="#URL_NEWSLETTERS">#TITRE</a></li>
      		</BOUCLE_newsletters>
      	</ul>
      </div>
      </B_newsletters>

      J’obtiens bien ma liste de newsletters dans la rubrique concernée, avec un lien vers chaque news, mais ensuite je cale pour créer le modèle qui affiche la news concernée, et surtout, pour que le contenu se retrouve dans un squelette qui contient tout l’ensemble : le header, les menus, etc.
      Je vois mes limites dans le codage de spip, du dynamique en général :-/ !!!

    • Je précise que j’ai creusé la piste des modèles et je t’en remercie, mais je ne vois pas comment relier le lien d’une news à un contenu de news précis, pour chaque lien listé en rubrique…

    • Heu... je suis pas sur de comprendre le besoin exact.

      Tu veux bien afficher ta newslettre dans un article, comme tu afficherai une image.
      Ou bien tu voudrai une page « newlettre » comme tu as des pages « article » ?

    • Je voudrais en effet que le contenu des newsletters puisse être affiché comme des articles et l’ensemble listé comme des listes d’articles dans une rubrique :-)

    • bah du coup faudra créer ton propre squelette en imitant la structure de ton jeu de suqelette, et en mettant le bonne boucles.

      Je t’inviterai du coup à rechercher les squelettes utilisé avec ?var_mode=inclure et à te baser dessus.

      EN tout cas là sans précision de ce que tu utilise, difficile de t’aider plus .... mais en gros les boucles newletter ne sont pas différents des autres boucles..

    • Mes squelettes sont très proches de ceux de la distribution, je n’ai fait que supprimer forum, recherches, etc. et touché surtout au portfolio et au css.
      Je ne vois pas ?var_mode=inclure dans les squelettes rubrique et article de la distribution, pour m’en inspirer ?

      En fait, je que je voudrais, c’est que :
      – soit le contenu de chaque news ait la même apparence qu’un article normal quand on l’appelle à partir le la rubrique sur laquelle j’ai mis le code montré plus haut et qui liste les news, donc une sorte de gabarit autre que celui réservé aux news pour leur affichage en messagerie, mais plutôt un gabarit « article-xx »,
      – soit que l’on puisse appeler le contenu inséré dans chaque news (#TITRE, #TEXTE et les images…) dans la partie « .content » des articles de cette fameuse rubrique-xx dédié à leur affichage conforme aux pages normales du site.

      Peu importe, au final, le but est d’afficher les newsletters publiées dans le site avec la même apparence que les autres articles. Mais je ne sais pas si c’est possible et si oui, comment ?

      Je suis désolée de na pas arriver à être plus clair, je pensais que ça l’était… ça l’est dans ma tête en tout cas, mais ça ne suffit pas !

    • Pas possible, les rubriques ne contienent pas des lettres, qui ne sont pas des articles.

      Par contre tu peux te créer une squelette newletters.html qui listera toutes tes lettres de la même manière que rubrique.html liste toutes les rubrique, et un squelette newletter.html qui présentera une newletter avec la même présentation que article.html

      pour le var_mode=inclure, lit cet article https://www.spip.net/fr_article4453.html

    • Ouiii ! C’est exactement ça que je cherche à faire, mais je suis perdue… Je ne trouve pas comment faire pour écrire ces squelettes ni où les placer :-(
      Pour le moment, j’ai créé un « rubrique-8.html » qui liste les newsletters (code que j’ai publié hier soir), mais quand on clique sur les liens des newsletters, forcément on ouvre l’aperçu html desdites newsletters.
      Il me manque une compréhension de la procédure je crois ;p ! J’ai fait plein d’essais mais aucun ne fonctionne parce que je ne réfléchis sans doute pas comme il faut !
      Bon, je crois que je vais laisser tomber et m’en tenir au listage des news comme j’ai réussi à le faire, sans qu’elles aient leur gabarit spécifique…
      Bonne journée et merci pour ton temps et ces pistes, même si je n’ai pas le niveau de compréhension.

    • Bonjour,
      Si tu appelles un squelette « newsletter » c’est le squelette par défaut de la newsletter qui est appelé.
      Si tu crées un squelette avec un autre nom (par exemple « infolettre ») tu peux l’appeler comme ceci dans un squelette rubrique (par exemple) :

      <B_nl> 
      <ul>  #ANCRE_PAGINATION
      <BOUCLE_nl(NEWSLETTERS) {statut=publie}{patron!=interne}{!par date}{pagination}>
      <li> [(#DATE|affdate)]
      <h3><a href="#URL_PAGE{infolettre,id_newsletter=#ID_NEWSLETTER}" title="lire">
      #TITRE
      </a></h3>
       [(#CHAPO)]
      </li>
      </BOUCLE_nl>
      <ul>
      [<p class="pagination" aria-hidden="true">(#PAGINATION{page})</p>]
      </B_nl>

      et donc dans ton squelette « infolettre » tu peux recopier ce qu’il y a dans « newsletter » sans les styles inline.

      J’ai des exemples en producton si tu as besoin.
      dd

    • Hourra ça fonctionne :-) !
      Un grand merci, tu viens de sauver mon premier week-end déconfiné !!
      C’était bien que tu ne m’aies pas donné la solution d’entrée pour que je cherche un peu, et comprenne mieux. Mais honnêtement je n’aurais jamais trouvé la syntaxe du lien, ou après gros découragement !
      J’ai cherché à savoir ce qu’était ton critère « patron » mais je n’ai pas trouvé, à par ça :https://contrib.spip.net/Realiser-des-patrons, mais pas de critère « patron » ?
      Encore un grand merci et bon week-end à toi !

    • Parfait !
      « patron » = gabarit = le modèle de newsletter choisi au moment de la rédaction de la newsletter.
      Je ne sais plus où j’avais trouvé ce truc bien utile pour sélectionner selon le modèle.

    • J’ai terminé mon intégration et ça fonctionne nickel, c’est top ! Merci DD :-)
      Pour « patron »… c’est ce que j’avais supposé mais que je mette le critère ou non ça ne change rien, c’est pour ça que je me posais la question. J’imagine que ça dépend du contexte de ton code général…
      Merci encore et bon week-end !

    • Bonjour,

      Je déterre ma demande d’aide de 2020 où je cherchais à appeler un squelette perso « infolettre » pour afficher mes newsletters dans le même style que mes articles, à partir d’un squelette rubrique qui liste ces newsletters (en gros, avoir une rubrique qui les archive et les montre avec la mise en page du site plutôt que celle par défaut des newsletters en ligne).

      DD m’a aidée et j’appelle donc mes newsletters depuis une rubrique-x.html avec le code suivant :

      <a href="#URL_PAGE{infolettre,id_newsletter=#ID_NEWSLETTER}">

      Ça fonctionne très bien, sauf que les urls ne sont pas réécrites, et que si j’appelle avec #URL_NEWSLETTER au lieu de #URL_PAGE, ce sont forcément les modèles de newsletter « voir en ligne » qui sont appelés.
      J’ai bien essayé :

      <h3><a href="#URL_NEWSLETTER{infolettre}">

      Mais ça provoque un 404.

      Je ne sais pas comment je pourrais appeler ces newsletters de façon à les afficher avec mon squelette et une url bien réécrites, ou comment les réécrire via le .htaccess ?

      Est-ce que quelqu’un pourrait m’aider ?
      Bon dimanche :)

    Répondre à ce message

  • 2
    spipfactory

    pour info
    lors de la création d’une info lettre avec les nouvauté, j’ai l’erreur suivante

    Erreur d’exécution ../sites/URL/squelettes/newsletters/nouveautes.html | File […]/ecrire/inc/filtres.php Line 4877 : Argument 1 passed to generer_objet_introduction() must be of the type int, null given, called in /home/clients/b313813ae3dfa81e21eb5a95d7ad323f/sites/URL/tmp/cache/skel/html_d9e5307fe3065b8d01078cb353cb6bd3.php on line 335

    du coup l’infolettre arrive bien dans la boite mail , mais on a

    Erreur d’exécution ../sites/URL/squelettes/newsletters/nouveautes.html

    le site est en mutualisation sur l’hébergeur infomaniak avec la version spip SPIP 4.1.0

    • Bonjour,
      même constatation sur mon site après passage à SPIP 4.1
      Hébergé chez O2SWITCH avec PHP 8.0.17.
      C’était ok avec SPIP 4.0.5

    • Bonjour.
      Même chose pour moi, également après passage à Spip 4.1.5
      Hébergement Yulpa avec php 8.0.11
      Et même problème sur le site en local (Mageia 8 et php 8.0.25).
      Avez-vous trouvé d’où venait le problème ?
      Merci.
      PS. On en parle ici :
      https://git.spip.net/spip-contrib-e...

    Répondre à ce message

  • Bonjour.
    Je fais des essais pour une notification des nouveaux articles d’un site sous Spip.
    J’ai modifié le gabarit Nouveautés pour qu’on ait seulement les liens vers les articles.
    Cela marche pour l’envoi test, mais ne semble pas prendre en compte les articles à accès restreint. C’est pourtant ce qui m’intéresse : prévenir les membres de mon association y compris dans la partie privée à laquelle ils ont accès par Login/Mot de passe. Comme je n’ai mis que les liens et pas les contenus des articles dans mon gabarit, les utilisateurs devraient se connecter pour accéder au contenu.
    Cordialement.

    Répondre à ce message

  • 3

    Bonjour,
    Petite question concernant les newsletters programmés.
    Je programme des newsletters et souhaite restreindre le contenu généré en lien avec une rubrique sélectionnée via la « sélection éditoriale »,
    Malheureusement, il ne semble pas que la table spip_newsletter_liens soit mise à jour lors d’une création de newsletter programmé. Autant dire que le principe de sélection éditoriale est ignoré...

    De plus, je ne vois pas dans la bdd qu’il y est de lien (un ID en commun par exemple) entre une newsletter (source de la programmation) et celles qui sont générés à partir de cette première.

    J’espère que être suffisamment clair.
    Merci,
    JuL

    • Bonjour,
      J’ai le même problème que vous avec les lettres programmées.
      Avez-vous trouvé une solution ou un biais ?
      Merci
      JD

    • Bonjour,

      Je n’arrive pas à recevoir les newsletters programmées alors qu’en manuel pas de souci.
      Voici mon instalation :
      Spip 4.0.7
      Newsletters 2.0.4
      Base SQlite

      Une idée ?

      Merci d’avance

    • Bonjour à tous,
      @Jesuisdesordonne :
      Je n’ai pas trouvé de solution malheureusement, lors de la génération d’une newsletter automatique, je constate toujours qu’on ne retrouve pas toutes les infos de la newsletter programmé et que passer par Champs Extra n’aide en rien. Les champs extras sont également ignorés...

      Je vais créer des modèles pour chaque rubriques concernées, c’est pas top mais bon, on fait comme on peut...
      Je vais ouvrir un ticket.

    Répondre à ce message

  • itrytouninstall

    Bonjour à tous et à toutes,
    j’essaie de désinstaller mon plugin Newsletters et de le réinstaller afin que les tables se mettent à jour proprement après une mise à jour d’un gabarit où je rajoute une partie.
    Seulement, j’obtiens l’erreur suivante quand j’essaie la suppression via le back-office après la désactivation.
    Voici l’erreur exact :
    Les fichiers du plugin « Newsletters » (version : 1.6.4) n’ont pu être correctement effacés (cf Photos).
    La manipulation fonctionnait en local mais pas sur mon environnement de test.
    Si quelqu’un a une astuce je suis preneur,
    Cordialement,

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom