SPIP-Listes, documentation technique (II)

© Christian PAULUS. Document créé le 20 octobre 2007 , mis à jour le 12 novembre 2008.

Un idiot pauvre est un idiot, un idiot riche est un riche. Paul Laffitte

Accueil du site > Outils > SPIP-Listes, documentation technique (II)

Plugin / SPIP 1.9.2c 1.9.3

Présentation technique du fonctionnement du plugin SPIP-Listes_193 pour SPIP 1.9.3.

Ce document est consacré à SPIP-Listes_193. Il décrit au mieux ses nouvelles fonctionnalités.

SPIP-Listes-V est une variante de SPIP-Listes_192, une première approche qui m’a permis de mieux découvrir les fonctionnalités de SPIP, son code, quelques petites astuces, la création d’un plugin, et tout un tas de petites choses qui font de ce métier un certain jardin d’Eden où la monotonie n’a pas sa place. Reprendre un développement en cours, en respectant son historique sans le connaître, ses fonctionnalités peu documentées, deviner les traces des différents participants par le style d’écriture est un exercice délicat, parfois fastidieux, mais qui ne manque vraiment pas d’intérêts.

SPIP-Listes_193, dans sa révision 16157, se voit maintenant proposer les fonctionnalités de SPIP-Listes-V et d’autres nouvelles options rajoutées dans la foulée.

Précisions à ce jour (20/10/2007) :
- La version 1.9.3 de SPIP (SPIP_193) est en cours de développement ;
- SPIP-Listes 193 est sur la branche de test de la zone. Mais SPIP_193 n’étant pas encore dans la branche stable , il serait présomptueux de placer SPIP-Listes_193 dans cette dernière ;
- Toutefois, cette version de SPIP-Listes_193 a été développée sous SPIP_192c. Les tests de validation semblent démontrer son bon fonctionnement, aussi bien sous SPIP_192c (qui est en version stable ) que sous SPIP-Listes_193 ( dev ). Si vous êtes courageux, testez à votre tour SPIP-Listes_193 et reportez les éventuels problèmes rencontrés.

Patrons, listes, abonnés et courriers

Les quatre principaux composants de SPIP-Listes_193 sont les patrons qui servent à la construction de contenu, les listes à qui on attache les patrons et les abonnés, les courriers a qui on inclut le résultat d’un patron (option) et que l’on attache à une liste.

Un patron est un squelette ‘à-la-SPIP’, c’est-à-dire un pseudo page HTML dont le contenu est traduit et recomposé par SPIP. Dans SPIP-Listes_193, vous avez la possibilité de créer vos propres squelettes et de les rajouter aux patrons. Il suffit de recopier votre squelette dans le dossier ‘ patrons ’ pour le voir apparaître dans la liste des patrons proposés.

Voici l’arborescence du dossier des patrons sur votre PC :

PNG

