SPIP-Listes-V, plugin SPIP de messagerie

© Christian PAULUS. Document créé le 17 août 2007 , mis à jour le 27 novembre 2007.

Il n'est point de secret que le temps ne révèle. Jean Racine

Accueil du site > Outils > SPIP-Listes-V, plugin SPIP de messagerie

Plugin / SPIP 1.9.2b

SPIP-Listes-V est un plugin SPIP pour la gestion de courriers (mailing-list, news-letters).

SPIP-Listes-V est une adaptation de SPIP-Listes de Vincent CARON.

Zip - 432.6 ko
SPIP-Listes-V 1.998(6)
Version stable

Avertissement

Le développement de SPIP-Listes-V a pris fin avec l’incorporation des ses principales fonctionnalités dans SPIP-Listes_193. Voir la page de la documentation fonctionnelle de SPIP-Listes_193 pour plus d’informations à ce propos.

De nombreux tests ont été réalisés sur deux sites en production. Mais le bug est souvent sournois.

N’installez pas SPIP-Listes-V en production sans l’avoir testé et validé correctement.

Cette distribution est par défaut en mode SIMULATION (la meleuse n’envoie pas le courrier, mais nous le fait croire.) Pour activer l’envoi du courrier, vous devez modifier ce mode dans la page de configuration (espace privé).

SPIP-Listes-V est diffusé gratuitement, sans aucune garantie de bon fonctionnement. Vous êtes seul responsable de l’installation et de la mise en œuvre de SPIP-Listes-V sur votre site.

Pourquoi SPIP-Listes-V ?

Quelques soucis rencontrés à l’utilisation du plugin SPIP-Listes sous SPIP-1.9.2b [9381] :
- Fonctions du plugin actif à l’installation, sans passer par la case config ;
- Courrier qui ne part pas, sans explication ;
- Le patron ne part pas dans le courrier à l’édition ;
- L’enrichissement graphique boite édition courrier ne fonctionne pas ;
- L’envoi des messages auto (planifié, programmé) ne passe pas ;
- Problèmes d’ergonomie dans l’espace privé (le courrier s’appelle parfois message, les boîtes d’édition ne sont pas dans le style de l’ensemble, etc.).

SPIP-Listes-V est-il compatible avec SPIP-Listes ?

A priori : oui. Mais SPIP-Listes-V est une variante de SPIP-Listes. Ne l’oubliez pas !

SPIP-Listes semble avoir connu de nombreuses versions. SPIP-Listes-V a été réalisé sur la base de SPIP-Listes_1_9_2 notée 1.9.7 dans le fichier plugin.xml de la distribution.

Les tables SQL de SPIP-Listes_1_9_2 sont respectées. Donc, sauf modification de dernière minute ou autre mise à jour, SPIP-Listes-V est compatible avec cette version de SPIP-Liste. Mais ceci reste à vérifier et valider sur votre environnement de test.

De plus, dans cette version de SPIP-Listes-V, les noms des scripts SPIP-Listes ont (presque) été conservés afin de pouvoir aisément comparer le code.

SPIP-Listes-V est-il pérenne ?

Probablement non. SPIP-Listes-V est une première étape, variation de SPIP-Listes.

Cette variante a été mise en œuvre à la demande d’associations amies qui désirent un outil de ce type pour leur site. Mais leurs demandes sont multiples. Elles seront traitées en priorité. L’évolution de SPIP-Listes-V est imprévisible.

Si vous désirez une fonctionnalité supplémentaire, proposez-la dans le forum (lien en bas de page). Ce n’est nullement un engagement, mais si votre souhait rejoint les besoins exprimés par ces associations, ces fonctionnalités seront ajoutées rapidement.

A savoir : SPIP-Listes-V donne - a priori - de bons résultats sous SPIP 1.92b. Le comportement de SPIP-Listes-V n’a pas été testé sous les versions antérieures de SPIP.

SPIP-Listes-V est-il fiable ?

N’installez pas SPIP-Listes-V en production sans l’avoir testé et validé correctement.

SPIP-Listes-V est diffusé gratuitement, sans aucune garantie de bon fonctionnement. Vous êtes seul responsable de l’installation et de la mise en œuvre de SPIP-Listes-V sur votre site.

Modifications apportées

