# PARTIE VI — Référence # CHAPITRE 32 — Référence des scripts en ligne de commande Tous les scripts en ligne de commande livrés avec le module. Chemin : `htdocs/custom/infrasstudio/scripts/`. ### rescan\_slots.php Rescanne les fichiers tpl.php d'un site et synchronise la table des slots. ``` php rescan_slots.php [--entity=N] [--purge-orphans] [--dry-run] [--lint] ```

Option	Effet
`--entity=N`	Force l'entity Dolibarr.
`--purge-orphans`	Supprime immédiatement les slots orphelins (sans attendre 30 jours).
`--dry-run`	Affiche les changements sans les appliquer.
`--lint`	Vérifie la syntaxe des slots. Code de sortie : 0 sans anomalie, 1 avec avertissement, 2 avec erreur.

### rebuild\_solution\_wrappers.php Reconstruit manuellement les wrappers solution-\*.php du catalogue produit. ``` php rebuild_solution_wrappers.php

[entity] # Exemple php rebuild_solution_wrappers.php monsite /var/www/monsite 2 ``` ### generate\_sitemap.php Génère le fichier sitemap.xml d'un site. ``` php generate_sitemap.php [entity] ``` Idéal pour une planification quotidienne via cron : ``` # crontab -e 0 3 * * * php /var/www/dolibarr/htdocs/custom/infrasstudio/scripts/generate_sitemap.php monsite 2 ``` ### preset\_default.php Chargeur générique de presets JSON. Crée des champs personnalisés produit en série. ``` php preset_default.php # Exemple avec le preset livré php preset_default.php htdocs/custom/infrasstudio/presets/keaticweb.json ``` Format JSON attendu : voir la documentation des presets. ### preset\_keatic.php Wrapper de compatibilité — équivalent à `preset_default.php presets/keaticweb.json`. ### consolidate\_sister\_pages.php Consolide une famille de pages sœurs (modèle B legacy) en une page canonique et plusieurs stubs (modèle A moderne). ``` php consolidate_sister_pages.php \ [--entity=N] \ [--base-slug=] \ [--dry-run] \ [--extractor=/path/to/extractor.php] ``` ### convert\_tpl\_to\_slots.php Transforme les `echo $langs->trans('Key')` d'un fichier tpl.php en tokens `{{slot:...|default=@lang:Key}}`. ``` php convert_tpl_to_slots.php [--group=xxx] [--prefix=yyy] [--dry-run] [--hook-engine] ```

Option	Effet
`--group=xxx`	Attribut group par défaut.
`--prefix=yyy`	Préfixe des noms de slot.
`--dry-run`	Aperçu des modifications sans application.
`--hook-engine`	Ajoute également l'inclusion du moteur du module.

### Bonnes pratiques en ligne de commande - Toujours utiliser `--dry-run` avant une migration importante. - Lancer en tant qu'utilisateur Apache (`sudo -u www-data php script.php`) pour éviter les problèmes de permissions sur les fichiers générés. - En multicompany, toujours préciser `--entity=N`. - Capturer la sortie dans un journal : `php script.php 2>&1 | tee /tmp/script.log`. **Fin de la Partie VI —** Vous disposez désormais d'un mémo complet : constantes, shortcodes, hooks, tables SQL, scripts en ligne de commande. Tout est rassemblé en un seul endroit pour une consultation rapide. # CHAPITRE 31 — Référence SQL : tables et colonnes ### llx\_infrasstudio\_slot Stockage des valeurs de slot. Une ligne par combinaison `(fk_website_page, slot_name, lang, entity)`.

