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 

 Connectez-vous à Dolibarr en tant qu'administrateur. Rendez-vous dans Accueil → Configuration → Modules. Cliquez sur le bouton « Déployer / installer un module externe » en haut de la page. Cliquez sur « Choisir un fichier » et sélectionnez l'archive module_infrasstudio-X.Y.Z.zip . Cliquez sur « Envoyer le fichier » . Patientez quelques secondes pendant la décompression de l'archive. 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 

 Décompressez l'archive module_infrasstudio-X.Y.Z.zip sur votre poste de travail. Vous obtenez un dossier nommé infrasstudio/ . Copiez ce dossier dans <votre_dolibarr>/htdocs/custom/ sur votre serveur, par SCP ou FTP. 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 : 

 Rendez-vous dans Accueil → Configuration → Modules. Recherchez « InfraSStudio » dans le filtre. La carte du module apparaît : « InfraSStudio — surcouche d'édition Website ». Cliquez sur l'interrupteur d'activation à droite de la carte. 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 : 

 Message d'erreur Cause et solution « Module Website non activé » Activez le module Website dans Configuration → Modules, puis revenez activer InfraSStudio. « Version Dolibarr incompatible » Mettez Dolibarr à jour vers une version supportée. En dernier recours, définissez la constante INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN=1 . « Erreur SQL CREATE TABLE » L'utilisateur SQL ne dispose pas du droit CREATE . Accordez-le, ou créez les tables manuellement à partir des fichiers sql/llx_infrasstudio_*.sql . « Permission denied » sur le système de fichiers Exécutez chown -R www-data:www-data htdocs/custom/infrasstudio/ côté serveur. Page blanche après activation Consultez le fichier htdocs/documents/dolibarr.log . La cause est presque toujours une extension PHP manquante. 

 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.