[*La version classique*]
Examinons donc les différentes modifs à apporter au fichier auteurs.php d’origine.
Changer l’ordre "par défaut" de tri des auteurs
Tout en haut du fichier, on trouve :
On va donc modifier $tri=’nom’ en $tri=’date’.
Implémenter un tri "par date de connexion
descendons vers la ligne 65, où l’on trouve :
Aux tris prévus, par nom, statut ou nombre d’articles, on va rajouter la possibilité d’un tri par date. Le _L nous permet de glisser un texte "en dur" qui s’affichera entre le petit bonhomme coloré et le nom des auteurs.
modifier l’affichage du tableau des auteurs
aux alentours de la ligne 133, on trouve :
La version d’origine prévoit donc par défaut de trier par nom (avec un lien cliquable pour y revenir si on a trié autrement). Nous allons maintenant rajouter la possibilité de trier par date en affichant un lien "Connexion".
implémenter le tri par date de connexion
à la ligne 252, on trouve :
Nous allons modifier le tri par défaut en plaçant le critère "default" au niveau d’un nouveau switch ’date’. Ce faisant, nous allons insérer l’ordre sql de trier la table sur le champ "en_ligne’.
Coder la requête de tri
à la ligne 270, on trouve la "très sympa" petite requête d’origine...
Nous allons donc nous atteler à la modification de la bête...
en rajoutant ’aut.en_ligne AS en_ligne,’ au début
Permettre un affichage compréhensible de la date
juste en dessous de la "petite requête sympa"...
On récupère les morceaux à grand coups de ’substr’ ; pour le détail de cette fonction, vous pouvez jeter un oeil ici...
gérer l’affichage final
à la ligne 343 on trouve :
sous lequel on va rajouter
de quoi obtenir l’affichage tant désiré...
[*La mise en Plugin*]
Considérations de départ
Bidouiller un fichier de ecrire/exec, comme nous venons de le faire ci-dessus, c’est bien. Le problème, c’est qu’en cas de mise à jour de la distrib spip, il faut se souvenir du (ou des) fichiers qu’on a modifié pour ne pas les écraser. La mise en "plugin" permet tout d’abord d’éviter ce genre problème. _ En outre, les plugins peuvent être à volonté activés / désactivés, ce qui évite bien des manip fastidieuses.
Alors... on y retourne !
Récupérer un modèle
Pour commencer, nous allons récupérer un modèle de plugin sur svn ://zone.spip.org/spip-zone/ (le "plugin_template"). C’est en éditant son contenu et en virant ce qui ne nous est pas utile qu’on va créer notre plugin connexion.
Editer plugin.xml
Ce fichier est fourni avec des indications assez claires sur sa structure. Pour l’essentiel, il suffit donc de mettre le nom du plugin, celui de l’auteur, la version et la description dans les balises du même nom.
Les éléments plus "sensibles" sont :
- la balise "options"
Le documentation indique que le fichier options (comme l’ancien mes_options.php) sera chargé a chaque hit. C’est donc bien à elle que nous devons nous atteler puisque, si nous voulons savoir qui s’est connecté récemment, il faut recalculer.
La balise "options" prendra donc la forme suivante :
Bien sûr, comme indiqué dans la doc, nous inventons pour ce fichier un nom unique (surtout pas mes_options.php). C’est dans ce fichier "connexions_options.php" que nous copierons tout simplement la totalité de notre fichier ecrire/exec/auteurs.php modifié (tout simplement). _
- La balise "fonctions" :
Comme nous n’en avons pas besoin, elle restera vide. _ - La balise "prefixe" :
Là encore la doc fournit des indications précises et claires : pas d’ambiguité dans le nom qui doit être unique et sera repris dans toutes nos fonctions. Ici on reste simple :
- La balise "pipeline" :
C’est le coeur du truc. C’est le pipeline, aussi appelé point d’entrée, qui nous permet d’altérer le fonctionnement standard de spip. La liste des pipelines déjà prévus dans spip peut être étudiée dans inc_version. Là, comme nous cherchons à altérer le fonctionnement d’un fichier de ecrire/exec en entier, nous allons retenir uniquement le pipeline "body_prive".
La doc indique que l’on peut se dispenser de "inclure". Nous allons néanmoins indiquer expressément le nom de ce fichier (et tout de suite après l’éditer).
Editer "template_pipelines_admin.php"
Avant d’aller plus loin, nous renommons ce fichier sous le nom que nous avons indiqué dans plugin.xml, c’est à dire "connexions_pipelines_admin.php".
En l’éditant, nous découvrons que plusieurs fonctions ont été prévues. La plupart ne nous servant à rien, nous les effaçons pour arriver au code suivant :
Editer "template_options.php"
Avant d’aller plus loin, nous renommons ce fichier sous le nom que nous avons indiqué dans plugin.xml, c’est à dire "connexions_options.php".
En l’éditant, nous découvrons... qu’il est vide !
Super !
On va y copier/coller la totalité du fichier ecrire/exec/auteurs.php que nous avons modifié selon nos besoins dans la première partie de cet article.
Et ensuite ?
et ensuite,... c’est fini (ou presque). Nous pouvons effacer les fichiers templates qui ne servent à rien dans notre cas (template_fonctions, template_pipelines_cron, template_pipelines_typo et template_pipelines_public).
Nous avons donc un plugin tout neuf composé de 4 fichiers :
- gpl_fr.txt : (pour la license)
- plugin.xml
- connexions_pipellines_admin.php
- connexions_options.php
Si ce n’est déjà fait, on crée un dossier "plugins" à la racine du spip. On y crée ensuite un sous-dossier "_connexions_" ou "connexions_auteurs" (ou ce que vous voulez, a priori ça n’est pas critique). On y glisse nos quatre fichiers.
Dans l’interface privée, les bouton "Configuration" fait alors apparaître un "Gestion des plugins" qui nous permet d’activer notre plugin. On s’en rend compte aussitôt en allant sur la page "Auteurs" dont le fonctionnement est désormais modifié tant que le plugin est activé.
RSS 2.0