# Annexe B — Foire aux questions (FAQ)

## <span style="color: rgb(25, 5, 45);">Annexe B — Foire aux questions</span>

Les questions les plus fréquemment posées. Si la vôtre n'y figure pas, consultez le glossaire ou la page Diagnostic.

### <span style="color: rgb(35, 111, 161);">Installation et démarrage</span>

##### **Le module fonctionne-t-il sans le module Website ?**

Non. Le module Website Dolibarr constitue une dépendance obligatoire. Activez-le en premier, puis InfraSStudio.

##### **Puis-je l'installer sur Dolibarr 17 ou 25 ?**

<span style="white-space: pre-wrap;">Le module prend en charge Dolibarr 18.0.0 à 24.x.x. Sur des versions hors fenêtre, l'activation est refusée. Vous pouvez la contourner en définissant la constante </span>`<span class="editor-theme-code">INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN=1</span>`, mais sans garantie de bon fonctionnement.

##### **Combien de sites puis-je gérer simultanément ?**

Aucune limite logicielle. Dans la configuration, cochez tous les sites Dolibarr Website que vous souhaitez gérer. Le tableau de bord affichera une carte par site.

### <span style="color: rgb(35, 111, 161);">Édition au quotidien</span>

##### **Pourquoi mes modifications ne sont-elles pas visibles publiquement ?**

<span style="white-space: pre-wrap;">L'enregistrement automatique conserve les modifications en brouillon, et non en publication. Cliquez sur le bouton </span>**Publier les modifications**<span style="white-space: pre-wrap;"> dans la barre d'outils pour les rendre visibles. Voir le Chapitre 12.</span>

##### **Comment annuler complètement mes modifications de la journée ?**

<span style="white-space: pre-wrap;">Utilisez le bouton </span>**Annuler les modifications**<span style="white-space: pre-wrap;"> dans la barre d'outils. Une confirmation est demandée. Tous les brouillons de la page sont supprimés et l'aperçu revient à la version publique.</span>

##### **Puis-je récupérer une ancienne version d'un slot ?**

L'historique est consultable dans l'inspecteur du slot (section dépliable « Historique »). La restauration automatique d'une version antérieure n'est pas encore disponible. En cas de besoin, demandez à un administrateur de récupérer la valeur depuis la base de données.

##### **Comment travailler à plusieurs sur la même page sans conflit ?**

L'enregistrement automatique consigne les brouillons toutes les demi-secondes. Si deux personnes éditent le même slot simultanément, c'est la dernière saisie qui est conservée. Pour un circuit de relecture propre, mettez en place une convention organisationnelle (voir Chapitre 24).

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

##### **Que voit un visiteur si une langue n'est pas traduite ?**

Il voit la valeur canonique (généralement le français). Aucune page n'est cassée, aucun texte n'est vide. La résolution suit l'ordre : surcharge de langue, valeur canonique, valeur par défaut du slot.

##### **Mes traductions disparaissent quand je modifie le français — pourquoi ?**

<span style="white-space: pre-wrap;">Elles ne disparaissent pas. Les traductions sont stockées séparément (surcharges). Si la valeur d'une surcharge est </span>**identique**<span style="white-space: pre-wrap;"> au canonique, le mécanisme intelligent du module supprime la surcharge pour éviter une duplication inutile. Saisissez à nouveau la traduction si elle a réellement changé.</span>

##### **Puis-je ajouter une langue qui n'existe pas dans Dolibarr ?**

<span style="white-space: pre-wrap;">Le module accepte n'importe quelle locale au format </span>`<span class="editor-theme-code">xx_XX</span>`<span style="white-space: pre-wrap;">. Vous devez l'activer côté site Dolibarr Website (champ « Autres langues ») et créer les fichiers </span>`<span class="editor-theme-code">.lang</span>`<span style="white-space: pre-wrap;"> Dolibarr correspondants si vous souhaitez bénéficier des replis via </span>`<span class="editor-theme-code">@lang:</span>`.

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

##### **Pourquoi mon nouveau produit ne s'affiche-t-il pas dans le catalogue web ?**

<span style="white-space: pre-wrap;">Vérifiez deux conditions : le produit est en </span>`<span class="editor-theme-code">tosell=1</span>`<span style="white-space: pre-wrap;"> dans Dolibarr et le champ personnalisé </span>`<span class="editor-theme-code">infrasstudio_published</span>`<span style="white-space: pre-wrap;"> est coché. Sans ces deux conditions, le produit reste en brouillon et n'apparaît pas publiquement.</span>

