Skip to main content

Configuration avancée (constantes)

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

Le module expose une vingtaine de constantes Dolibarr qui ajustent finement son comportement. Ce chapitre les classe par usage avec leurs valeurs typiques.

🌐 Sites managés

Constante

Description

INFRASSTUDIO_MANAGED_SITES

CSV des IDs de sites managés. Ex:

1,2,5

.

INFRASSTUDIO_SITE_<id>_MEDIA_MODE

Mode média par site.

native

(défaut) ou

module

.

INFRASSTUDIO_SITE_<id>_BLOG_INDEX_PAGE

ID de la page index du blog (active le wizard "+ Nouvel article").

INFRASSTUDIO_SITE_<id>_DOCROOT

Override docroot Apache pour ce site spécifique.

📁 Portabilité filesystem

Pour les hébergements avec des layouts non standards :

Constante

Description

INFRASSTUDIO_DOCROOT_PATTERN

Pattern partagé avec placeholder

{ref}

. Ex:

/srv/sites/{ref}

.

INFRASSTUDIO_TEMPLATE_EXTRA_DIR

Dossier additionnel à scanner pour les gabarits de page.

ℹ️ Cascade de résolution — Pour le docroot d'un site, l'ordre est : INFRASSTUDIO_SITE_<id>_DOCROOT → INFRASSTUDIO_DOCROOT_PATTERN → fallback /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

JSON override de la cartographie catégorie → univers.

INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS

CSV de slugs d'extrafields à déclarer traduisibles (en plus du registre par défaut).

INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS_JSON

Override JSON complet du registre des extrafields traduisibles.

INFRASSTUDIO_SITE_<id>_WRAPPER_PREFIX

Préfixe des wrappers (défaut:

solution-

).

INFRASSTUDIO_SITE_<id>_WRAPPER_TEMPLATE_PAGEURL

Pageurl du template (défaut:

solution-detail

).

🎨 Apparence du Studio

Constante

Valeurs

INFRASSTUDIO_UI_THEME

light

(défaut) ou

dark

INFRASSTUDIO_UI_ACCENT

indigo

(défaut),

ochre

,

plum

,

forest

🌐 Multilingue côté templates

Constante

Description

INFRASSTUDIO_LANG_ISO

Force la langue active. Posée dynamiquement par les templates.

INFRASSTUDIO_LANG_COOKIE

Nom du cookie de persistance langue (défaut:

infras_lang

).

INFRASSTUDIO_LANG_MAP_JSON

Override du mapping ISO2 → locale (ex.

{"en":"en_GB"}

).

INFRASSTUDIO_BLOG_FALLBACK_IMAGE

Image par défaut quand un article n'a pas de hero.

🐛 Compatibilité & debug

Constante

Description

INFRASSTUDIO_DOL_VERSION

Version Dolibarr lors de l'activation. Auto-géré.

INFRASSTUDIO_MAIN_VERSION

Version du module. Auto-géré.

INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN

À

1

pour passer outre le check de version Dolibarr min (avancé).

🛠️ Définir une constante

Méthode A — Via l'admin du module

La majorité des constantes sont exposées dans Outils → InfraSStudio → Configuration, dans la section repliable « Réglages avancés ». Le formulaire valide les valeurs et affiche des avertissements non bloquants si quelque chose semble incorrect.

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

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 avoir modifié des constantes, lancez la page Diagnostic du module. Elle valide en direct que les chemins existent, que les pattern sont corrects, etc.

📋 Récapitulatif

✅ Vous savez maintenant :

  • Identifier les ~20 constantes du module classées par usage.
  • Comprendre la cascade docroot (per-site → pattern → fallback).
  • Configurer le catalogue produit (website key, docroot, prefix, template).
  • Personnaliser l'apparence (theme, accent).
  • Définir une constante via admin, SQL ou CLI.
  • Valider une configuration via la page Diagnostic.
Back to top