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.