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 |
|---|---|
| CSV des identifiants de sites gérés. Exemple :
. |
| Mode média par site.
(par défaut) ou
. |
| Identifiant de la page d'index du blog (active l'assistant « + Nouvel article »). |
| 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 |
|---|---|
| Modèle de chemin partagé utilisant le marqueur
. Exemple :
. |
| 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 |
|---|---|
| Référence du site cible des wrappers solution. |
| Docroot Apache absolu où écrire les wrappers. |
| Surcharge JSON de la cartographie catégorie vers univers. |
| CSV de slugs de champs personnalisés à déclarer comme traduisibles, en complément du registre par défaut. |
| Surcharge JSON complète du registre. |
| Préfixe des wrappers (par défaut
). |
| Slug du gabarit (par défaut
). |
Apparence du Studio
Constante | Valeurs | Par défaut |
|---|---|---|
|
,
|
|
|
,
,
,
|
|
Multilingue côté gabarits
Constante | Description |
|---|---|
| Force la langue active. Définie dynamiquement par les gabarits. |
| Nom du cookie de persistance de la langue (par défaut
). |
| Surcharge de la cartographie ISO2 vers locale (exemple :
). |
| Image par défaut affichée lorsqu'un article ne possède pas d'image principale. |
Compatibilité et débogage
Constante | Description |
|---|---|
| Version de Dolibarr lors de l'activation du module. Géré automatiquement. |
| Version du module. Géré automatiquement. |
| À régler sur
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.