Skip to main content

Installation du module

📦 Chapitre 6 — Installation du module

Trois méthodes d'installation. Choisissez celle qui correspond à votre environnement. Toutes mènent au même résultat.

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

C'est la méthode la plus simple, accessible sans SSH. Elle requiert que la constante MAIN_DISALLOW_INSTALL_EXTERNAL_MODULES ne soit pas active.

Étapes

  1. Connectez-vous à Dolibarr en tant qu'administrateur.
  2. Allez 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 que Dolibarr décompresse l'archive.
  7. Vous voyez un message : « Module installé avec succès. Activez-le maintenant. »

💡 Astuce — L'archive ZIP doit être nommée module_infrasstudio-X.Y.Z.zip où X.Y.Z est la version. Le nom est utilisé par Dolibarr pour identifier le module.

🅱️ Méthode 2 — Manuelle (SSH / FTP)

Pratique si vous avez accès au serveur ou si vous travaillez en local.

Étapes

  1. Décompressez l'archive module_infrasstudio-X.Y.Z.zip sur votre poste.
  2. Vous obtenez un dossier infrasstudio/.
  3. Copiez ce dossier dans <votre_dolibarr>/htdocs/custom/ de votre serveur via SCP ou FTP.
  4. Vérifiez les permissions : le dossier doit être lisible par l'utilisateur 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 développeurs)

Idéale si vous suivez les évolutions du module au fil de l'eau.

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

⚠️ Attention — En production, ne pointez jamais sur main. Utilisez toujours un tag de version stable.

🔌 Activer le module dans Dolibarr

Une fois le dossier en place, l'activation se fait par l'interface :

  1. Allez dans Accueil → Configuration → Modules.
  2. Dans le filtre, cherchez « InfraSStudio ».
  3. Vous voyez une carte « InfraSStudio — surcouche d'édition Website ».
  4. Cliquez sur le bouton « Activer » (interrupteur à bascule à droite de la carte).
  5. Patientez. Dolibarr exécute :
    • la création des 5 tables SQL,
    • l'enregistrement des 7 permissions,
    • l'ajout des hooks (main, login, websitepage, websitenav),
    • la déclaration des cron jobs,
    • la restauration des constantes si vous avez désactivé/réactivé.
  6. Le bouton bascule en vert. Le module est activé.

✅ Vérification rapide — Survolez le menu Outils en haut de Dolibarr. Vous devez voir apparaître une nouvelle entrée InfraS → InfraSStudio.

🚨 Que faire si l'activation échoue

Quelques erreurs classiques et leur solution :

Message

Cause / solution

« Module Website non activé »

Activez d'abord

Website

dans Configuration → Modules, puis revenez activer InfraSStudio.

« Version Dolibarr incompatible »

Mettez Dolibarr à jour (≥ 18.0.0). En dernier recours, définissez la constante

INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN=1

.

« Erreur SQL CREATE TABLE »

L'utilisateur SQL n'a pas le droit

CREATE

. Donnez-le ou créez les tables manuellement via les fichiers

sql/llx_infrasstudio_*.sql

.

« Permission denied » (filesystem)

chown -R www-data:www-data htdocs/custom/infrasstudio/

côté serveur.

Page blanche après activation

Consultez

htdocs/documents/dolibarr.log

. C'est presque toujours une extension PHP manquante.

📋 Checklist post-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 en vert.
  • Aucune erreur dans htdocs/documents/dolibarr.log.
  • La page Configuration → InfraSStudio → Diagnostic est accessible (on y va au Chapitre 8).

Au prochain chapitre, on déclare le premier site managé.

Back to top