A ce jour (voir en tête de page la date de modification de ce billet) :
- Possibilité vider les paniers (sauf publié, encour) ;
- Possibilité, grace au patron de tête, de renvoyer la lecture du courrier sur le site (du style : "si vous n’arrivez à lire ce courrier, cliquez ici pour y accéder sur le site") ;
- Certaines préférences sont sérialisées en meta ;
- Une liste peut être supprimée, modifiée ;
- Le mode simulation est maintenant configurable (menu configuration) ;
- En-tête et pied de courrier configurables (menu configuration) ;
- L’en-tête le pied de mails sont de patrons comme les autres pour les listes !
- Preview format texte seul ;
- Scripts install et upgrade corrigés ;
- Possibilité de forcer l’abonnement des invités à une liste publique ;
- Possibilité de forcer l’abonnement des inscrits sauf invités à une liste privée ;
- Ajout tête de courrier avec lien sur le site (pour les courriers présentant problèmes d’affichage) ;
- Une liste publique peut être diffusée mensuellement, le premier de chaque mois ;
- La liste des courriers affiche celle des courriers programmés (listes) ;
- Correction du charset avant envoi ;
- Optimisation de la vue liste des paniers ;
- L’autocron ne se lance qu’une fois par minute, afin d’éviter de surcharger le serveur ;
- L’autocron (boite info sur le suivi des envois) prend en compte les envois de test ;
- Ajout statut ’stop’ pour un courrier (spip_courriers) indique que le courrier en cours d’envoi a été arrêté.
- Ajout statut ’ignore’ pour un courrier (spip_courriers) indique que la liste de destination ne contient pas (plus) d’abonnés.
- Possibilité d’envoyer le test à une adresse mail non auteur ;
- Mode simulation pour les tests (config par défaut) ;
- Intégration de la page config sur bouton configuration ; PNG
- Intégration aide contextuelle ;
- Possibilité de mettre le bureau de poste au repos (attente des chronos) ;
- Ajout statut "vide" pour écarter les courriers dont le patron ne renvoie rien ;
- Tous les administrateurs ont droit à la gestion des listes de diffusion ;
- Une trieuse se charge de trier et classer les courriers des listes pour la meleuse ;
- Un patron peut être attaché à une liste ;
- Un patron peut être importé dans un courrier, indépendant du patron attaché à la liste. Vous pouvez ainsi avoir 2 patrons (qui ne rêve pas d’avoir deux patrons ;-)), le premier est statique lors de l’import, le second - celui attaché - est dynamique, calculé et construit lors de l’envoi ;
- Vous pouvez changer le patron jeune et dynamique - celui attaché à sa liste - en affichant la page de la liste concernée ;
- Optimisation code (conformité HTML/CSS) en cours ;
- Formulaire import/export revu et corrigé ;
- Aide en ligne (par le bouton Aide) ; PNG
- Le plugin n’est plus activé automatiquement à l’installation. Il faut passer par config et valider l’installation ;
- Quelques variables dans le code ne semblaient plus (pas) servir et ont donc été supprimées ;
- Quelques nouvelles icônes pour l’espace privé ;
- Ajout de fonctionnalités (possibilité de forcer les abonnements à une liste, invités seuls ou tous les inscrits) ;
- Vérification et alerte sur erreur mail de test ;
- Possibilité abandon d’un chrono dans liste des courriers ;
- Correction ergonomie espace privé (similaire rubriques, articles, etc.) ;
- Nouvelle prévisualisation du patron ;
- Correction enrichissement graphique boite édition courrier ;
- Quelques corrections mineures.

A noter également : SPIP-Listes-V a été optimisé sous environnement Unix. Ainsi, spip_log() est remplacé par syslog_trace(). Vous pouvez réactiver spip_log() en modifiant une ligne dans le fichier spiplistes_mes_options.php

syslog_trace() permet de suivre les erreurs dans le fichier syslog Unix (tail –f /var/log/messages, par exemple). Bien plus pratique que le journal de SPIP (spip.log) qui est souvent tronqué. Suivre toutefois le journal SPIP MySQL (mysql.log) où sont reportées les erreurs MySQL.

syslog_trace() n’est actif que sur un réseau privé (plage IP 192.168.*.*). Si vous êtes sous Unix – dans cette plage privée – et que rien n’apparaît dans votre syslog, modifiez _SPIP_LISTE_SYSLOG_LAN_IP_ADDRESS dans spiplistes_mes_options.php.

Lorsque SPIP-Listes-V sera stable, la plupart des appels à syslog_trace() seront retirés des scripts.

Notes complémentaires

SPIP-Listes rajoute 6 tables à la base qui passe ainsi de 38 à 44 tables.

Description des tables rajoutées par SPIP-Listes :
- spip_courriers  : table des courriers ;
- spip_listes : table des listes d’envoi (nom de la liste, description) ;
- spip_auteurs_elargis : préférences de réception du courrier (html, texte ou non) dans spip_listes_format (qui est une clé, pas une table ?!) ;
- spip_auteurs_listes : id_auteur des abonnés, par liste ;
- spip_auteurs_mod_listes : modérateur de la liste. En réalité le créateur.
- spip_auteurs_courriers : etat de la queue du courrier.

