🔄

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 ensous le préfixe INFRASSTUDIOBKP_*INFRASSTUDIOBKP_. Les tables et leurs données restent intactes. Le menuL'entrée Outils → InfraS disparaît.

Étape 2 — Remplacer les fichiers

Trois méthodes selon votre installationenvironnement :

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 :
   • Restaurationla restauration des constantes INFRASSTUDIOBKP_*INFRASSTUDIOBKP_ →vers INFRASSTUDIO_*INFRASSTUDIO_.,
   • Applicationl'application des migrations SQL nécessaires (fichiers sql/update_X.Y.Z_*.sql).,
   • Réenregistrementle réenregistrement des hooks et triggers.triggers,
   • Misela mise à jour de la constante INFRASSTUDIO_MAIN_VERSION.

Étape 4 — Vérifier avec la page Diagnostic

Outils → InfraSStudio → Diagnostic.Diagnostic. ToutesL'ensemble lesdes vérificationscontrôles doiventdoit être vertes.au Envert. particulier laLa section « Schéma SQL »confirme quien confirmeparticulier que toutes les tables sont à jour.

Étape 5 — Test fonctionnel

Reproduisez 3trois actions typiquescourantes :

1. Ouvrir une page existante dans l'éditeur — l'aperçu doit se charger.
2. Modifier un slot — l'auto-saveenregistrement 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'adminadministration : Outils → InfraSStudio → onglet Changelog.Changelog.

Lire les types de changement

Numérotation X.Y.Z

Fréquence

🔄des Misesmises à jour fréquence

RecommandationRecommandations :

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

↩️

Retour en arrière

Si une mise à jour pose problème :

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

⚠️Avertissement — Restauration SQL — — Une migration ajoute parfois des colonnes ou des tables. Si vous restaurez le dump pré-migration sans aussirestaurer restaurerégalement les fichiers, le module verradétectera des structures manquantes et plantera.s'interrompra. ToujoursSynchronisez synchronisertoujours fichiers +et base.base de données ensemble.

📋

Récapitulatif

✅ Vous savez maintenantdésormais :

• Préparer une mise à jour avec checklistune liste de contrôle (sauvegarde basebase, + fichiers +fichiers, données).
• Suivre la procédure en 5cinq étapes (désactiverdésactiver, →remplacer, remplacerréactiver, → réactiver → diagnostic →diagnostic, test).
• Lire le changelog et comprendre la numérotation X.Y.Z.
• Appliquer la bonnefréquence fréquenceappropriée selon le type de version.
• Faire un retourRevenir en arrière en cas de problème.d'incident.

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

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