Annexe A — Glossaire

Liste alphabétique des termes techniques utilisés dans cette documentation et dans le module.

Brouillon (draft)

Modification d'un slot enregistrée mais non publiée. Visible uniquement dans l'aperçu du Studio. Stockée dans la colonne value_draft de la table llx_infrasstudio_slot.

Canonique

Valeur de référence d'un slot, partagée entre toutes les langues. Stockée avec lang=''. Utilisée comme valeur de repli lorsqu'une langue ne possède pas de surcharge.

CKEditor

Éditeur visuel inclus nativement dans Dolibarr, utilisé pour les slots de type richtext.

Click-to-edit

Fonctionnalité qui permet d'éditer un slot en cliquant directement sur le texte correspondant dans l'aperçu. Mise en œuvre via postMessage entre l'iframe et l'éditeur.

Constante (Dolibarr)

Configuration stockée dans la table llx_const. Lue via getDolGlobalString(), écrite via dolibarr_set_const(). Toutes les configurations du module commencent par INFRASSTUDIO_.

Cron

Tâche planifiée Dolibarr. Le module en déclare deux : régénération horaire des wrappers solution et purge quotidienne des slots orphelins.

DOL_DATA_ROOT

Constante PHP de Dolibarr qui pointe vers la racine des données utilisateur (généralement /var/www/dolibarr/htdocs/documents/). Les médias et les fichiers tpl.php sont stockés sous cette racine.

Entity

Identifiant d'une entité juridique en mode multicompany Dolibarr. Chaque table contient une colonne entity. Le module respecte strictement ce cloisonnement.

Extrafield (champ personnalisé)

Champ personnalisé Dolibarr ajouté à un objet (produit, tiers, ticket, etc.). Stocké dans llx_<objet>_extrafields. Utilisé par le module pour enrichir les données du catalogue produit.

Hook

Mécanisme Dolibarr permettant à un module externe d'intervenir à des points précis du code natif (rendu d'une page, sécurité, etc.). Le module utilise les hooks main, login, websitepage et websitenav.

hreflang

Attribut HTML qui indique à Google qu'une page est la traduction d'une autre. Émis automatiquement par le helper infrasstudio_hreflang_tags().

ISO2 et locale

ISO2 désigne le code langue à deux lettres (fr, en). Locale désigne le code complet pays-langue (fr_FR, en_US). Le module utilise les locales en interne et les ISO2 dans les URLs visibles par l'utilisateur.

Multicompany

Mode Dolibarr permettant à plusieurs entités juridiques de cohabiter sur la même installation, avec des données cloisonnées par entity.

Open Graph

Protocole de balises <meta property="og:..."> qui permet à Facebook, LinkedIn ou WhatsApp d'afficher un aperçu enrichi lors du partage d'une URL. Géré par le panneau SEO du module.

Orphelin (slot)

Slot dont le token {{slot:...}} a disparu du fichier tpl.php mais dont la valeur est encore présente en base. Statut 0. Conservé pendant trente jours puis purgé par tâche planifiée.

Override (surcharge de langue)

Valeur d'un slot spécifique à une langue, qui surcharge la valeur canonique pour les visiteurs de cette langue.

Pages sœurs (sister pages)

Modèle multilingue legacy dans lequel chaque langue dispose de son propre fichier tpl.php (about.php, about-en.php, etc.). Le module prend en charge ce modèle via le helper sister_stub.tpl.php.

Permission

Droit d'accès Dolibarr attribuable à un utilisateur ou à un groupe. Le module en définit sept : paramMenu, readContent, editContent, editTranslations, editMedias, publish, admin.

Rescan

Action de réexaminer tous les fichiers tpl.php d'un site afin de synchroniser la table des slots. Effectué manuellement via l'interface ou en ligne de commande avec rescan_slots.php.

Shortcode

Token {{namespace:sélecteur.champ}} qui inscrit une donnée Dolibarr en direct dans le HTML. Résolu au moment du rendu par un fournisseur PHP. À distinguer d'un slot.

Sitemap

Fichier sitemap.xml qui liste toutes les pages publiées d'un site. Lu par Google Search Console. Généré par le module via l'interface ou en ligne de commande.

Slot

Emplacement éditable nommé dans une page, déclaré par un token {{slot:...|type=...}} dans le HTML. Élément central du module.

Studio

L'interface principale d'édition du module, accessible via Outils → InfraSStudio. Composée de trois colonnes : arborescence, aperçu et inspecteur.

Token

Élément textuel délimité par {{ et }} dans le HTML. Les slots et les shortcodes sont des tokens.

tpl.php (gabarit)

Fichier PHP qui contient le HTML d'une page Dolibarr Website. Stocké dans DOL_DATA_ROOT/<entity>/website/<ref>/page<N>.tpl.php.

Trigger

Événement Dolibarr déclenché lors d'opérations métier (création de produit, modification, etc.). Le module écoute les triggers PRODUCT_* et CATEGORY_*.

Univers

Concept éditorial du catalogue produit : un univers regroupe plusieurs catégories Dolibarr en une thématique (Supply Chain, Health, Legal, etc.). Cartographiable via constante.

Variante (média)

Version redimensionnée d'une image générée automatiquement (thumb 200 × 200, card 640 × 480, wide 1600 × 1200) afin d'optimiser le poids selon l'usage.

Virtualhost

Configuration Apache qui associe un nom de domaine à un docroot. Configuré côté administration système, en dehors du module.

Wrapper (Apache)

Petit fichier PHP placé dans le docroot d'un site, qui sert de point d'entrée pour une URL et inclut le bon fichier tpl.php. Généré automatiquement par Dolibarr Website. Le catalogue dynamique génère également des wrappers solution-<ref>.php.

WYSIWYG

Acronyme de « What You See Is What You Get ». Désigne un éditeur visuel qui affiche le résultat formaté en direct (gras, italique, listes, etc.) plutôt qu'un code source brut.