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 Rendez-vous dans Outils → InfraS → InfraSStudio . 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 : llx_infrasstudio_slot llx_infrasstudio_media llx_infrasstudio_media_alt llx_infrasstudio_revision llx_infrasstudio_product_translation 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 : DOL_DATA_ROOT : la racine des données Dolibarr. Dossier de données du module : créé au premier téléversement. 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 : la résolution du docroot (cascade : per-site → DOCROOT_PATTERN → fallback) ; le bon fonctionnement du mode média (présence du lien symbolique en mode native) ; l'accessibilité en écriture du dossier data du site. « Aucun docroot résolu » — Définissez la constante INFRASSTUDIO_SITE__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 Après une installation initiale du module. Après chaque mise à jour. Après une migration de serveur ou un changement d'hébergement. Lorsqu'un comportement inattendu apparaît (slot non enregistré, médias absents, etc.). Avant la transmission du projet à un nouveau collègue ou à un client. 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 : Rendez-vous dans Accueil → Sites web (menu du module Website). Cliquez sur « Nouveau site » . 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. 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 Rendez-vous dans Outils → InfraS → InfraSStudio . Cliquez sur l'entrée Configuration dans le menu latéral du module. La page Paramètres de configuration s'affiche. 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. Cochez le ou les sites que vous souhaitez éditer via InfraSStudio. 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-.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 : Le tableau de bord Studio ( Outils → InfraSStudio ) affiche désormais une carte pour ce site. Le bouton « Éditer » de cette carte ouvre l'éditeur en trois colonnes. La colonne de gauche liste bien les pages de votre site. Cliquer sur une page déclenche son aperçu au centre. 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 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 /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. 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 : Votre installation Dolibarr est en version 18.x à 24.x. Le module Website est activé. Au moins un site Website est créé, avec une référence et un virtualhost configurés. Vous disposez des droits d'administrateur sur Dolibarr. Vous avez à votre disposition l'archive du module ou un accès au répertoire htdocs/custom/ . 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.