Skip to main content

CHAPITRE 27 — Mise à jour du module

Les mises à jour du module s'effectuent sans interruption visible côté visiteurs. Ce chapitre présente la procédure standard et les précautions à observer.

Avant la mise à jour — liste de contrôle

Sur une instance de production, ne sautez jamais ces étapes :

  • Sauvegarde complète de la base Dolibarr (mysqldump).
  • Sauvegarde du dossier htdocs/custom/infrasstudio/ existant.
  • Sauvegarde des données : DOL_DATA_ROOT/<entity>/website/ et medias/.
  • Lecture du changelog de la nouvelle version pour repérer d'éventuelles modifications majeures.
  • Test de la mise à jour sur une instance de pré-production lorsque c'est possible.

Procédure standard

Étape 1 — Désactiver le module

Configuration → Modules → InfraSStudio → cliquer sur Désactiver.

Effet de la désactivation — Les constantes du module sont sauvegardées sous le préfixe INFRASSTUDIOBKP_. Les tables et leurs données restent intactes. L'entrée Outils → InfraS disparaît.

Étape 2 — Remplacer les fichiers

Trois méthodes selon votre environnement :

Via l'interface Dolibarr

  1. Configuration → Modules → bouton « Déployer / installer un module ».
  2. Sélectionner la nouvelle archive module_infrasstudio-X.Y.Z.zip.
  3. Confirmer le remplacement.

Via SSH ou FTP

cd /var/www/dolibarr/htdocs/custom/
mv infrasstudio infrasstudio.old.20260504
unzip /tmp/module_infrasstudio-1.9.0.zip
chown -R www-data:www-data infrasstudio/

Via Git

cd /var/www/dolibarr/htdocs/custom/infrasstudio
git fetch --tags
git checkout v1.9.0
Étape 3 — Réactiver le module
  1. Configuration → Modules → InfraSStudio → cliquer sur Activer.
  2. Le module exécute alors :
    • la restauration des constantes INFRASSTUDIOBKP_ vers INFRASSTUDIO_,
    • l'application des migrations SQL nécessaires (fichiers sql/update_X.Y.Z_*.sql),
    • le réenregistrement des hooks et triggers,
    • la mise à jour de la constante INFRASSTUDIO_MAIN_VERSION.
Étape 4 — Vérifier avec la page Diagnostic

Outils → InfraSStudio → Diagnostic. L'ensemble des contrôles doit être au vert. La section Schéma SQL confirme en particulier que toutes les tables sont à jour.

Étape 5 — Test fonctionnel

Reproduisez trois actions courantes :

  1. Ouvrir une page existante dans l'éditeur — l'aperçu doit se charger.
  2. Modifier un slot — l'enregistrement automatique doit fonctionner (indicateur « Enregistré »).
  3. Publier les modifications — vérifier que la version publique reflète bien la modification.

Lire le changelog avant chaque mise à jour

Le changelog est accessible :

  • Dans le module : htdocs/custom/infrasstudio/docs/changelog.xml.
  • Dans l'administration : Outils → InfraSStudio → onglet Changelog.
Lire les types de changement

Type

Signification

fix

Correction d'une anomalie.

chg

Modification d'un comportement existant.

add

Nouvelle fonctionnalité ou option.

Numérotation X.Y.Z

Composant

Cas de modification

X (majeur)

La version Dolibarr minimale prise en charge change.

Y (mineur)

Une nouvelle fonctionnalité ou option utilisateur est ajoutée.

Z (correctif)

Corrections et modifications internes uniquement.

Fréquence des mises à jour

Recommandations :

  • Correctif (Z) : à appliquer rapidement, surtout si l'anomalie corrigée vous concerne.
  • Mineur (Y) : à appliquer dans les une à deux semaines, après lecture du changelog.
  • Majeur (X) : à tester en pré-production, à planifier dans une fenêtre de maintenance, à communiquer à votre équipe.

Retour en arrière

Si une mise à jour pose problème :

  1. Désactivez le module.
  2. Restaurez le dossier infrasstudio.old.<date>/ sauvegardé à l'étape 2.
  3. Si une migration SQL a été appliquée, restaurez la base depuis le dump précédent.
  4. Réactivez le module.

Avertissement — Restauration SQL — Une migration ajoute parfois des colonnes ou des tables. Si vous restaurez le dump pré-migration sans restaurer également les fichiers, le module détectera des structures manquantes et s'interrompra. Synchronisez toujours fichiers et base de données ensemble.

Récapitulatif

Vous savez désormais :

  • Préparer une mise à jour avec une liste de contrôle (sauvegarde base, fichiers, données).
  • Suivre la procédure en cinq étapes (désactiver, remplacer, réactiver, diagnostic, test).
  • Lire le changelog et comprendre la numérotation X.Y.Z.
  • Appliquer la fréquence appropriée selon le type de version.
  • Revenir en arrière en cas d'incident.

Fin de la Partie V — Vous savez gérer le module en tant qu'administrateur : permissions, configuration avancée, résolution des incidents, mises à jour. Le module est désormais entre des mains compétentes.

La Partie VI propose la référence pure du module : tableaux exhaustifs des constantes, des shortcodes, des hooks, des tables SQL et des scripts en ligne de commande. À garder à portée pour une consultation rapide.

Back to top