Skip to main content

Chapitre 6 — Installation du module

📦 Chapitre 6 — Installation du module

Trois méthodes d'installation.installation sont possibles. Choisissez celle qui correspond à votre environnement.environnement Toutesde mènenttravail. 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, accessible sans SSH.simple. Elle requiertne nécessite pas d'accès SSH et fonctionne dès lors que la constante MAIN_DISALLOW_INSTALL_EXTERNAL_MODULES ne soitn'est pas active.activée sur votre instance.

Étapes

Procédure

  1. Connectez-vous à Dolibarr en tant qu'administrateur.administrateur.
  2. AllezRendez-vous dans Accueil → Configuration → Modules.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 quela Dolibarrdécompression décompressede l'archive.
  7. Vous voyez unUn message :confirme «la Moduleréussite installéde avecl'installation succès.et Activez-vous invite à activer le maintenant. »module.

💡Conseil Astuce— — L'archive ZIP doit être nommée module_infrasstudio-X.Y.Z.zip, où X.Y.Z estcorrespond laau numéro de version. LeCe nom est utilisé par Dolibarr pour identifier le module.

🅱️

Méthode 2 — Manuelle (SSH /ou FTP)

PratiqueCette méthode est adaptée si vous avezdisposez d'un accès au serveur ou si vous travaillez endans un environnement local.

Étapes

Procédure

  1. Décompressez l'archive module_infrasstudio-X.Y.Z.zip sur votre poste.poste de travail.
  2. Vous obtenez un dossier nommé infrasstudio/.
  3. Copiez ce dossier dans <votre_dolibarr>/htdocs/custom/ desur votre serveurserveur, viapar SCP ou FTP.
  4. Vérifiez les permissions : le dossier doit être lisibleaccessible en lecture par l'utilisateur PHPsous (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)

IdéaleCette méthode est appropriée si vous suivezsouhaitez suivre les évolutions du module au fil dedes l'eau.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 Attention— — 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 ses'effectue fait pardepuis l'interface :

  1. AllezRendez-vous dans Accueil → Configuration → Modules.Modules.
  2. DansRecherchez « InfraSStudio » dans le filtre, cherchez « InfraSStudio ».filtre.
  3. Vous voyez uneLa carte du module apparaît : « InfraSStudio — surcouche d'édition Website ».
  4. Cliquez sur le bouton « Activer » (l'interrupteur à basculed'activation à droite de la carte).carte.
  5. Patientez. Dolibarr exécute alors plusieurs opérations :
    • la création des 5cinq tables SQL,
    • l'enregistrement des 7sept permissions,
    • l'ajoutinstallation des hooks (main, login, websitepage, websitenav),
    • la déclaration des crontâches jobs,planifiées,
    • la restauration des constantes siéventuellement voussauvegardées avezlors désactivé/réactivé.d'une désactivation antérieure.
  6. LeL'interrupteur boutonpasse basculeau envert vert.: Lele module est activé.

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

En

🚨cas Qued'échec faire side l'activation échoue

QuelquesVoici les erreurs classiquesles plus fréquentes et leurleurs solutionsolutions :

Message d'erreur

Cause /et solution

« Module Website non activé »

Activez d'abordle

module Website

dans Configuration → Modules, puis revenez activer InfraSStudio.

« Version Dolibarr incompatible »

Mettez Dolibarr à jour (≥vers 18.0.0).une version supportée. En dernier recours, définissez la constante

INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN=1

.

« Erreur SQL CREATE TABLE »

L'utilisateur SQL n'ane dispose pas ledu droit

CREATE

. Donnez-leAccordez-le, ou créez les tables manuellement viaà lespartir des fichiers

sql/llx_infrasstudio_*.sql

.

« Permission denied » (filesystem)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

. C'La cause est presque toujours une extension PHP manquante.

Vérification

📋après 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.verte.
  • Aucune erreur n'est consignée dans htdocs/documents/dolibarr.log.
  • La page Configuration → InfraSStudio → Diagnostic est accessible (on y va au Chapitre 8).accessible.

Au prochainchapitre chapitre,suivant, onvous déclaredéclarerez levotre premier site managé.géré par le module.

Back to top