# Annexe A — Glossaire

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

### <span style="color: rgb(35, 111, 161);">Brouillon (draft)</span>

<span style="white-space: pre-wrap;">Modification d'un slot enregistrée mais non publiée. Visible uniquement dans l'aperçu du Studio. Stockée dans la colonne </span>`<span class="editor-theme-code">value_draft</span>`<span style="white-space: pre-wrap;"> de la table </span>`<span class="editor-theme-code">llx_infrasstudio_slot</span>`.

### <span style="color: rgb(35, 111, 161);">Canonique</span>

<span style="white-space: pre-wrap;">Valeur de référence d'un slot, partagée entre toutes les langues. Stockée avec </span>`<span class="editor-theme-code">lang=''</span>`. Utilisée comme valeur de repli lorsqu'une langue ne possède pas de surcharge.

### <span style="color: rgb(35, 111, 161);">CKEditor</span>

<span style="white-space: pre-wrap;">Éditeur visuel inclus nativement dans Dolibarr, utilisé pour les slots de type </span>`<span class="editor-theme-code">richtext</span>`.

### <span style="color: rgb(35, 111, 161);">Click-to-edit</span>

<span style="white-space: pre-wrap;">Fonctionnalité qui permet d'éditer un slot en cliquant directement sur le texte correspondant dans l'aperçu. Mise en œuvre via </span>`<span class="editor-theme-code">postMessage</span>`<span style="white-space: pre-wrap;"> entre l'iframe et l'éditeur.</span>

### <span style="color: rgb(35, 111, 161);">Constante (Dolibarr)</span>

<span style="white-space: pre-wrap;">Configuration stockée dans la table </span>`<span class="editor-theme-code">llx_const</span>`<span style="white-space: pre-wrap;">. Lue via </span>`<span class="editor-theme-code">getDolGlobalString()</span>`<span style="white-space: pre-wrap;">, écrite via </span>`<span class="editor-theme-code">dolibarr_set_const()</span>`<span style="white-space: pre-wrap;">. Toutes les configurations du module commencent par </span>`<span class="editor-theme-code">INFRASSTUDIO_</span>`.

### <span style="color: rgb(35, 111, 161);">Cron</span>

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.

### <span style="color: rgb(35, 111, 161);">DOL\_DATA\_ROOT</span>

<span style="white-space: pre-wrap;">Constante PHP de Dolibarr qui pointe vers la racine des données utilisateur (généralement </span>`<span class="editor-theme-code">/var/www/dolibarr/htdocs/documents/</span>`). Les médias et les fichiers tpl.php sont stockés sous cette racine.

### <span style="color: rgb(35, 111, 161);">Entity</span>

<span style="white-space: pre-wrap;">Identifiant d'une entité juridique en mode multicompany Dolibarr. Chaque table contient une colonne </span>`<span class="editor-theme-code">entity</span>`. Le module respecte strictement ce cloisonnement.

### <span style="color: rgb(35, 111, 161);">Extrafield (champ personnalisé)</span>

<span style="white-space: pre-wrap;">Champ personnalisé Dolibarr ajouté à un objet (produit, tiers, ticket, etc.). Stocké dans </span>`<span class="editor-theme-code">llx_<objet>_extrafields</span>`. Utilisé par le module pour enrichir les données du catalogue produit.

### <span style="color: rgb(35, 111, 161);">Hook</span>

<span style="white-space: pre-wrap;">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 </span>`<span class="editor-theme-code">main</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">login</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">websitepage</span>`<span style="white-space: pre-wrap;"> et </span>`<span class="editor-theme-code">websitenav</span>`.

### <span style="color: rgb(35, 111, 161);">hreflang</span>

<span style="white-space: pre-wrap;">Attribut HTML qui indique à Google qu'une page est la traduction d'une autre. Émis automatiquement par le helper </span>`<span class="editor-theme-code">infrasstudio_hreflang_tags()</span>`.

### <span style="color: rgb(35, 111, 161);">ISO2 et locale</span>

ISO2 désigne le code langue à deux lettres (`<span class="editor-theme-code">fr</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">en</span>`). Locale désigne le code complet pays-langue (`<span class="editor-theme-code">fr_FR</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">en_US</span>`). Le module utilise les locales en interne et les ISO2 dans les URLs visibles par l'utilisateur.

### <span style="color: rgb(35, 111, 161);">Multicompany</span>