Colonne	Type	Description
`rowid`	INT PK	Identifiant auto-incrémenté
`fk_website_page`	INT	Référence vers `llx_website_page`
`slot_name`	VARCHAR(64)	Identifiant du slot
`slot_type`	VARCHAR(16)	text, textarea, richtext, image, url, etc.
`lang`	VARCHAR(8)	Vide = canonique, sinon locale (fr\_FR, en\_US, etc.)
`value`	LONGTEXT	Valeur publique
`value_draft`	LONGTEXT	Brouillon en attente
`label` , `default_value` , `group_name` , `help` , `options`	VARCHAR/TEXT	Métadonnées (sur la ligne canonique uniquement)
`maxlength`	INT	Limite de caractères
`status`	INT	1 = actif, 0 = orphelin
`tms` , `fk_user_*`	DATETIME, INT	Audit standard Dolibarr
`entity`	INT	Multicompany

**Index unique** : `uk_infrasstudio_slot_uniq (fk_website_page, slot_name, lang, entity)`. ### llx\_infrasstudio\_media

Colonne	Type	Description
`rowid`	INT PK	Identifiant auto-incrémenté
`ref`	VARCHAR(64)	Identifiant unique par entity
`label`	VARCHAR(255)	Nom affiché
`kind`	VARCHAR(16)	image, video, document
`filepath`	VARCHAR(255)	Chemin relatif à `DOL_DATA_ROOT`
`filesize` , `mime` , `width` , `height`	INT/VARCHAR	Métadonnées physiques
`alt`	VARCHAR(255)	Texte alternatif canonique
`tags`	VARCHAR(255)	CSV de tags
`fk_website`	INT	Site associé
`variants_json`	TEXT	Cartographie des variantes générées
`status`	INT	1 = actif, 0 = corbeille
`entity`	INT	Multicompany

### llx\_infrasstudio\_media\_alt Surcharges du texte alternatif par langue.

Colonnes	Type
`rowid` PK, `fk_media` , `lang` , `alt` , `entity` , `tms`	Standards

**Index unique** : `(fk_media, lang, entity)`. ### llx\_infrasstudio\_revision Historique en mode ajout uniquement des modifications. Colonnes : `rowid`, `object_type` (slot ou media), `fk_object`, `action`, `payload` (JSON), `fk_user`, `date_creation`, `entity`. ### llx\_infrasstudio\_product\_translation Surcharges par langue des champs personnalisés produit traduisibles.

Colonne	Type
`rowid`	PK
`fk_product`	INT
`lang`	VARCHAR(8)
`field`	VARCHAR(64) — slug du champ personnalisé
`value`	MEDIUMTEXT
`tms` , `entity`	Standards

**Index unique** : `(fk_product, lang, field, entity)`. ### Tables Dolibarr utilisées sans modification - `llx_website` — sites - `llx_website_page` — pages (titre SEO, meta description, status, gabarit) - `llx_product` — produits (label et description FR canoniques, prix, tosell) - `llx_product_lang` — traductions natives label et description - `llx_product_extrafields` — champs personnalisés canoniques (FR) - `llx_categorie`, `llx_categorie_product` — catégories - `llx_const` — constantes du module - `llx_extrafields` — définitions des champs personnalisés - `llx_cronjob` — tâches planifiées - `llx_ecm_files` — fichiers attachés aux produits (mode du sélecteur à deux onglets) # CHAPITRE 30 — Référence des hooks et triggers ### Hooks Dolibarr utilisés par le module

Hook	Méthode appelée	Rôle
`main`	`checkSecureAccess`	Sécurité de l'accès aux médias via `document.php?modulepart=infrasstudio` .
`login`	divers	Initialisations à la connexion.
`websitepage`	`completeHtmlOutput`	Résolution des slots et shortcodes au moment du rendu public. Cœur du module.
`websitenav`	divers	Personnalisation des menus du module Website.

Implémentation : `htdocs/custom/infrasstudio/class/actions_infrasstudio.class.php`. ### Triggers Dolibarr écoutés Trigger `InterfaceInfrasstudiotrigger` dans `core/triggers/interface_99_modinfrasstudio_Infrasstudiotrigger.class.php`.

