# 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__MEDIA_MODE`	Mode média par site. `native` (par défaut) ou `module` .
`INFRASSTUDIO_SITE__BLOG_INDEX_PAGE`	Identifiant de la page d'index du blog (active l'assistant « + Nouvel article »).
`INFRASSTUDIO_SITE__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__DOCROOT`, puis `INFRASSTUDIO_DOCROOT_PATTERN`, puis le repli sur `/var/www/`. ### 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__WRAPPER_PREFIX`	Préfixe des wrappers (par défaut `solution-` ).
`INFRASSTUDIO_SITE__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.