Annexe B — Foire aux questions (FAQ)
❓ Annexe B — Foire aux questions
Les questions qui reviennent leles plus souvent.fréquemment posées. Si la vôtre n'y estfigure 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 estconstitue une dépendance obligatoire. Activez-le d'abord,en premier, puis InfraSStudio.
Puis-je l'installer sur Dolibarr 17 ou 25 ?
Le module supporteprend en charge Dolibarr 18.0.0 à 24.x.x. Sur des versions hors fenêtre, l'activation est refusée. Vous pouvez bypasserla viacontourner en définissant la constante INFRASSTUDIO_DISABLE_CHECK_VERSION_MIN=1, 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 voulezsouhaitez 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-saveenregistrement enregistreautomatique conserve les modifications en brouillon,brouillon, paset non en publication. Cliquez sur le bouton « Publier les modifications » dans la toolbarbarre d'outils pour les rendre visibles. Voir le Chapitre 12.
Comment annuler complètement mes modifications de la journée ?
BoutonUtilisez le bouton « Annuler les modifications » dans la toolbar.barre d'outils. Une confirmation est demandée. Tous les brouillons de la page sont jetéssupprimé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 unedisponible. fonctionnalitéEn directecas —de besoin, demandez à un administrateur de récupérer la valeur endepuis la base side nécessaire.données.
Comment travailler à plusieurs sur la même page sans conflit ?
L'auto-saveenregistrement écritautomatique consigne les brouillons toutes les 500 ms.demi-secondes. Si deux personnes éditent le même slot ensimultanément, mêmec'est temps,la ledernière derniersaisie écritqui gagne.est conservée. Pour un workflowcircuit de relecture propre, mettez en place une convention de relectureorganisationnelle (voir Chapitre 24).
Multilingue
🌍 Multilingue
Que voit un visiteur si une langue n'est pas traduite ?
Il voit la valeur canonique (généralement le français). Pas deAucune page n'est cassée, pas deaucun texte n'est vide. La résolution suit l'ordre : overridesurcharge localede →langue, canoniquevaleur →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)surcharges). Si la valeur d'unune override localesurcharge est identique au canonique, le «mécanisme smart save »intelligent du module supprime l'overridela surcharge pour éviter une duplication inutile. Re-saisissezSaisissez à nouveau la traduction si elle a vraimentréellement 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 voulezsouhaitez bénéficier des fallbacksreplis via @lang:.
📦 Catalogue produit
Pourquoi mon nouveau produit ne s'afficheaffiche-t-il pas dans le catalogue web ?
Vérifiez deux chosesconditions : (1) le produit est en tosell=1 dans Dolibarr ;et (2)le l'extrafieldchamp personnalisé infrasstudio_published est coché. Sans lesces deux,deux conditions, 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 mapassocie vos catégories Dolibarr à vos univers personnalisés. Voir le 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 lela crontâche sortentplanifiée se terminent silencieusement. Aucun wrapper n'est généré.
Aspects 🔧techniques Technique &et développement
Puis-je créer mes propres types de slot ?
Pas directement —: les 10dix types livrés sont câblés dans le module. MaisEn revanche, vous pouvez créer vos propres shortcodes en déposant un fichier dans shortcodes/<nom>.shortcode.php. Voir le Chapitre 20.
Comment migrer un site WordPress vers InfraSStudiole module ?
CeIl n'estne s'agit pas d'un import direct. Vous devrez : (1) créer le site dans Dolibarr Website ; (2)Website, reconstruire le HTML des pages avec votre charte ; (3)charte, annoter les zones éditables avec des slotsslots, ; (4)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 ?
Oui, à condition que la configuration nginx serve correctement les fichiers PHP du docroot Dolibarr. La majorité du module est agnostiqueindépendante du serveur web. Vérifiez justesimplement que le symlinklien symbolique medias est bien servi (mode native), ou basculez en mode module.
Puis-je versionner mes slots avec Git ?
Indirectement. Les fichiers tpl.php avec leurs tokens {{slot:...}} sont versionnables (ils sont sur le disque). Les valeurs des slots sont en base de données. Pour les versionner, exportez la table llx_infrasstudio_slot avec mysqldump.
🔐 Sécurité &et performance
Le module ralentit-il mon site public ?
Marginalement.De manière marginale. La résolution des slots faitajoute quelques requêtes SQL par page (1un SELECT global). Sur une instance correctement dimensionnée, l'overheadle surcoût est imperceptible. Si vous avez beaucoup de shortcodes {{product:...}} dans une boucle, l'impact peut grossircroître. —Voir voirle Chapitre 20 pour les bonnes pratiques.
Comment sécuriser l'accès au Studio ?
Utilisez les permissions Dolibarr finement.de manière fine. N'attribuez admin qu'aux développeursdéveloppeurs. ; pourPour les rédacteurs, donnez justeuniquement readContent + editContent. Voir le Chapitre 24.
Les médias sont-ils protégés contre l'uploadenvoi de fichiers malveillants ?
Oui. L'uploaderLe module utilise finfo pour détecter le type MIME réel (paset non l'extension), une whitelistliste blanche des types autorisés, et passe par dol_move_uploaded_file() qui scanne via l'antivirus configuré dans Dolibarr.