Événement	Réaction
`PRODUCT_CREATE`	Régénération des wrappers solution-\*.php
`PRODUCT_MODIFY`	idem
`PRODUCT_DELETE`	idem
`PRODUCT_PRICE_MODIFY`	idem
`CATEGORY_LINK`	idem (uniquement si `$object->element === 'product'` )
`CATEGORY_UNLINK`	idem

### Triggers Dolibarr émis par le module

Trigger émis	Quand
`PRODUCT_MODIFY`	Modification du libellé ou de la description en français depuis le Studio (via `Product::update()` ).
`PRODUCT_SET_MULTILANGS`	Modification des traductions natives produit depuis le Studio.

### Tâches planifiées déclarées

Tâche	Fréquence	Rôle
`StudioSolutionWrapper::rebuildAllConfigured`	Toutes les heures	Filet de sécurité pour la régénération des wrappers solution.
Purge des slots orphelins	Quotidien	Suppression des slots orphelins de plus de 30 jours.

# CHAPITRE 29 — Référence des shortcodes Tous les shortcodes livrés par le module, avec leurs sélecteurs et leurs champs disponibles. ### Namespace product **Sélecteurs** : `ref=` ou `id=` ou `ref=$current` (marqueur).

Champ	Source
`label`	`llx_product` et `llx_product_lang` selon la langue
`description`	idem
`note`	si `PRODUCT_USE_OTHER_FIELD_IN_TRANSLATION` est activée
`ref`	`llx_product.ref`
`price` , `price_ttc` , `cost_price`	Prix formatés selon la langue
`tosell` , `tobuy`	Statuts commercialisable et achetable (0 ou 1)
`ef_`	Tout champ personnalisé

``` {{product:ref=supplyflow.label}} {{product:ref=$current.ef_tagline}} {{product:id=42.price}} ``` ### Namespace category **Sélecteurs** : `id=` ou `ref=`. **Champs** : `label`, `description`, `color`, `ref`. ``` {{category:id=5.label}} {{category:ref=blog-marketing.label}} ``` ### Namespace dict **Sélecteurs** : `.=`.

Table de dictionnaire	Exemple
`c_country`	`{{dict:c_country.code=FR.label}}`
`c_currencies`	`{{dict:c_currencies.code_iso=EUR.label}}`
`c_civility`	`{{dict:c_civility.code=MR.label}}`

### Namespace mysoc **Sélecteur** : aucun (singleton). **Champs** : `name`, `address`, `zip`, `town`, `country_code`, `phone`, `fax`, `email`, `url`, `capital`, `tva_intra`, `idprof1` à `idprof6`, `logo`, `logo_small`, `logo_squarred`. ``` {{mysoc.name}} — {{mysoc.address}}, {{mysoc.zip}} {{mysoc.town}} SIRET {{mysoc.idprof2}} — TVA {{mysoc.tva_intra}} ``` ### Namespace extrafield **Sélecteurs** : `table=|ref=` ou `table=

