Annexe B — Foire aux questions (FAQ)
❓ Annexe B — Foire aux questions
Les questions qui reviennent le plus souvent. Si la vôtre n'y est pas, consultez le glossaire ou la page Diagnostic.
🚀 Installation et démarrage
Le module fonctionne-t-il sans le module Website ?
Non. Le module Website Dolibarr est une dépendance obligatoire. Activez-le d'abord, puis InfraSStudio.
Puis-je l'installer sur Dolibarr 17 ou 25 ?
Le module supporte Dolibarr 18.0.0 à 24.x.x. Sur des versions hors fenêtre, l'activation est refusée. Vous pouvez bypasser via la constante INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN=1, mais sans garantie de fonctionnement.
Combien de sites puis-je gérer simultanément ?
Aucune limite logicielle. Dans la configuration, cochez tous les sites Dolibarr Website que vous voulez gérer. Le tableau de bord affichera une carte par site.
✍️ Édition au quotidien
Pourquoi mes modifications ne sont-elles pas visibles publiquement ?
L'auto-save enregistre en brouillon, pas en publication. Cliquez sur le bouton « Publier les modifications » dans la toolbar pour les rendre visibles. Voir Chapitre 12.
Comment annuler complètement mes modifications de la journée ?
Bouton « Annuler les modifications » dans la toolbar. Une confirmation est demandée. Tous les brouillons de la page sont jetés et l'aperçu revient à la version publique.
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 une fonctionnalité directe — demandez à un administrateur de récupérer la valeur en base si nécessaire.
Comment travailler à plusieurs sur la même page sans conflit ?
L'auto-save écrit les brouillons toutes les 500 ms. Si deux personnes éditent le même slot en même temps, le dernier écrit gagne. Pour un workflow propre, mettez en place une convention de relecture (voir Chapitre 24).
🌍 Multilingue
Que voit un visiteur si une langue n'est pas traduite ?
Il voit la valeur canonique (généralement le français). Pas de page cassée, pas de texte vide. La résolution suit l'ordre : override locale → canonique → valeur par défaut du slot.
Mes traductions disparaissent quand je modifie le français — pourquoi ?
Elles ne disparaissent pas. Les traductions sont stockées séparément (overrides). Si la valeur d'un override locale est identique au canonique, le « smart save » du module supprime l'override pour éviter une duplication inutile. Re-saisissez la traduction si elle a vraiment changé.
Puis-je ajouter une langue qui n'existe pas dans Dolibarr ?
Le module accepte n'importe quelle locale au format xx_XX. Vous devez l'activer côté site Dolibarr Website (champ « Autres langues ») et créer les fichiers .lang Dolibarr correspondants si vous voulez bénéficier des fallbacks via @lang:.
📦 Catalogue produit
Pourquoi mon nouveau produit ne s'affiche pas dans le catalogue web ?
Vérifiez deux choses : (1) le produit est en tosell=1 dans Dolibarr ; (2) l'extrafield infrasstudio_published est coché. Sans les deux, le produit reste en brouillon et n'apparaît pas publiquement.
Comment ajouter un nouvel univers à mon catalogue ?
Définissez la constante INFRASSTUDIO_PRODUCT_UNIVERS_MAP avec un JSON qui map vos catégories Dolibarr à vos univers personnalisés. Voir Chapitre 23.
Puis-je désactiver complètement le catalogue dynamique ?
Oui. Ne définissez ni INFRASSTUDIO_WEBSITE_KEY ni INFRASSTUDIO_PUBLIC_DOCROOT. Le trigger et le cron sortent silencieusement. Aucun wrapper n'est généré.
🔧 Technique & développement
Puis-je créer mes propres types de slot ?
Pas directement — les 10 types livrés sont câblés dans le module. Mais vous pouvez créer vos propres shortcodes en déposant un fichier dans shortcodes/<nom>.shortcode.php. Voir Chapitre 20.
Comment migrer un site WordPress vers InfraSStudio ?
Ce n'est pas un import direct. Vous devrez : (1) créer le site dans Dolibarr Website ; (2) reconstruire le HTML des pages avec votre charte ; (3) annoter les zones éditables avec des slots ; (4) copier le contenu depuis WordPress dans le Studio. Le travail est essentiellement manuel mais l'éditeur Studio rend la saisie rapide.
Le module fonctionne-t-il avec nginx ?
Oui, à condition que la configuration nginx serve correctement les fichiers PHP du docroot Dolibarr. La majorité du module est agnostique du serveur web. Vérifiez juste que le symlink medias est bien servi (mode native) ou basculez en mode module.
Puis-je versionner mes slots avec Git ?
Indirectement. Les tpl.php avec leurs tokens {{slot:...}} sont versionnables (ils sont sur disque). Les valeurs des slots sont en base de données. Pour les versionner, exportez la table llx_infrasstudio_slot avec mysqldump.
🔐 Sécurité & performance
Le module ralentit-il mon site public ?
Marginalement. La résolution des slots fait quelques requêtes SQL par page (1 SELECT global). Sur une instance correctement dimensionnée, l'overhead est imperceptible. Si vous avez beaucoup de shortcodes {{product:...}} dans une boucle, l'impact peut grossir — voir Chapitre 20 pour les bonnes pratiques.
Comment sécuriser l'accès au Studio ?
Utilisez les permissions Dolibarr finement. N'attribuez admin qu'aux développeurs ; pour les rédacteurs, donnez juste readContent + editContent. Voir Chapitre 24.
Les médias sont-ils protégés contre l'upload de fichiers malveillants ?
Oui. L'uploader utilise finfo pour détecter le MIME réel (pas l'extension), une whitelist des types autorisés, et passe par dol_move_uploaded_file() qui scanne via l'antivirus configuré dans Dolibarr.