CHAPITRE 25 — Configuration avancée (constantes)

Le module expose une vingtaine de constantes Dolibarr qui permettent d'ajuster son comportement. Ce chapitre les classe par catégorie d'usage avec les valeurs typiques. 

 Sites gérés 

 Constante Description INFRASSTUDIO_MANAGED_SITES CSV des identifiants de sites gérés. Exemple : 1,2,5 . INFRASSTUDIO_SITE_<id>_MEDIA_MODE Mode média par site. native (par défaut) ou module . INFRASSTUDIO_SITE_<id>_BLOG_INDEX_PAGE Identifiant de la page d'index du blog (active l'assistant « + Nouvel article »). INFRASSTUDIO_SITE_<id>_DOCROOT Surcharge du docroot Apache pour ce site spécifique. 

 Portabilité du système de fichiers 

 Pour les hébergements aux configurations non standards : 

 Constante Description INFRASSTUDIO_DOCROOT_PATTERN Modèle de chemin partagé utilisant le marqueur {ref} . Exemple : /srv/sites/{ref} . INFRASSTUDIO_TEMPLATE_EXTRA_DIR Dossier supplémentaire à scanner pour les gabarits de page. 

 Note — Cascade de résolution — Pour le docroot d'un site, l'ordre de recherche est : INFRASSTUDIO_SITE_<id>_DOCROOT , puis INFRASSTUDIO_DOCROOT_PATTERN , puis le repli sur /var/www/<ref> . 

 Catalogue produit 

 Constante Description INFRASSTUDIO_WEBSITE_KEY Référence du site cible des wrappers solution. INFRASSTUDIO_PUBLIC_DOCROOT Docroot Apache absolu où écrire les wrappers. INFRASSTUDIO_PRODUCT_UNIVERS_MAP Surcharge JSON de la cartographie catégorie vers univers. INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS CSV de slugs de champs personnalisés à déclarer comme traduisibles, en complément du registre par défaut. INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS_JSON Surcharge JSON complète du registre. INFRASSTUDIO_SITE_<id>_WRAPPER_PREFIX Préfixe des wrappers (par défaut solution- ). INFRASSTUDIO_SITE_<id>_WRAPPER_TEMPLATE_PAGEURL Slug du gabarit (par défaut solution-detail ). 

 Apparence du Studio 

 Constante Valeurs Par défaut INFRASSTUDIO_UI_THEME light , dark light INFRASSTUDIO_UI_ACCENT indigo , ochre , plum , forest indigo 

 Multilingue côté gabarits 

 Constante Description INFRASSTUDIO_LANG_ISO Force la langue active. Définie dynamiquement par les gabarits. INFRASSTUDIO_LANG_COOKIE Nom du cookie de persistance de la langue (par défaut infras_lang ). INFRASSTUDIO_LANG_MAP_JSON Surcharge de la cartographie ISO2 vers locale (exemple : {"en":"en_GB"} ). INFRASSTUDIO_BLOG_FALLBACK_IMAGE Image par défaut affichée lorsqu'un article ne possède pas d'image principale. 

 Compatibilité et débogage 

 Constante Description INFRASSTUDIO_DOL_VERSION Version de Dolibarr lors de l'activation du module. Géré automatiquement. INFRASSTUDIO_MAIN_VERSION Version du module. Géré automatiquement. INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN À régler sur 1 pour contourner la vérification de version Dolibarr minimale (usage avancé). 

 Définir une constante 

 Méthode A — Via l'administration du module 

 La majorité des constantes sont accessibles dans Outils → InfraSStudio → Configuration, dans la section dépliable « Réglages avancés ». Le formulaire valide les saisies et affiche des avertissements non bloquants en cas d'incohérence. 

 Méthode B — Via SQL 

 INSERT INTO llx_const (name, value, type, visible, entity)

VALUES ('INFRASSTUDIO_DOCROOT_PATTERN', '/srv/sites/{ref}', 'chaine', 0, 2); 

 Méthode C — Via PHP en ligne de commande 

 php -r "

require 'htdocs/master.inc.php';

\$conf->entity = 2;

dolibarr_set_const(\$db, 'INFRASSTUDIO_DOCROOT_PATTERN', '/srv/sites/{ref}',

 'chaine', 0, '', 2);

" 

 Vérifier la configuration 

 Après chaque modification de constante, lancez la page Diagnostic du module. Elle valide en direct l'existence des chemins, la cohérence des modèles, etc. 

 Récapitulatif 

 Vous savez désormais : 

 Identifier les vingt constantes du module classées par usage. Comprendre la cascade de résolution du docroot. Configurer le catalogue produit (référence du site, docroot, préfixe, gabarit). Personnaliser l'apparence (thème, couleur d'accent). Définir une constante via l'administration, SQL ou ligne de commande. Valider une configuration via la page Diagnostic.