|id=` avec `field=`. ``` {{extrafield:table=product|ref=supplyflow|field=tagline}} {{extrafield:table=societe|id=42|field=segment}} {{extrafield:table=product|ref=$current|field=tagline}} ``` ### Namespace media **Sélecteur** : `ref=`.

Champ	Retour
`url`	URL du fichier original
`thumb`	URL de la variante 200 × 200
`card`	URL de la variante 640 × 480
`wide`	URL de la variante 1600 × 1200
`alt`	Texte alternatif (résolu selon la langue)
`label`	Libellé affiché
`width` , `height`	Dimensions en pixels

### Étendre avec un namespace personnalisé Déposez un fichier dans `htdocs/custom/infrasstudio/shortcodes/.shortcode.php` qui exporte une fonction `infrasstudio_shortcode__resolve($args, $context)`. ``` function infrasstudio_shortcode_myorg_resolve($args, $context) { global $db; $id = isset($args['id']) ? (int) $args['id'] : 0; $field = isset($args['_field']) ? $args['_field'] : 'name'; // ... logique de résolution return $value; } ``` # CHAPITRE 28 — Référence des constantes Toutes les constantes Dolibarr utilisées par le module, classées par catégorie d'usage. Format : nom, type, valeur par défaut, description. ### Sites gérés

Constante	Type	Défaut	Description
`INFRASSTUDIO_MANAGED_SITES`	CSV	vide	Identifiants des sites Website gérés (par exemple `1,2,5` ).
`INFRASSTUDIO_SITE__MEDIA_MODE`	chaîne	`native`	Mode média par site : `native` ou `module` .
`INFRASSTUDIO_SITE__BLOG_INDEX_PAGE`	entier	0	Identifiant de la page d'index du blog (active l'assistant « + Nouvel article »).
`INFRASSTUDIO_SITE__DOCROOT`	chemin	vide	Surcharge du docroot Apache de ce site.
`INFRASSTUDIO_SITE__LAST_IMPORT`	timestamp	0	Géré automatiquement. Horodatage du dernier rescan automatique des médias.

### Portabilité du système de fichiers

Constante	Type	Défaut	Description
`INFRASSTUDIO_DOCROOT_PATTERN`	modèle	vide	Modèle partagé avec marqueur `{ref}` . Exemple : `/srv/sites/{ref}` .
`INFRASSTUDIO_TEMPLATE_EXTRA_DIR`	chemin	vide	Dossier supplémentaire pour les gabarits.

### Catalogue produit

Constante	Type	Défaut	Description
`INFRASSTUDIO_WEBSITE_KEY`	chaîne	vide	Référence du site cible des wrappers.
`INFRASSTUDIO_PUBLIC_DOCROOT`	chemin	vide	Docroot Apache absolu où écrire les wrappers.
`INFRASSTUDIO_PRODUCT_UNIVERS_MAP`	JSON	vide	Surcharge de la cartographie catégorie vers univers.
`INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS`	CSV	vide	Slugs de champs personnalisés à ajouter au registre traduisible.
`INFRASSTUDIO_TRANSLATABLE_PRODUCT_FIELDS_JSON`	JSON	vide	Surcharge complète du registre.
`INFRASSTUDIO_SITE__WRAPPER_PREFIX`	chaîne	`solution-`	Préfixe des wrappers générés.
`INFRASSTUDIO_SITE__WRAPPER_TEMPLATE_PAGEURL`	chaîne	`solution-detail`	Slug Dolibarr du gabarit.

### Apparence du Studio

Constante	Valeurs	Défaut
`INFRASSTUDIO_UI_THEME`	`light` , `dark`	`light`
`INFRASSTUDIO_UI_ACCENT`	`indigo` , `ochre` , `plum` , `forest`	`indigo`

### Multilingue

Constante	Type	Description
`INFRASSTUDIO_LANG_ISO`	chaîne	Langue active. Définie dynamiquement par les gabarits.
`INFRASSTUDIO_LANG_COOKIE`	chaîne	Nom du cookie de persistance de la langue.
`INFRASSTUDIO_LANG_MAP_JSON`	JSON	Surcharge de la cartographie ISO2 vers locale.
`INFRASSTUDIO_BLOG_FALLBACK_IMAGE`	URL	Image par défaut pour les articles sans image principale.

### Compatibilité et débogage

Constante	Description
`INFRASSTUDIO_DOL_VERSION`	Géré automatiquement. Version de Dolibarr lors de l'activation.
`INFRASSTUDIO_MAIN_VERSION`	Géré automatiquement. Version du module.
`INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN`	Régler sur `1` pour contourner la vérification de version Dolibarr minimale.
`INFRASSTUDIOBKP_*`	Sauvegarde automatique des constantes lors d'une désactivation. Préfixe accolé au nom d'origine.