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

🩺

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

InfraSStudiomodule dispose d'une page dédiée qui passe en revue toutel'ensemble de l'intégration et vous dit,indique, point par point, si tout est en ordre. C'est le premier réflexe à avoiradopter après une installation, après une mise à jour,jour ou en cas de comportement inattendu.

---

🚪

Accéder à la page Diagnostic

1. AllezRendez-vous dans Outils → InfraS → InfraSStudio.InfraSStudio.
2. Dans le menu latéral, cliquezCliquez sur l'onglet Diagnostic. dans le menu latéral.

La page se charge et exécute en direct une série de vérifications. VousChaque voyezligne s'accompagne d'une successionpastille de lignes avec une pastille colorée à droitecouleur :

Couleur	Signification
🟢 Vert (OK)	Le point est correctement configuré. RienAucune àaction faire.n'est requise.
🟠 Orange (warn)	Avertissement non bloquant. Le module fonctionne mais quelqueune choseamélioration pourraitest être amélioré.possible.
🔴 Rouge (danger)	ProblèmeAnomalie bloquant.bloquante. Une fonctionnalité importante estne cassée.fonctionne pas correctement.
🔵 Bleu (info)	Information contextuelle, passans uncontrôle test.effectué.

---

📊

Section 1 — Environnement

VérifieCette section vérifie les versions de Dolibarr et de PHP, ainsi que lesla présence des extensions PHP requises.

TestContrôle	QueAction faireen sicas rouge / oranged'anomalie
Version Dolibarr	Mettez Dolibarr à jour (≥entre 18.0.0,0 ≤et 24.x.x).
Version PHP	Demandez à votre hébergeur de basculer sur PHPune version comprise entre 7.4 →et 8.4.
Extensions PHP	Installez les extensions manquantes via(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

VérifieCette quesection lesvérifie 5la présence des cinq tables du module sontdans présentesla enbase base.de données :

• llx_infrasstudio_slot
• llx_infrasstudio_media
• llx_infrasstudio_media_alt
• llx_infrasstudio_revision
• llx_infrasstudio_product_translation

💡Conseil Si— uneEn cas de table manquemanquante, — Désactivezdésactivez puis réactivez le module dans Configuration → Modules. Le module recrée les tables absentes au momentlors de l'activation.la réactivation.

---

💾

Section 3 — Stockage

VérifieCette section vérifie que les dossiers d'écriture sont accessibles à PHP.PHP :

• DOL_DATA_ROOT —: le dossierla racine des données Dolibarr.
• Dossier de données du module —: créé au premier upload.téléversement.

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

---

🪝

Section 4 — Intégration Dolibarr

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

TestContrôle	Description
Hooks	4Quatre hooks sont attendus : main , login , websitepage , websitenav .
Trigger PRODUCT et CATEGORY	Le triggerfichier InterfaceInfrasstudiotrigger doit existerêtre présent sur le disque.
Tâches cronplanifiées	Au moins une tâche cron doit être déclarée pour le module.

---

🌐

Section 5 — Sites managés (per-site)

gérés

Pour chaque site activéactivé, viacette lasection Configuration, vérifiecontrôle :

• Quela lerésolution du docroot du site est résolu (cascade : per-site → DOCROOT_PATTERN → fallback). ;
• Quele lebon fonctionnement du mode média fonctionne(présence (symlinkdu présentlien symbolique en mode native). ;
• Quel'accessibilité leen écriture du dossier data du site est inscriptible.site.

⚠️ « 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 (ex.par exemple /var/www/{ref}).

---

📦

Section 6 — Catalogue produit dynamique (optionnel)

ApparaîtCette seulementsection n'apparaît que si vous avez configuré INFRASSTUDIO_WEBSITE_KEY ou INFRASSTUDIO_PUBLIC_DOCROOT. VérifieElle vérifie que lesces deux constantes pointent survers des cibles valides.

---

🎯

Lecture du résultat global

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

🟠 Quelques warningsavertissements oranges — — Le module fonctionne. LisezExaminez les avertissements à tête reposée et décidez sis'il vousconvient voulezde corriger maintenantimmédiatement ou plus tard.

🔴 Au moins un pointvoyant rouge — —Interrompez Stop.votre Corrigezinstallation avantet decorrigez continuer.l'anomalie. Une fonctionnalité importante est casséeinopérante et vousson risquezsymptôme de la voirapparaîtra plus tard avecde unmanière comportement étrange dans l'éditeur ou côté public.inattendue.

---

🔁

Quand relancer le diagnostic

• 🆕 Après une installation initiale.initiale du module.
• ⬆️ Après chaque mise à jour du module.jour.
• 🔧 Après une migration de serveur ou un changement d'hébergement.
• 🐛 Quand Lorsqu'un comportement inattendu apparaît (slot non sauvegardé,enregistré, médias absents, etc.).
• 👋 Avant dela transmettretransmission ledu projet à un nouveau collègue ou à un client.

🎯 Bonne pratique d'équipepour les équipes — — Demandez à toute personne qui rapportesignalant un bugdysfonctionnement de collerjoindre d'abord laune copiecapture d'écran de la page Diagnostic. 80La %majorité des «incidents bugstrouvent »leur signalésexplication sont en réalitédans une configurationligne manquanteorange ou unrouge dossierpassée en lecture seule.inaperçue.