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//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 Configuration → Modules → bouton « Déployer / installer un module » . Sélectionner la nouvelle archive module_infrasstudio-X.Y.Z.zip . 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 Configuration → Modules → InfraSStudio → cliquer sur Activer . 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 : Ouvrir une page existante dans l'éditeur — l'aperçu doit se charger. Modifier un slot — l'enregistrement automatique doit fonctionner (indicateur « Enregistré »). 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 : Désactivez le module. Restaurez le dossier infrasstudio.old./ sauvegardé à l'étape 2. Si une migration SQL a été appliquée, restaurez la base depuis le dump précédent. 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.