Partie II — Démarrer

Chapitre 8 — Vérifier l'installation avec la page Diagnostic

Le module dispose d'une page dédiée qui passe en revue l'ensemble de l'intégration et indique, point par point, si tout est en ordre.

C'est le premier réflexe à adopter après une installation, après une mise à jour ou en cas de comportement inattendu.

Accéder à la page Diagnostic

  1. Rendez-vous dans Outils → InfraS → InfraSStudio.
  2. Cliquez sur l'onglet Diagnostic dans le menu latéral.

La page se charge et exécute en direct une série de vérifications. Chaque ligne s'accompagne d'une pastille de couleur :

Couleur

Signification

Vert

Le point est correctement configuré. Aucune action n'est requise.

Orange

Avertissement non bloquant. Le module fonctionne mais une amélioration est possible.

Rouge

Anomalie bloquante. Une fonctionnalité importante ne fonctionne pas correctement.

Bleu

Information contextuelle, sans contrôle effectué.

Section 1 — Environnement

Cette section vérifie les versions de Dolibarr et de PHP, ainsi que la présence des extensions PHP requises.

Contrôle

Action en cas d'anomalie

Version Dolibarr

Mettez Dolibarr à jour (entre 18.0.0 et 24.x.x).

Version PHP

Demandez à votre hébergeur de basculer sur une version comprise entre 7.4 et 8.4.

Extensions PHP

Installez les extensions manquantes (par exemple

apt install php-mbstring php-gd

).

Module InfraSStudio activé

Activez le module dans Configuration → Modules.

Module Website (dépendance)

Activez le module Website dans Configuration → Modules.

Section 2 — Schéma SQL

Cette section vérifie la présence des cinq tables du module dans la base de données :

Conseil — En cas de table manquante, désactivez puis réactivez le module dans Configuration → Modules. Le module recrée les tables absentes lors de la réactivation.

Section 3 — Stockage

Cette section vérifie que les dossiers d'écriture sont accessibles à PHP :

Avertissement — Si un dossier n'est pas accessible en écriture, corrigez les permissions :
chown -R www-data:www-data /var/www/dolibarr/htdocs/documents/

Section 4 — Intégration Dolibarr

Cette section vérifie les hooks, le trigger et les tâches planifiées.

Contrôle

Description

Hooks

Quatre hooks sont attendus :

main

,

login

,

websitepage

,

websitenav

.

Trigger PRODUCT et CATEGORY

Le fichier

InterfaceInfrasstudiotrigger

doit être présent sur le disque.

Tâches planifiées

Au moins une tâche cron doit être déclarée pour le module.

Section 5 — Sites gérés

Pour chaque site activé, cette section contrôle :

« Aucun docroot résolu » — Définissez la constante INFRASSTUDIO_SITE_<id>_DOCROOT avec le chemin Apache absolu de ce site, ou utilisez le pattern INFRASSTUDIO_DOCROOT_PATTERN (par exemple /var/www/{ref}).

Section 6 — Catalogue produit dynamique (optionnel)

Cette section n'apparaît que si vous avez configuré INFRASSTUDIO_WEBSITE_KEY ou INFRASSTUDIO_PUBLIC_DOCROOT. Elle vérifie que ces deux constantes pointent vers des cibles valides.

Lecture du résultat global

Tous les voyants au vert — Vous pouvez passer à la Partie III (utilisateur final) ou à la Partie IV (développeur), selon votre rôle.

Quelques avertissements oranges — Le module fonctionne. Examinez les avertissements à tête reposée et décidez s'il convient de corriger immédiatement ou plus tard.

Au moins un voyant rouge — Interrompez votre installation et corrigez l'anomalie. Une fonctionnalité importante est inopérante et son symptôme apparaîtra plus tard de manière inattendue.

Quand relancer le diagnostic

Bonne pratique pour les équipes — Demandez à toute personne signalant un dysfonctionnement de joindre d'abord une capture d'écran de la page Diagnostic. La majorité des incidents trouvent leur explication dans une ligne orange ou rouge passée inaperçue.

Chapitre 7 — Activer un site managé

Le module est installé mais ne gère encore aucun site. Cette étape consiste à lui indiquer quel site Dolibarr Website il doit prendre en charge. C'est cette opération qui établit la connexion entre le module et un site existant.

Étape 1 — Disposer d'un site Website

Avant de l'activer dans le module, le site doit déjà exister dans le module Website natif. Si ce n'est pas encore le cas :

  1. Rendez-vous dans Accueil → Sites web (menu du module Website).
  2. Cliquez sur « Nouveau site ».
  3. Renseignez les informations suivantes :
    • Référence : un identifiant court sans espace, par exemple monsite.
    • Description : optionnelle.
    • Virtualhost : l'URL publique, par exemple https://monsite.com.
    • Langue principale : par exemple fr_FR.
    • Autres langues : optionnel, séparées par des virgules.
  4. Enregistrez.

Note — Le module détecte automatiquement les sites créés dans Website. Aucune configuration parallèle n'est nécessaire.