<span style="white-space: pre-wrap;">Mode Dolibarr permettant à plusieurs entités juridiques de cohabiter sur la même installation, avec des données cloisonnées par </span>`<span class="editor-theme-code">entity</span>`.

### <span style="color: rgb(35, 111, 161);">Open Graph</span>

<span style="white-space: pre-wrap;">Protocole de balises </span>`<span class="editor-theme-code"><meta property="og:..."></span>`<span style="white-space: pre-wrap;"> 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.</span>

### <span style="color: rgb(35, 111, 161);">Orphelin (slot)</span>

<span style="white-space: pre-wrap;">Slot dont le token </span>`<span class="editor-theme-code">{{slot:...}}</span>`<span style="white-space: pre-wrap;"> a disparu du fichier </span>`<span class="editor-theme-code">tpl.php</span>`<span style="white-space: pre-wrap;"> mais dont la valeur est encore présente en base. Statut 0. Conservé pendant trente jours puis purgé par tâche planifiée.</span>

### <span style="color: rgb(35, 111, 161);">Override (surcharge de langue)</span>

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

### <span style="color: rgb(35, 111, 161);">Pages sœurs (sister pages)</span>

Modèle multilingue legacy dans lequel chaque langue dispose de son propre fichier tpl.php (`<span class="editor-theme-code">about.php</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">about-en.php</span>`<span style="white-space: pre-wrap;">, etc.). Le module prend en charge ce modèle via le helper </span>`<span class="editor-theme-code">sister_stub.tpl.php</span>`.

### <span style="color: rgb(35, 111, 161);">Permission</span>

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

### <span style="color: rgb(35, 111, 161);">Rescan</span>

<span style="white-space: pre-wrap;">Action de réexaminer tous les fichiers </span>`<span class="editor-theme-code">tpl.php</span>`<span style="white-space: pre-wrap;"> d'un site afin de synchroniser la table des slots. Effectué manuellement via l'interface ou en ligne de commande avec </span>`<span class="editor-theme-code">rescan_slots.php</span>`.

### <span style="color: rgb(35, 111, 161);">Shortcode</span>

<span style="white-space: pre-wrap;">Token </span>`<span class="editor-theme-code">{{namespace:sélecteur.champ}}</span>`<span style="white-space: pre-wrap;"> 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.</span>

### <span style="color: rgb(35, 111, 161);">Sitemap</span>

<span style="white-space: pre-wrap;">Fichier </span>`<span class="editor-theme-code">sitemap.xml</span>`<span style="white-space: pre-wrap;"> 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.</span>

### <span style="color: rgb(35, 111, 161);">Slot</span>

<span style="white-space: pre-wrap;">Emplacement éditable nommé dans une page, déclaré par un token </span>`<span class="editor-theme-code">{{slot:...|type=...}}</span>`<span style="white-space: pre-wrap;"> dans le HTML. Élément central du module.</span>

### <span style="color: rgb(35, 111, 161);">Studio</span>

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

### <span style="color: rgb(35, 111, 161);">Token</span>

<span style="white-space: pre-wrap;">Élément textuel délimité par </span>`<span class="editor-theme-code">{{</span>`<span style="white-space: pre-wrap;"> et </span>`<span class="editor-theme-code">}}</span>`<span style="white-space: pre-wrap;"> dans le HTML. Les slots et les shortcodes sont des tokens.</span>

### <span style="color: rgb(35, 111, 161);">tpl.php (gabarit)</span>

<span style="white-space: pre-wrap;">Fichier PHP qui contient le HTML d'une page Dolibarr Website. Stocké dans </span>`<span class="editor-theme-code">DOL_DATA_ROOT/<entity>/website/<ref>/page<N>.tpl.php</span>`.

### <span style="color: rgb(35, 111, 161);">Trigger</span>

É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\_\*.

### <span style="color: rgb(35, 111, 161);">Univers</span>

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

### <span style="color: rgb(35, 111, 161);">Variante (média)</span>

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.

### <span style="color: rgb(35, 111, 161);">Virtualhost</span>

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

### <span style="color: rgb(35, 111, 161);">Wrapper (Apache)</span>

<span style="white-space: pre-wrap;">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 </span>`<span class="editor-theme-code">tpl.php</span>`<span style="white-space: pre-wrap;">. Généré automatiquement par Dolibarr Website. Le catalogue dynamique génère également des wrappers </span>`<span class="editor-theme-code">solution-<ref>.php</span>`.

### <span style="color: rgb(35, 111, 161);">WYSIWYG</span>

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.