Vérifier l'installation avec la page Diagnostic

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

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

🚪 Accéder à la page Diagnostic

Allez dans Outils → InfraS → InfraSStudio.
Dans le menu latéral, cliquez sur l'onglet Diagnostic.

La page se charge et exécute en direct une série de vérifications. Vous voyez une succession de lignes avec une pastille colorée à droite :

Couleur	Signification
🟢 Vert (OK)	Le point est correctement configuré. Rien à faire.
🟠 Orange (warn)	Avertissement non bloquant. Le module fonctionne mais quelque chose pourrait être amélioré.
🔴 Rouge (danger)	Problème bloquant. Une fonctionnalité importante est cassée.
🔵 Bleu (info)	Information contextuelle, pas un test.

📊 Section 1 — Environnement

Vérifie les versions Dolibarr et PHP, ainsi que les extensions PHP requises.

Test	Que faire si rouge / orange
Dolibarr	Mettez Dolibarr à jour (≥ 18.0.0, ≤ 24.x.x).
PHP	Demandez à votre hébergeur de basculer sur PHP 7.4 → 8.4.
Extensions PHP	Installez les extensions manquantes via `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érifie que les 5 tables du module sont présentes en base.

llx_infrasstudio_slot
llx_infrasstudio_media
llx_infrasstudio_media_alt
llx_infrasstudio_revision
llx_infrasstudio_product_translation

💡 Si une table manque — Désactivez puis réactivez le module dans Configuration → Modules. Le module recrée les tables absentes au moment de l'activation.

💾 Section 3 — Stockage

Vérifie que les dossiers d'écriture sont accessibles à PHP.

DOL_DATA_ROOT — le dossier racine des données Dolibarr.
Dossier données module — créé au premier upload.

⚠️ Si un dossier n'est pas inscriptible — Corrigez les permissions :
chown -R www-data:www-data /var/www/dolibarr/htdocs/documents/

🪝 Section 4 — Intégration Dolibarr

Vérifie les hooks, le trigger et les tâches cron.

Test	Description
Hooks	4 hooks attendus : `main` , `login` , `websitepage` , `websitenav` .
Trigger	Le trigger `InterfaceInfrasstudiotrigger` doit exister sur le disque.
Tâches cron	Au moins une tâche cron doit être déclarée pour le module.

Test

Description

Hooks

4 hooks attendus :

main

login

websitepage

websitenav

Trigger

Le trigger

InterfaceInfrasstudiotrigger

doit exister sur le disque.

Tâches cron

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

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

Pour chaque site activé via la Configuration, vérifie :

Que le docroot du site est résolu (cascade : per-site → DOCROOT_PATTERN → fallback).
Que le mode média fonctionne (symlink présent en mode native).
Que le dossier data du site est inscriptible.

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

📦 Section 6 — Catalogue produit dynamique (optionnel)

Apparaît seulement si vous avez configuré INFRASSTUDIO_WEBSITE_KEY ou INFRASSTUDIO_PUBLIC_DOCROOT. Vérifie que les deux constantes pointent sur des cibles valides.

🎯 Lecture du résultat global

✅ Tout vert — Félicitations ! Vous pouvez passer à la Partie III (utilisateur final) ou IV (développeur) selon votre profil.

🟠 Quelques warnings oranges — Le module fonctionne. Lisez les avertissements à tête reposée et décidez si vous voulez corriger maintenant ou plus tard.

🔴 Au moins un point rouge — Stop. Corrigez avant de continuer. Une fonctionnalité importante est cassée et vous risquez de la voir plus tard avec un comportement étrange dans l'éditeur ou côté public.

🔁 Quand relancer le diagnostic

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

🎯 Bonne pratique d'équipe — Demandez à toute personne qui rapporte un bug de coller d'abord la copie d'écran de la page Diagnostic. 80 % des « bugs » signalés sont en réalité une configuration manquante ou un dossier en lecture seule.