Étape 2 — Sélectionner le site dans la configuration

  1. Rendez-vous dans Outils → InfraS → InfraSStudio.
  2. Cliquez sur l'entrée Configuration dans le menu latéral du module.
    • La page Paramètres de configuration s'affiche.
  3. Repérez la section « Sites Website gérés ».
    • Vous y voyez la liste de tous les sites Dolibarr Website disponibles, accompagnés d'une case à cocher.
  4. Cochez le ou les sites que vous souhaitez éditer via InfraSStudio.
  5. Cliquez sur « Enregistrer » en bas de la page.

Effet — Le site apparaît désormais sur le tableau de bord du Studio d'Infrasstudio. Vous pouvez commencer à l'éditer.

Étape 3 — Réglages spécifiques par site

Pour chaque site coché, deux réglages complémentaires apparaissent.

Le mode de stockage des médias

Vous choisissez l'emplacement physique où les images téléversées seront enregistrées :

Mode

Quand l'utiliser

Avec le site (mode native)

— recommandé

Les fichiers sont servis directement par Apache via le lien symbolique

/medias/

standard. Plus rapide, URL plus courte, accessible également depuis l'éditeur Dolibarr Website natif.

Gerer par le module Infrasstudio

Les fichiers sont servis via

document.php?modulepart=infrasstudio

. Utile uniquement lorsque le serveur Apache n'a pas accès au dossier

/medias/

du site.

La page d'index du blog

Si votre site comporte une page « Blog » ou « Ressources » qui liste les articles publiés, vous pouvez la désigner ici.

Conseil — Lorsque vous serez sur cette page dans l'éditeur, le bouton « + Nouveau » deviendra automatiquement « + Nouvel article ». C'est un raccourci ergonomique appréciable.

Laissez ce paramètre sur « Aucune » si votre site ne dispose pas de blog.

Étape 4 — Configuration du catalogue produit (optionnel)

Cette section ne concerne que les sites disposant d'un catalogue produit dynamique, c'est-à-dire d'une page web générée automatiquement par produit Dolibarr publié.

Le cas échéant, configurez :

Constante

Valeur

INFRASSTUDIO_WEBSITE_KEY

La référence du site cible (par exemple

monsite

)

INFRASSTUDIO_PUBLIC_DOCROOT

Le chemin Apache absolu du site (par exemple

/var/www/monsite

)

Le bouton « Reconstruire maintenant » permet de générer immédiatement les wrappers solution-<ref>.php pour chaque produit publié.

Note — Si vous ne savez pas si vous avez besoin de cette fonctionnalité, ignorez cette section. Le Chapitre 23 explique le catalogue dynamique en détail.

Étape 5 — Réglages avancés

En bas de la page Configuration, une section repliable « Réglages avancés » expose des constantes plus pointues. Pour une première installation, conservez les valeurs par défaut. Le Chapitre 25 documente chacun de ces paramètres.

Liste de contrôle après activation

Votre site est correctement activé si :

Au chapitre suivant, le diagnostic complet permet de valider l'intégration de bout en bout.

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 :

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 :

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

Chapitre 5 — Prérequis et compatibilité

Avant l'installation du module, il convient de vérifier que votre environnement répond aux conditions techniques requises. Cette page liste l'ensemble des prérequis. Aucun n'est facultatif.

Côté Dolibarr

Élément

Exigence

Version Dolibarr

18.0.0 minimum, 24.x.x maximum

Module Website

Activé. Cette dépendance est obligatoire ; sans elle, l'installation du module échoue.

Au moins un site Website

Créé avec une référence et un virtualhost

Module Categories

Recommandé. Utile pour la catégorisation des contenus.

Conseil — La version de votre Dolibarr est consultable depuis Accueil → À propos. La liste des modules activés est disponible dans Configuration → Modules.

Côté serveur (PHP et système)

Élément

Exigence

Version PHP

7.4 minimum, 8.4 maximum

Extensions PHP

mbstring

,

json

,

pdo_mysql

,

gd

,

fileinfo

Base de données

MySQL 5.7 ou supérieur, ou MariaDB 10.3 ou supérieur

Serveur web

Apache (recommandé) ; nginx pris en charge avec une configuration dédiée

Espace disque

Environ 50 Mo pour le module, en plus de l'espace nécessaire à vos médias

Permissions du système de fichiers

PHP doit pouvoir écrire dans

DOL_DATA_ROOT

ainsi que dans le docroot des sites

Note — Tous ces prérequis sont contrôlés automatiquement par la page Diagnostic du module après installation. En cas de doute, procédez à l'installation et laissez le diagnostic identifier les manquements éventuels.

Vérification rapide en ligne de commande

Si vous disposez d'un accès SSH au serveur, les commandes suivantes vous permettent de contrôler l'environnement en quelques instants :

# Version PHP
php -v

# Extensions PHP installées
php -m | grep -iE "mbstring|json|pdo_mysql|gd|fileinfo"

# Version de Dolibarr
grep "version =" /var/www/dolibarr/htdocs/filefunc.inc.php

# Espace disque disponible
df -h /var/www/

Liste de contrôle avant installation

Avant de passer au chapitre suivant, assurez-vous des points suivants :

Avertissement — Sur une instance de production, il est impératif d'effectuer une sauvegarde complète (base de données et fichiers) avant l'installation. C'est l'occasion idéale de tester votre procédure de restauration.