Dans ce dossier ‘ patrons ’, en plus des patrons de contenus, les fichiers portant l’extension ‘.html’, vous apercevez trois autres dossiers :
- lien_en_tete_courriers qui contient le patron du lien de tête de page (en général : « si vous n’arrivez pas à lire ce courrier, consultez-le sur http://votre-serveur/page-du-courrier »). Cet en-tête est rajouté automatiquement à l’envoi du courrier ;
- pieds_courriers qui contient le patron du pied de page, ajoutés à votre courrier lors de l’envoi ;
- tampons_courriers, qui contient les tampons, ajoutés à votre courrier lors de l’envoi.

Ne renommez pas ces dossiers. Rien ne vous empêche par contre d’y rajouter vos patrons.

L’en-tête de courrier

Sa présence est optionnelle. Pour incorporer automatiquement l’en-tête de courrier à tous vos courriers, cochez la case correspondante dans la page de configuration de SPIP-Listes_193. A noter : seuls les administrateurs principaux, en charge de toutes les rubriques, ont accès à cette page de configuration.

PNG

Vous pouvez choisir dans cette boîte quel patron incorporer à vos envois.

Le pied de courrier

Sa présence est optionnelle. A contrario de l’en-tête et du tampon, le pied de courrier est sélectionné par le créateur de la liste de diffusion. Il peut donc être uniquement incorporé à une liste, lors de sa création ou de sa modification. Attention à ne pas incorporer ici un pied de courrier composé de boucles SPIP. En effet, le pied de courrier est directement calculé et incorporé à la liste lors de sa création ou de sa modification et non pas lors de son envoi. Si vous voulez utiliser un patron contenant des boucles SPIP du style « mes derniers articles », ajoutez ces boucles à votre patron principal, celui qui se trouve dans le dossier ‘patrons’.

Pour ajouter ou modifier un patron de pied, il faut que la liste soit créée. Sélectionnez-la dans la liste des listes pour faire apparaître la page de gestion de votre liste. Dans la boîte des patrons de pied, dépliez la boîte en cliquant sur le petit triangle et sélectionnez celui qui vous convient puis validez. Si vous ne voyez pas ce petit triangle, c’est que vous n’avez pas les droits nécessaires à la modification de cette liste.

PNG

Le tampon de courrier

Sa présence est optionnelle. Pour incorporer automatiquement le tampon de courrier à tous vos courriers, cochez la case correspondante dans la page de configuration de SPIP-Listes_193. A noter : seuls les administrateurs principaux, en charge de toutes les rubriques, ont accès à cette page de configuration.

PNG

Vous pouvez choisir dans cette boîte quel patron incorporer à vos envois. Vous pouvez également compléter les informations demandées, elles apparaîtront dans ce tampon de courrier lors de l’expédition. Attention toutefois, les patrons présents dans ce dossier ‘tampons_courriers’ ne proposent pas tous l’utilisation de ces éléments.

La liste des courriers

La liste des courriers triés par statut vous propose maintenant un état plus détaillé. Vous pouvez contrôler ici les courriers non envoyés, soit parce que le contenu est vide (cas d’un patron « derniers articles » qui n’a pas d’articles à proposer), soit parce que la liste n’a plus d’abonnés, ou que cette liste n’existe plus.

La liste des listes de diffusion

La liste des listes de diffusion présente maintenant les détails nécessaires qui vous permettront de contrôler rapidement la présence du patron indispensable à la génération du courrier, la date de prochain envoi, son statut (liste intemporelle, mensuelle, avec période).

Programmer l’envoi d’une liste de diffusion

SPIP-Listes_193 propose :
- D’envoyer la liste immédiatement ;
- D’envoyer la liste à partir d’une certaine date. Si vous choisissez une date antérieure à la date actuelle, cela sera compris pour un ‘envoyer maintenant’ ;
- D’envoyer la liste au début de chaque mois ;
- De rajouter un abonné à la liste ;
- De forcer les abonnements globalement pour cette liste (possibilité offerte aux administrateurs toutes rubriques uniquement).

La documentation contextuelle illustre la marche à suivre.

Suspendre les envois

La page de configuration vous permet de suspendre la trieuse (qui se charge de créer le courrier à partir des listes, lorsque nécessaire) et la mèleuse (qui se charge d’envoyer les courriers).

Cette option vous permet de corriger une erreur d’envoi, ou de simplement tester le bon fonctionnement de SPIP-Listes_193.

Importer/exporter

SPIP-Listes_193 propose l’importation et l’exportation des abonnés. Le créateur/modérateur de la liste voit apparaître la liste de ses listes de diffusion. L’administrateur ‘toutes rubriques’ a accès à l’ensemble des listes. Les champs pris en compte sont l’adresse email, le nom de l’abonné et son login, avec la possibilité de récupérer la liste des abonnés issue de SPIP-Listes_192.

Page de maintenance

SPIP-Listes_193 propose une page de maintenance des tables SPIP-Listes. Vous pouvez ici supprimer en quelques clics une ou plusieurs listes, les courriers en erreur, les courriers en cours d’envoi, remettre les chronos à zéro (supprimer tous les paramétrages d’envoi des listes, sans supprimer les listes), etc. A noter : seuls les administrateurs principaux, en charge de toutes les rubriques, ont accès à cette page de maintenance.

Où trouver SPIP-Listes_193 ?

- Sur la zone

Plussoyez !

Les forums sont fermés.

  • SPIP-Listes, documentation technique (II) 25 juin 2008 07:38, par xavier

    Bonjour,

    Je viens d’installer spip-liste 1.9.3. sur un squelette erasme avec un spip 1.9.2d

    Tout semble fonctionner, aucune erreur...mais aucun courrier ni message n’est envoyé ???

    J’avais avant, testé spip-liste 1.9.2 : même résultat

    En revanche avec spip-liste v, j’arrive à envoyer mais j’ai des erreurs dans le code (impossible de rédiger un courrier à partir d’un patron par exemple).

    Bref, n’ayant pas de compétence technique, je me tourne vers vous pour m’éclairer si cela est possible.

    Les forums sont fermés.

    • SPIP-Listes, documentation technique (II) 25 juin 2008 08:49, par Christian PAULUS
      Et que dit le log (/tmp/spiplistes_log) ?

      Les forums sont fermés.

    • SPIP-Listes, documentation technique (II) 25 juin 2008 12:51, par Christian PAULUS

      J’ai retiré log trop long de ton post. Reprenons juste la ligne qui va bien :

      > Jun 24 21:30:31 83.192.221.114 (pid 3572) MEL : envoi OK. Supprimer queue 16185
      > Jun 24 21:30:31 83.192.221.114 (pid 3572) MEL : id_courrier #10 TO id_liste #1 (2 users) REPLY-TO : xavierp@epplug.org (HTML : 0) (TEXT : 0) (NONE : 2) END

      Là, ca veut dire que le courrier id_courrier #10 a été préparé pour 2 abonnés, mais 0 envoyé en HML, et 0 en TEXTE. 2 en NONE, ce qui veut dire que les deux abonnés n’ont pas de format de réception. Il faut leur en attribuer un.

      Voir le bouton "Suivi des abonnements" pour afficher la liste des comptes et attribuer le format de réception.

      Les forums sont fermés.

      • SPIP-Listes, documentation technique (II) 25 juin 2008 13:32, par xavier

        "chapeau bas" Christian pour la réactivité !

        Je viens d’effectuer cette manip, mais elle n’est pas retenue, je viens de regarder de nouveau le spiplistes.log est on obtient :

        "Jun 25 13:19:57 83.192.221.114 (pid 30423) MEL : id_courrier #11 TO id_liste #1 (2 users) REPLY-TO : xavierp@epplug.org (HTML : 0) (TEXT : 0) (NONE : 2) END #11"

        hors j’ai sélectionné pour les deux abos l’un texte, l’autre html : c’est grave docteur ?

        Du coup j’ai remarqué également autre chose...

        Dans "Suivi des abonnements", en cliquant sur "qt." pour avoir le tri j’ai une page en erreur 404

        "Not Found
        The requested URL /ecrire/spiplistes_abonnes_tous was not found on this server."

        et, en effet, point de page spiplistes_abonnes_tous dans écrire...

        D’autre part, si je regarde le tableau dans "Suivi des abonnements", les deux abonnés ont bien un format d’envoi mais, si je regarde via la rubrique "auteur" de spip, rien n’est retenu ????

        Suis-je clair ?

        Les forums sont fermés.

        • SPIP-Listes, documentation technique (II) 25 juin 2008 14:53, par Christian PAULUS

          NONE:2 veut bien dire qu’il n’a pas de format. La page de la liste : "/ecrire/ ?exec=spiplistes_liste_gerer&id_liste=2" pour la liste #2 par exemple. Sous la boite d’édition, il y a la boite "Les abonnés à cette liste" qui permet de mieux vérifier les abonnés et leur format respectif.

          Je viens de corriger pour le lien sur la colonne de tête
          (tri). Merci d’avoir signalé le bug. Je finaliserai ça ce w-end.

          Les forums sont fermés.

          • SPIP-Listes, documentation technique (II) 25 juin 2008 16:09, par xavier

            OK merci.

            Je ne comprends vraiment pas, j’ai beau sélectionner un format d’envoir, ça ne fonctionne pas. J’obtiens toujours l’info qui m’indique que le format n’est pas connu...étrange...

            Les forums sont fermés.

            • SPIP-Listes, documentation technique (II) 28 juin 2008 12:27, par xavier

              bon ras depuis mercredi, j’installe, je désistalle, je regarde le spiplistes.log et toujours le même message.

              les courriers et les listes ne sont pas envoyés même si dans l’onglet abonnés, il y a un format d’indiqué dans le tableau.

              je ne sais pas pourquoi le système refuse de retenir le format d’envoi...

              Les forums sont fermés.

  • SPIP-Listes, documentation technique (II) 21 octobre 2008 11:17, par vincent MOUSSARIE
    Bonjour,
    étant l’administrateur principal de mon site spip ,je n’ai pas accès a la page de maintenance.Pouvez vous m’aider ?
    Merci d’avance.

    Les forums sont fermés.

    • SPIP-Listes, documentation technique (II) 21 octobre 2008 19:31, par Christian PAULUS

      Svp, préciser la version (bas de la page en espace privé) aussi bien de SPIP-listes que de SPIP.

      Il y a eu ce problème en effet dans une version (précédente ?).

      Merci.

      Les forums sont fermés.

  • SPIP-Listes, documentation technique (II) 5 novembre 2008 18:58, par Marcel BOLLA

    Bonsoir,
    J’ai installé SPIP-Liste 193 sur SPIP 192e (SPIP-Listes 1.9991-23253 <1.98> et SPIP 1.9.2e [12624]) et je rencontre les problèmes suivants :

    1 - Je n’ai pas accès à "Maintenance technique" en étant Administrateur principal de toutes les rubriques

    2 - Il est impossible d’ajouter des abonnés à une liste, si le nombre d’auteurs élligibles est supérieur à _SPIPLISTES_SELECT_MIN_AUTEURS soit 50 dans le cas présent ... l’affichage de la boite de recherche ne fonctionne pas. J’ai contourné en supprimant le test !!! pour le problème suivant.

    3 - Pour toutes mes listes, le nombre d’abonnés et toujours égal au nombre de désabonnés alors que je force l’envoi en html et que je teste l’envoi réel.

    J’espère que ces questions ne font pas doublon avec d’autres déjà posées.
    Je tiens à vous remercier pour cet excellent travail.
    Bien cordialement

    Les forums sont fermés.

  • SPIP-Listes, documentation technique (II) 5 janvier 2009 17:34, par pierre

    Bonjour et bravo pour les nets progrès que représente la version 25678 avec spip 2.0.2.

    Quelques retours :

    • j’ai constaté des petits soucis sur le html de formulaire_abonnement. J’ai commité la réparation en espérant ne pas avoir cassé autre chose (après coup je me suis dis que si tu voulais que la version soit aussi utilisable en 192 j’avais peut-être eu tord d’utiliser les filtres oui et non...)
    • Je n’ai toujours pas réussis à corriger le problème sur lien dans les lettre envoyé qui sont de la forme privé, ceux qui renvoient vers l’article complet ou la breve complète).
      Une idée ?
    • Je me suis lancé dans la personnalisation des formulaires j’ai vu que la chaîne "html_description" n’est pas utilisé partout c’est dommage mais peut-être prévu alors j’y vais de ma petite proposition de réécriture :
      , 'html_description' => "<span style=\"font-weight:normal;\"> (texte enrichi par des caract&egrave;res en gras ou en italique, parfois accompagn&eacute; d&#39;images)</span>"
    • Si ça peut-être utile de reclasser les chaînes de langues par ordre alphabétique je peux m’y coller si tu veux.
    • Un peu dans la même veine il y a les encodages de fichiers et les signe diachritique dans les commentaires...

    Les forums sont fermés.

    • SPIP-Listes, documentation technique (II) 6 janvier 2009 11:41, par Christian PAULUS

      Merci.

      Pour ce qui est des formulaires, je n’ai pas eu le temps de m’occuper de tous. Un coup de main sera toujours apprecié.

      Pour la correction du lien (prive/public), il y a plusieurs solutions. Je crois qu’on peut faire croire à recuperer_fond() qu’on est en réalité en espace public au moment de la compilation. Sinon, il y a la solution du filtre brutal. Je crois qu’un bout de code fait (faisait) ainsi.

      Sinon, pour les lang, je ne vois pas l’interet de trier. Il y en a tout un tas qui ne servent plus, et d’autres dont l’index n’a plus guere de relation avec sa valeur.

      Merci pour ton commit, et surtout d’avoir précisé qu’il faut vérifier en 192.

      Les forums sont fermés.

      • SPIP-Listes, documentation technique (II) 8 janvier 2009 10:56, par pierre
        Trier le fichier lang par ordre alphabétique permet de mieux s’y retrouver sans être obligé d’utiliser une fonction de recherche systématiquement.

        Les forums sont fermés.

  • SPIP-Listes, documentation technique (II) 5 janvier 2009 18:15, par pierre

    Dans patron nouveautès si j’écris l’url comme ça (ligne 59)

    <a href="[
    (#TEST|chaine_balise{article}|generer_url_public{id_article=#ID_ARTICLE})
    ]"><:spiplistes:article_entier:></a>

    où chaine_balise est une fonction :

    function chaine_balise($texte1, $texte2=''){
            return $texte1.$texte2;
    }

    alors les liens générer sont bien de nature public mais je suis certains qu’il y a mieux comme correction... :(

    Les forums sont fermés.

    • SPIP-Listes, documentation technique (II) 9 janvier 2009 08:43, par Christian PAULUS

      L’idée est bonne. Pour l’instant pas de meilleure, à part écrire un filtre qui corrige.

      Peut-être optimisé en

      [(#TEST|trim|generer_url_public{page=article&id_article=#ID_ARTICLE})]

      Les forums sont fermés.