Skip to main content

CHAPITRE 25 — Configuration avancée (constantes)

⚙️ Chapitre 25 — Configuration avancée (constantes)

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


🌐

Sites managés

gérés

Constante

Description

INFRASSTUDIO_MANAGED_SITES

CSV des IDsidentifiants de sites managés.gérés. Ex: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

IDIdentifiant de la page d'index du blog (active lel'assistant wizard« "+ Nouvel article"article »).

INFRASSTUDIO_SITE_<id>_DOCROOT

OverrideSurcharge du docroot Apache pour ce site spécifique.


📁

Portabilité filesystem

du système de fichiers

Pour les hébergements avecaux des layoutsconfigurations non standards :

Constante

Description

INFRASSTUDIO_DOCROOT_PATTERN

PatternModèle de chemin partagé avecutilisant placeholderle marqueur

{ref}

. Ex:Exemple :

/srv/sites/{ref}

.

INFRASSTUDIO_TEMPLATE_EXTRA_DIR

Dossier additionnelsupplé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 fallbackle repli sur /var/www/<ref>.


📦

Catalogue produit

Constante

Description

INFRASSTUDIO_WEBSITE_KEY

Référence du site cible des wrappers solution-*.solution.

INFRASSTUDIO_PUBLIC_DOCROOT

Docroot Apache absolu où écrire les wrappers.

INFRASSTUDIO_PRODUCT_UNIVERS_MAP

Surcharge JSON override de la cartographie catégorie vers univers.

INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS

CSV de slugs d'extrafieldsde champs personnalisés à déclarer traduisiblescomme (traduisibles, en pluscomplément du registre par défaut).défaut.

INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS_JSON

OverrideSurcharge JSON completcomplète du registre des extrafields traduisibles.registre.

INFRASSTUDIO_SITE_<id>_WRAPPER_PREFIX

Préfixe des wrappers (défaut:par défaut

solution-

).

INFRASSTUDIO_SITE_<id>_WRAPPER_TEMPLATE_PAGEURL

PageurlSlug du templategabarit (défaut:par défaut

solution-detail

).


🎨

Apparence du Studio

Constante

Valeurs

Par défaut

INFRASSTUDIO_UI_THEME

light

 (défaut) ou,

dark

light

INFRASSTUDIO_UI_ACCENT

indigo

 (défaut),

ochre

,

plum

,

forest

indigo


🌐

Multilingue côté templates

gabarits

Constante

Description

INFRASSTUDIO_LANG_ISO

Force la langue active. PoséeDéfinie dynamiquement par les templates.gabarits.

INFRASSTUDIO_LANG_COOKIE

Nom du cookie de persistance de la langue (défaut:par défaut

infras_lang

).

INFRASSTUDIO_LANG_MAP_JSON

OverrideSurcharge dude mappingla cartographie ISO2 vers locale (ex.exemple :

{"en":"en_GB"}

).

INFRASSTUDIO_BLOG_FALLBACK_IMAGE

Image par défaut quandaffichée lorsqu'un article n'ane possède pas ded'image hero.principale.


🐛

Compatibilité &et debug

débogage

Constante

Description

INFRASSTUDIO_DOL_VERSION

Version de Dolibarr lors de l'activation.activation Auto-géré.du module. Géré automatiquement.

INFRASSTUDIO_MAIN_VERSION

Version du module. Auto-géré.Géré automatiquement.

INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN

À régler sur

1

pour passercontourner outrela le checkvérification de version Dolibarr minminimale (usage avancé).


🛠️

Définir une constante

Méthode A — Via l'adminadministration du module

La majorité des constantes sont exposéesaccessibles dans Outils → InfraSStudio → Configuration,Configuration, dans la section repliabledépliable « Réglages avancés ». Le formulaire valide les valeurssaisies et affiche des avertissements non bloquants sien quelquecas chose semble incorrect.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 CLI
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 avoirchaque modifiémodification desde constantes,constante, lancez la page Diagnostic du module. Elle valide en direct quel'existence lesdes cheminschemins, existent,la quecohérence lesdes pattern sont corrects,modèles, etc.


📋

Récapitulatif

Vous savez maintenantdésormais :

  • Identifier les ~20vingt constantes du module classées par usage.
  • Comprendre la cascade docrootde (per-siterésolution du pattern → fallback).docroot.
  • Configurer le catalogue produit (websiteréférence key,du site, docroot, prefix,préfixe, template)gabarit).
  • Personnaliser l'apparence (theme,thème, couleur d'accent).
  • Définir une constante via admin,l'administration, SQL ou CLI.ligne de commande.
  • Valider une configuration via la page Diagnostic.