Mise à jour automatique des plugins

Présentation

Rendons à César ce qui est à César, voici un extrait de la présentation du Couteau Suisse pour sa lame « Mise à jour automatique » :

« Garde un oeil sur tous vos plugins. Cet outil vous permet de gérer facilement leurs mises à jour, récupérant notamment le numéro de révision contenu dans le fichier svn.revision et le comparant avec celui trouvé sur zone.spip.org. La liste proposée offre la possibilité de lancer le processus de mise à jour automatique de SPIP sur chacun des plugins préalablement installés dans le dossier plugins/auto/. »

Cette lame a été ajoutée au Couteau Suisse à partir de la révision 31378 (version 1.8.09.05) de ce dernier. Si vous n’avez pas cette lame dans votre Couteau Suisse, cela veut dire que votre version n’est pas à jour.

A partir de la version 1.8.32.00 du plugin et si vous avez le statut de webmestre, la version de SPIP lui-même est vérifiée. Comme il est toujours préférable de mettre à jour un code qui peut s’avérer défectueux ou présenter de graves failles de sécurité (par exemple : SPIP 2.1.8 corrige une importante faille de sécurité), n’hésitez pas ! Voici un exemple du message proposé :

Incompatibilité

Le Couteau-Suisse peut parfois (pour le moment) être incompatible avec certains plugins. Au mieux, certaines lames ne sont pas compatibles avec d’autres plugins. La lame « mise à jour automatique » n’est pas compatible avec le (ou les) plugins suivants (liste non exhaustive) :
-  SoyezCréateurs.

Précautions

Cet outil vous permet de gérer facilement la mise à jour de vos différents plugins, récupérant notamment le numéro de révision contenu dans le fichier svn.revision et le comparant avec celui trouvé sur zone.spip.org.

La liste offre la possibilité de lancer le processus de mise à jour automatique de SPIP sur chacun des plugins préalablement installés dans le dossier plugins/auto/. Les autres plugins se trouvant dans le dossier plugins/ sont simplement listés à titre d’information, aucun bouton radio n’apparaîtra de ce fait. Si la révision distante n’a pas pu être trouvée, alors tentez de procéder manuellement à la mise à jour du plugin.

Note : les paquets .zip n’étant pas reconstruits instantanément, il se peut que vous soyez obligé d’attendre un certain délai avant de pouvoir effectuer la totale mise à jour d’un plugin tout récemment modifié.

Activation

Pour activer cette lame, allez dans la page de configuration du Couteau Suisse en ayant cliquer sur « Configuration » de votre bandeau.

Cliquez sur « Administration » dans votre bloc « Outils inactifs » (En rouge) pour voir apparaître la liste des lames de cette catégorie où se trouve « Mise à jour automatique » :

Cliquez sur « Mise à jour automatique » pour voir son descriptif en bas de la page...

... et pouvoir l’activer :

Une fois cela fait, vous verrez apparaître la liste de vos plugins actifs (installés grâce au panneau de « Gestion des plugins ») dans un 1^er tableau et un 2^e tableau pour les plugins inactifs :

Explications

Cette liste se présente sous forme de tableau contenant 3 colonnes :

1. un bouton radio pour sélectionner un plugin à mettre éventuellement à jour
2. le nom du plugin, son numéro de version, et en gras soit « Ce plugin semble à jour. » soit « La révision XXXX est disponible » (XXXX est le numéro de révision du plugin)
3. Le numéro de révision de votre plugin actif sur votre site et la date de cette révision

Vous remarquerez que le bouton radio sélectionné correspond au premier plugin de votre liste ayant une mise à jour disponible. Dans l’exemple présent, nous voyons le plugin « Notifications » sélectionné

Revenons sur la colonne principale de ce tableau.
Lorsque votre plugin est à jour, vous voyez la phrase « Ce plugin semble à jour ». Dans cette simple phrase, vous avez 2 liens :

1. le premier sur « plugin » qui pointe vers l’archive (zip) de votre plugin ;
2. le deuxième sur « à jour », pointant vers le « changelog » de votre plugin vous permettant de voir les différentes révisions liées à ce plugin

Lorsque votre version de plugin n’est pas la plus récente, vous verrez une phrase du type « La révision XXXX est disponible ». Ici aussi, vous avez 2 liens :

1. Le numéro de révision pointe vers le « changelog » du plugin vous permettant de consulter la liste des révisions avant de mettre à jour (ou pas) votre plugin ;
2. « disponible » pointe vers l’archive zippée du plugin.

Mise à jour d’un plugin

Venons au plus intéressant. Repérez un de vos plugins ayant une révision disponible. Cliquez sur le bouton à gauche du nom du plugin (s’il est le premier plugin de la liste, il sera déjà sélectionné).
En bas du tableau, vous verrez le bouton « Mettre à jour le plugin sélectionné ». Cliquez-le.

Vous verrez une page similaire à celle-ci apparaître :

Cliquez sur « Suivant » en bas de page (hé oui, SPIP nous oblige ici à faire de la roulette de souris...). Puis une autre page vous invitant à « Continuez pour l’activer » en cliquant sur « Suivant » encore une fois. Faites-le.

Ces étapes terminées, vous êtes redirigé vers la page de la lame « Mise à jour automatique » du Couteau Suisse pour procéder à d’éventuelles nouvelles mises à jour.

Attention : la mise à jour d’un plugin est une opération délicate qui ne saurait être automatisée. L’œil du Webmestre est toujours requis en cas de besoin. Si une erreur survient, n’oubliez pas les bases de SPIP :

-  Vider le cache de SPIP
-  Supprimer les fichiers /tmp/charger_*.php
-  Supprimer le dossier /tmp/couteau-suisse

Informations techniques

Merci à Patrice Vanneufville pour les informations suivantes :

-  Le cache de la consultation des logs est créé pour 24h afin de ne pas surcharger le serveur de trac. Par exemple, pour trouver la version actuelle de CFG, le Couteau Suisse va consulter la page http://zone.spip.org/trac/spip-zone/log/_plugins_/cfg?format=changelog et repérer le premier chiffre de révision, puis le comparer à ce qu’il peut trouver dans le fichier svn.revision. La page de trac est ensuite mise en cache : tant que le fichier svn.revision n’a pas été modifié, tout ré-affichage de l’admin du Couteau Suisse ne provoquera pas d’accès distant pendant 24h, (ce qui accélère considérablement la rapidité d’affichage par rapport à la première fois).

-  pour court-circuiter le cache et refaire toutes les consultations sur trac, il suffit d’ajouter var_mode=calcul dans l’url. Par exemple : /ecrire/?exec=admin_couteau_suisse&cmd=descrip&outil=maj_auto&var_mode=calcul

-  le fait qu’un commit [1] (donc nouvelle version disponible immédiatement) n’est pas pris en compte tout de suite dans le paquet .zip est que le paquet doit être refait sur trac (il est refait, en temps normal, toutes les heures). Sans cela donc, la mise à jour du plugin ne pourra pas se faire.