Skip to main content

Mettre à jour le module

⬆️ Chapitre 27 — Mettre à jour le module

Les mises à jour InfraSStudio se font sans interruption visible côté visiteurs. Ce chapitre vous donne la procédure standard et les précautions à prendre.

📋 Avant la mise à jour — Checklist

⚠️ Sur une instance de production, ne jamais sauter 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 les breaking changes éventuels.
  • Test de la mise à jour sur une instance de pré-production si possible.

🔄 Procédure standard

Étape 1 — Désactiver le module

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

ℹ️ Effet de la désactivation — Les constantes du module sont sauvegardées en INFRASSTUDIOBKP_*. Les tables et leurs données restent intactes. Le menu Outils → InfraS disparaît.

Étape 2 — Remplacer les fichiers

Trois méthodes selon votre installation :

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 / 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 :
    • Restauration des constantes INFRASSTUDIOBKP_* → INFRASSTUDIO_*.
    • Application des migrations SQL nécessaires (fichiers sql/update_X.Y.Z_*.sql).
    • Réenregistrement des hooks et triggers.
    • Mise à jour de la constante INFRASSTUDIO_MAIN_VERSION.

Étape 4 — Vérifier avec la page Diagnostic

Outils → InfraSStudio → Diagnostic. Toutes les vérifications doivent être vertes. En particulier la section « Schéma SQL » qui confirme que toutes les tables sont à jour.

Étape 5 — Test fonctionnel

Reproduisez 3 actions typiques :

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

📜 Lire le changelog avant chaque mise à jour

Le changelog est accessible :

  • 📂 Dans le module : htdocs/custom/infrasstudio/docs/changelog.xml.
  • 🖥️ Dans l'admin : Outils → InfraSStudio → onglet Changelog.

Lire les types de changement

Type

Signification

🔴

fix

Correction de bug.

🔵

chg

Modification de comportement existant.

🟢

add

Nouvelle fonctionnalité ou option.

Numérotation X.Y.Z

Composant

Quand il change

X (majeur)

La version Dolibarr min supportée change.

Y (mineur)

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

Z (patch)

Corrections et modifications internes uniquement.

🔄 Mises à jour fréquence

Recommandation :

  • 🔴 Patch (Z) : appliquer rapidement, surtout si le bug fixé vous concerne.
  • 🔵 Mineur (Y) : appliquer dans les 1 à 2 semaines, après lecture du changelog.
  • 🟢 Majeur (X) : tester en pré-prod, planifier une fenêtre de maintenance, communiquer à votre équipe.

↩️ Retour en arrière

Si une mise à jour pose problème :

  1. Désactiver le module.
  2. Restaurer le dossier infrasstudio.old.<date>/ sauvegardé à l'étape 2.
  3. Si une migration SQL a été appliquée, restaurer la base depuis le dump pré-mise-à-jour.
  4. Réactiver le module.

⚠️ Restauration SQL — Une migration ajoute parfois des colonnes ou des tables. Si vous restaurez le dump pré-migration sans aussi restaurer les fichiers, le module verra des structures manquantes et plantera. Toujours synchroniser fichiers + base.

📋 Récapitulatif

✅ Vous savez maintenant :

  • Préparer une mise à jour avec checklist (sauvegarde base + fichiers + données).
  • Suivre la procédure en 5 étapes (désactiver → remplacer → réactiver → diagnostic → test).
  • Lire le changelog et la numérotation X.Y.Z.
  • Appliquer la bonne fréquence selon le type de version.
  • Faire un retour en arrière en cas de problème.

🎉 Fin de la Partie V — Vous savez gérer InfraSStudio comme administrateur : permissions, configuration, dépannage, mises à jour. Le module est entre de bonnes mains.

La Partie VI est la référence pure : tableaux exhaustifs des constantes, shortcodes, hooks, tables SQL et scripts CLI. À garder sous le coude pour consultation rapide.

Back to top