Pour mémo, état des statuts d’article :
- redac : en cours de rédaction
- ready  : prêt à l’envoi
- en_cour  : en cours d’envoi
- publie  : publié

Cheminement d’un courrier :
- exec/courrier_edit propose la création d’un courrier. Il envoie le résultat à exec/gerer_courrier ;
- exec/gerer_courrier enregistre ce nouveau courrier dans la table spip_courriers avec comme statut ‘redac’ qui vous propose l’envoi à une adresse de test ou l’envoi à une liste ;
- Si l’envoi est validé pour un test ou une liste, le spip_courriers.statut du courrier devient "encour" ;
- pour un test, spip_courriers.total_abonne du courrier passe à "1" ;
- La meleuse repasse spip_courriers.statut du courrier de test en "redac" après son envoi ;
- Si le courrier est destiné à une liste, la meleuse passe spip_courriers.statut du courrier en "publie" après les envois ;
- Le cron SPIP appelle celui des listes au fil de l’eau, lorsqu’il a le temps. Le cron des listes vérifie les listes programmées en envoi auto et s’occupe de placer en file d’attente les courriers récents. Si la date est dépassée, le courrier est annulé ;
- La meleuse prend le relais (une suite du cron) et charge par paquets ses courriers pour la distribution.

A suivre (to-do liste) :
- Module de stats (peu de demandes, reporté !) ;
- Avoir la possibilité de changer le modérateur (peu de demandes, reporté !) ;
- Miniature patron pour import (reporté dans ce projet, sera probablement ajouté à la version officielle) ;
- Traduire les ajouts dans lang.fr ;
- Ne pas lâcher prise.

Si vous constatez une erreur dans ce billet, merci de le signaler dans le forum (bas de page).

En attendant vos remarques (toujours dans le forum).

N’installez pas SPIP-Listes-V en production sans l’avoir testé et validé correctement.

A noter:

A voir :
- L’espace consacré à SPIP-Listes sur bloog.net ;
- L’espace consacré à SPIP-Liste sur SPIP-contrib.net ;
- Première approche d’une documentation techique.

Plussoyez !

Les forums sont fermés.

  • SPIP-Listes-V, plugin SPIP de messagerie 28 août 2007 14:02, par BoOz

    Super boulot,

    Je me suis permis de recopier une partie de cette page dans la doc de spip listes.

    Maintenant que tu as bien le code en main, peut etre que ca serait interressant que tu rejoignes l’équipe de dev de spiplistes sur zone.spip.org.

    Nous allons attaquer la version pour spip 1.9.3, avec pas mal d’améliorations.

    Les forums sont fermés.

    • SPIP-Listes-V, plugin SPIP de messagerie 28 août 2007 15:20, par Christian PAULUS

      Merci pour les remarques.

      J’espère terminer la version test dans la soirée. J’irai faire un tour sur la zone dans la foulée.

      Les forums sont fermés.

      • SPIP-Listes-V, plugin SPIP de messagerie 30 septembre 2007 14:17, par Pinosa

        Bonjour,

        Je suis simple utilisateur de Spip (pas programeur) et j’aimerai installer Spip-Listes sur mon site (pour Spip 1.9.2).

        Ma question :
        Sous quelle appellation se feront les nouvelles versions ?
        - Des évolutions de Spip-listes-V sont elles en cours
        - ou bien est-ce spip-listes qui bénéficiera des évolutions prochaines.

        je vous remercie par avance de votre réponse.

        Les forums sont fermés.

        • SPIP-Listes-V, plugin SPIP de messagerie 30 septembre 2007 15:54, par Christian PAULUS

          SPIP-Listes-V (SLV) a été réalisé dans l’urgence suite à quelques demandes d’associations. Il n’y aura probablement pas de suite à cette version, qui disparaîtra lorsque j’en aurai terminé avec la version 193 de SPIP-Listes (je participe activement à la version 193 depuis quelques semaines).

          Si vous êtes pressé, et que SLV donne de bons résultats sur votre site, vous pouvez l’utiliser maintenant. La version 193 de SL est encore en test, et certaines fonctionnalités de SLV n’y sont pas encore implémentées (abonnement mensuel, principalement). Mais ça ne saurait trop tarder.

          Si vous n’êtes pas pressé, attendez la version stable 193 de SL qui demande encore quelques jours ou semaines de tests et de validation.

          Les forums sont fermés.