# 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.

#### <span style="color: rgb(53, 152, 219);">Méthode 1 — Via l'interface Dolibarr (recommandée)</span>

<span style="white-space: pre-wrap;">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 </span>`<span class="editor-theme-code">MAIN_DISALLOW_INSTALL_EXTERNAL_MODULES</span>`<span style="white-space: pre-wrap;"> n'est pas activée sur votre instance.</span>

##### **Procédure**

1. Connectez-vous à Dolibarr en tant qu'administrateur.
2. Rendez-vous dans Accueil → Configuration → Modules.
3. <span style="white-space: pre-wrap;">Cliquez sur le bouton </span>**« Déployer / installer un module externe »**<span style="white-space: pre-wrap;"> en haut de la page.</span>
4. <span style="white-space: pre-wrap;">Cliquez sur </span>**« Choisir un fichier »**<span style="white-space: pre-wrap;"> et sélectionnez l'archive </span>`<span class="editor-theme-code">module_infrasstudio-X.Y.Z.zip</span>`.
5. <span style="white-space: pre-wrap;">Cliquez sur </span>**« 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.

<p class="callout info">**Conseil —**<span style="white-space: pre-wrap;"> L'archive doit être nommée </span>`<span class="editor-theme-code">module_infrasstudio-X.Y.Z.zip</span>`<span style="white-space: pre-wrap;">, où </span>`<span class="editor-theme-code">X.Y.Z</span>`<span style="white-space: pre-wrap;"> correspond au numéro de version. Ce nom est utilisé par Dolibarr pour identifier le module.</span></p>

#### <span style="color: rgb(53, 152, 219);">Méthode 2 — Manuelle (SSH ou FTP)</span>

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. <span style="white-space: pre-wrap;">Décompressez l'archive </span>`<span class="editor-theme-code">module_infrasstudio-X.Y.Z.zip</span>`<span style="white-space: pre-wrap;"> sur votre poste de travail.</span>
2. <span style="white-space: pre-wrap;">Vous obtenez un dossier nommé </span>`<span class="editor-theme-code">infrasstudio/</span>`.
3. <span style="white-space: pre-wrap;">Copiez ce dossier dans </span>`<span class="editor-theme-code"><votre_dolibarr>/htdocs/custom/</span>`<span style="white-space: pre-wrap;"> sur votre serveur, par SCP ou FTP.</span>
4. <span style="white-space: pre-wrap;">Vérifiez les permissions : le dossier doit être accessible en lecture par l'utilisateur sous lequel tourne PHP, généralement </span>`<span class="editor-theme-code">www-data</span>`.

```
# 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/
```

#### <span style="color: rgb(53, 152, 219);">Méthode 3 — Via Git (pour les développeurs)</span>

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
```

<p class="callout warning">**Avertissement —**<span style="white-space: pre-wrap;"> En production, ne pointez jamais sur la branche </span>`<span class="editor-theme-code">main</span>`. Utilisez toujours un tag de version stable.</p>

#### <span style="color: rgb(53, 152, 219);">Activer le module dans Dolibarr</span>

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

1. <span style="white-space: pre-wrap;">Rendez-vous dans </span>***Accueil → Configuration → Modules.***
2. <span style="white-space: pre-wrap;">Recherchez « </span>**InfraSStudio** » dans le filtre.
    - [x] <span style="white-space: pre-wrap;">La carte du module apparaît : « </span>**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 (`<span class="editor-theme-code">main</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">login</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">websitepage</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">websitenav</span>`),
    - déclaration des tâches planifiées,
    - restauration des constantes éventuellement sauvegardées lors d'une désactivation antérieure.
    
    
    - [x] L'interrupteur passe au vert : le module est activé.

<p class="callout info">**Vérification rapide —**<span style="white-space: pre-wrap;"> Survolez le menu Outils en haut de Dolibarr. Une nouvelle entrée doit apparaître : InfraS → InfraSStudio.</span></p>

#### <span style="color: rgb(53, 152, 219);">En cas d'échec de l'activation</span>

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

<table id="bkmrk-message-d%27erreurcaus" style="width: 100%; border-collapse: collapse; margin: 1rem 0px; font-size: 0.95em;"><colgroup><col></col><col></col></colgroup><tbody><tr style="background: rgb(25, 5, 45); color: rgb(254, 252, 232);"><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Message d'erreur

</th><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Cause et solution

</th></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">« Module Website non activé »

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Activez le module Website dans Configuration → Modules, puis revenez activer InfraSStudio.

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">« Version Dolibarr incompatible »

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);"><span style="white-space: pre-wrap;">Mettez Dolibarr à jour vers une version supportée. En dernier recours, définissez la constante </span>

`<span class="editor-theme-code">INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN=1</span>`

.

</td></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">« Erreur SQL CREATE TABLE »

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);"><span style="white-space: pre-wrap;">L'utilisateur SQL ne dispose pas du droit </span>

`<span class="editor-theme-code">CREATE</span>`

<span style="white-space: pre-wrap;">. Accordez-le, ou créez les tables manuellement à partir des fichiers </span>

`<span class="editor-theme-code">sql/llx_infrasstudio_*.sql</span>`

.

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">« Permission denied » sur le système de fichiers

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);"><span style="white-space: pre-wrap;">Exécutez </span>

`<span class="editor-theme-code">chown -R www-data:www-data htdocs/custom/infrasstudio/</span>`

<span style="white-space: pre-wrap;"> côté serveur.</span>

</td></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Page blanche après activation

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);"><span style="white-space: pre-wrap;">Consultez le fichier </span>

`<span class="editor-theme-code">htdocs/documents/dolibarr.log</span>`

. La cause est presque toujours une extension PHP manquante.

</td></tr></tbody></table>

### <span style="color: rgb(53, 152, 219);">Vérification après installation</span>

**Le module est correctement installé si :**

- <span style="white-space: pre-wrap;">L'entrée </span>***InfraS → InfraSStudio***<span style="white-space: pre-wrap;"> apparaît dans le menu Outils.</span>
- La carte du module dans Configuration → Modules est verte.
- <span style="white-space: pre-wrap;">Aucune erreur n'est consignée dans </span>`<span class="editor-theme-code">htdocs/documents/dolibarr.log</span>`.
- <span style="white-space: pre-wrap;">La page </span>***Configuration → InfraSStudio → Diagnostic est accessible***.

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