Chapitre 6 — Installation du module

Trois méthodes d'installation sont possibles. Choisissez celle qui correspond à votre environnement de travail. Les trois aboutissent au même résultat.

Méthode 1 — Via l'interface Dolibarr (recommandée)

C'est la méthode la plus simple. Elle ne nécessite pas d'accès SSH et fonctionne dès lors que la constante MAIN_DISALLOW_INSTALL_EXTERNAL_MODULES n'est pas activée sur votre instance.

Procédure

1. Connectez-vous à Dolibarr en tant qu'administrateur.
2. Rendez-vous dans Accueil → Configuration → Modules.
3. Cliquez sur le bouton « Déployer / installer un module externe » en haut de la page.
4. Cliquez sur « Choisir un fichier » et sélectionnez l'archive module_infrasstudio-X.Y.Z.zip.
5. Cliquez sur « Envoyer le fichier ».
6. Patientez quelques secondes pendant la décompression de l'archive.
7. Un message confirme la réussite de l'installation et vous invite à activer le module.

Conseil — L'archive doit être nommée module_infrasstudio-X.Y.Z.zip, où X.Y.Z correspond au numéro de version. Ce nom est utilisé par Dolibarr pour identifier le module.

Méthode 2 — Manuelle (SSH ou FTP)

Cette méthode est adaptée si vous disposez d'un accès au serveur ou si vous travaillez dans un environnement local.

Procédure

1. Décompressez l'archive module_infrasstudio-X.Y.Z.zip sur votre poste de travail.
2. Vous obtenez un dossier nommé infrasstudio/.
3. Copiez ce dossier dans <votre_dolibarr>/htdocs/custom/ sur votre serveur, par SCP ou FTP.
4. Vérifiez les permissions : le dossier doit être accessible en lecture par l'utilisateur sous lequel tourne PHP, généralement www-data.

# Exemple complet en SSH
cd /var/www/dolibarr/htdocs/custom/
unzip /tmp/module_infrasstudio-1.9.0.zip
chown -R www-data:www-data infrasstudio/

Méthode 3 — Via Git (pour les développeurs)

Cette méthode est appropriée si vous souhaitez suivre les évolutions du module au fil des versions.

cd /var/www/dolibarr/htdocs/custom/
git clone https://github.com/infras/infrasstudio.git
cd infrasstudio
git checkout v1.9.0   # ou la version souhaitée

Avertissement — En production, ne pointez jamais sur la branche main. Utilisez toujours un tag de version stable.

Activer le module dans Dolibarr

Une fois le dossier en place, l'activation s'effectue depuis l'interface :

1. Rendez-vous dans Accueil → Configuration → Modules.
2. Recherchez « InfraSStudio » dans le filtre.
   • La carte du module apparaît : « InfraSStudio — surcouche d'édition Website ».
3. Cliquez sur l'interrupteur d'activation à droite de la carte.
4. Patientez. Dolibarr exécute alors plusieurs opérations en tâche de fond :
   • création des cinq tables SQL,
   • enregistrement des sept permissions,
   • installation des hooks (main, login, websitepage, websitenav),
   • déclaration des tâches planifiées,
   • restauration des constantes éventuellement sauvegardées lors d'une désactivation antérieure.
   • L'interrupteur passe au vert : le module est activé.

Vérification rapide — Survolez le menu Outils en haut de Dolibarr. Une nouvelle entrée doit apparaître : InfraS → InfraSStudio.

En cas d'échec de l'activation

Voici les erreurs les plus fréquentes et leurs solutions :

Vérification après installation

Le module est correctement installé si :

• L'entrée InfraS → InfraSStudio apparaît dans le menu Outils.
• La carte du module dans Configuration → Modules est verte.
• Aucune erreur n'est consignée dans htdocs/documents/dolibarr.log.
• La page Configuration → InfraSStudio → Diagnostic est accessible.

Au chapitre suivant, vous configurerez votre premier site géré par le module.