##### **Comment ajouter un nouvel univers à mon catalogue ?**

<span style="white-space: pre-wrap;">Définissez la constante </span>`<span class="editor-theme-code">INFRASSTUDIO_PRODUCT_UNIVERS_MAP</span>`<span style="white-space: pre-wrap;"> avec un JSON qui associe vos catégories Dolibarr à vos univers personnalisés. Voir le Chapitre 23.</span>

##### **Puis-je désactiver complètement le catalogue dynamique ?**

<span style="white-space: pre-wrap;">Oui. Ne définissez ni </span>`<span class="editor-theme-code">INFRASSTUDIO_WEBSITE_KEY</span>`<span style="white-space: pre-wrap;"> ni </span>`<span class="editor-theme-code">INFRASSTUDIO_PUBLIC_DOCROOT</span>`. Le trigger et la tâche planifiée se terminent silencieusement. Aucun wrapper n'est généré.

### <span style="color: rgb(35, 111, 161);">Aspects techniques et développement</span>

##### **Puis-je créer mes propres types de slot ?**

<span style="white-space: pre-wrap;">Pas directement : les dix types livrés sont câblés dans le module. En revanche, vous pouvez créer vos propres shortcodes en déposant un fichier dans </span>`<span class="editor-theme-code">shortcodes/<nom>.shortcode.php</span>`. Voir le Chapitre 20.

##### **Comment migrer un site WordPress vers le module ?**

Il ne s'agit pas d'un import direct. Vous devrez : créer le site dans Dolibarr Website, reconstruire le HTML des pages avec votre charte, annoter les zones éditables avec des slots, puis copier le contenu depuis WordPress dans le Studio. Le travail est essentiellement manuel mais l'éditeur du Studio rend la saisie rapide.

##### **Le module fonctionne-t-il avec nginx ?**

<span style="white-space: pre-wrap;">Oui, à condition que la configuration nginx serve correctement les fichiers PHP du docroot Dolibarr. La majorité du module est indépendante du serveur web. Vérifiez simplement que le lien symbolique </span>`<span class="editor-theme-code">medias</span>`<span style="white-space: pre-wrap;"> est bien servi (mode native), ou basculez en mode module.</span>

##### **Puis-je versionner mes slots avec Git ?**

<span style="white-space: pre-wrap;">Indirectement. Les fichiers </span>`<span class="editor-theme-code">tpl.php</span>`<span style="white-space: pre-wrap;"> avec leurs tokens </span>`<span class="editor-theme-code">{{slot:...}}</span>`<span style="white-space: pre-wrap;"> sont versionnables (ils sont sur le disque). Les </span>**valeurs**<span style="white-space: pre-wrap;"> des slots sont en base de données. Pour les versionner, exportez la table </span>`<span class="editor-theme-code">llx_infrasstudio_slot</span>`<span style="white-space: pre-wrap;"> avec mysqldump.</span>

### <span style="color: rgb(35, 111, 161);">Sécurité et performance</span>

##### **Le module ralentit-il mon site public ?**

<span style="white-space: pre-wrap;">De manière marginale. La résolution des slots ajoute quelques requêtes SQL par page (un SELECT global). Sur une instance correctement dimensionnée, le surcoût est imperceptible. Si vous avez beaucoup de shortcodes </span>`<span class="editor-theme-code">{{product:...}}</span>`<span style="white-space: pre-wrap;"> dans une boucle, l'impact peut croître. Voir le Chapitre 20 pour les bonnes pratiques.</span>

##### **Comment sécuriser l'accès au Studio ?**

<span style="white-space: pre-wrap;">Utilisez les permissions Dolibarr de manière fine. N'attribuez </span>`<span class="editor-theme-code">admin</span>`<span style="white-space: pre-wrap;"> qu'aux développeurs. Pour les rédacteurs, donnez uniquement </span>`<span class="editor-theme-code">readContent + editContent</span>`. Voir le Chapitre 24.

##### **Les médias sont-ils protégés contre l'envoi de fichiers malveillants ?**

<span style="white-space: pre-wrap;">Oui. Le module utilise </span>`<span class="editor-theme-code">finfo</span>`<span style="white-space: pre-wrap;"> pour détecter le type MIME réel (et non l'extension), une liste blanche des types autorisés, et passe par </span>`<span class="editor-theme-code">dol_move_uploaded_file()</span>`<span style="white-space: pre-wrap;"> qui scanne via l'antivirus configuré dans Dolibarr.</span>