CHAPITRE 15 — Catalogue produit dynamique
📦 Chapitre 15 — Catalogue produit dynamique
Si votre site présente un catalogue de produits Dolibarr (services, logiciels, abonnements), InfraSStudiole module peut générer automatiquement une page web par produit,dédiée à partirchaque de votre catalogue Dolibarr existant.produit. Vous ajoutez un produit dans Dolibarr, sa page web est créée toutesans seule.intervention Magique.supplémentaire.
🎯 Le concept
Vous avezdisposez probablement déjà desde produits dans Dolibarr (table llx_product) avec leur fiche commerciale (label,libellé, description, prix). Sur votre site web, vous voulezsouhaitez :
📋Un catalogue quilisterépertorie tousvosles produits actifs.📄Une page détaillée par produit(landing produit).🔄Une mise à jour automatique : tout nouveau produit=donne une nouvelle page sansintervention.intervention manuelle.
InfraSStudioLe livremodule remplit exactement ça.ce besoin. Vous écrivez uneun seuleseul gabarit de fiche produit modèle(la (page solution-detail), et le module génère un wrapper solution-<ref>.php pour chaque produit publié.
🧩 Préparer un produit Dolibarr pour le catalogue
Pour qu'un produit apparaisse dans le catalogue web, deux conditions doivent être remplies :
Champ | Valeur requise |
|---|---|
Statut commercialisable (
) | À vendre (= 1) |
Publié sur le site (
) | Coché (= 1) |
Trois états possibles pour un produit
tosell | published | Visibilité |
|---|---|---|
0 | — |
|
1 | 0 |
|
1 | 1 |
|
📥 Accéder à la section Produits
- Ouvrez l'éditeur Studio.
- Dans la colonne de gauche, cliquez sur l'onglet Produits.
- La liste de tous vos produits commercialisables s'affiche.
Pour chaque produitproduit, vous voyez :
📛SaRéférenceréférence etlibellé.son libellé.🏷️SonTypetype (SaaS, Extension,InstantApplicationApp,instantanée,…etc.).🟢Sonou 🟠Statutstatut : publié (vert) ou brouillon (orange).
✍️ ÉditerModifier un produit
- Cliquez sur un produit dans la liste.
- L'aperçu central charge la page
solution-detailavec ce produit. - L'inspecteur à droite affiche les champs natifs Dolibarr et les
extrafields.champs personnalisés.
Champs éditables
modifiables
Catégorie | Champs |
|---|---|
|
|
|
|
|
|
ÉditionModifier d'un champ
- Cliquez sur le champ dans l'
inspecteurinspecteur,(ou directement sur l'élément correspondant dans l'aperçucentral).central. - L'inspecteur
s'ouvrepasse en mode édition avec un bouton«← Retour». - Modifiez la valeur.
- Pour les champs traduisibles, dépliez la section
«Autres langues». - Cliquez sur
«Enregistrer»en bas dupanelpanneau.(leLe compteur indique le nombre de champs modifiés enattente).attente. - L'aperçu se rafraîchit.
💡Conseil Différence avec les slots— — Pour les produits, l'auto-saveenregistrement automatique n'est pas activé : vous cliquez sur « Enregistrer » manuellement. C'Ce choix est volontaire cardélibéré, les champs Dolibarr sontétant plus sensiblessensibles, (synchroniséscar avecdirectement liés à votre fiche produit).produit commerciale.
🌐 Publier ou dépublierretirer un produit
- Sélectionnez le produit dans la liste.
- Dans la
toolbarbarre d'outils centrale, cliquez sur«Publier»(ou«Dépublier»si déjà publié). - Le module
basculemodifiel'extrafieldle champ personnaliséinfrasstudio_publishedà 1 (ou 0). - Il
appelledéclenche ensuite la régénération automatique des wrapperssolution-<ref>.php. - Une notification verte
confirme.confirme l'opération.
✅ Effet «de Publierla »publication — — Le wrapper /var/www/<site>/solution-<ref>.php est créé. La cardcarte du produit apparaît sur le catalogue. LeLa page de détail produit est accessible via /solution-<ref>.php.
✅ Effet «de Dépublierla »dépublication — — Le wrapper est supprimé. LeTout visiteur surtentant d'accéder à l'URL reçoit unune erreur 404. La cardcarte disparaît du catalogue.
🔄 Régénérer les wrappers manuellement
Si quelqueune chosedésynchronisation sembleest désynchronisésuspectée (— par exemple un produit modifié récemment nequi montren'affiche pas la bonne version)version :— deux options sont disponibles.
Bouton dans la toolbar
barre d'outils
- Sur la fiche produit, cliquez sur l'icône
«Régénérer wrapper»(icônesync)de synchronisation). - Le module reconstruit le wrapper de ce produit.
Bouton « Reconstruire maintenant » (admin)
administrateur)
AllezRendez-vous dans Outils → InfraSStudio →Configuration.Configuration.TrouvezRepérez la section«Wrappers solution».- Cliquez sur
«Reconstruire maintenant». TousL'ensemblelesdes wrapperssontestrégénérésrégénéré en unefois.seule opération.
ℹ️Note Filet de sécurité automatique— —Une Untâche cronplanifiée horairetoutes les heures régénère les wrappers en arrière-plan. En cas d'oubli ou de bugd'incident temporaire, l'état est rétabli au plus tard une heure après.
La 📊page Le listingde catalogue
La page de catalogue (typiquementgénéralement /catalogue.php) liste tous les produits publiés sous forme de cards.cartes. Chaque cardcarte afficheprésente :
🖼️L'imageheroprincipale du produit.🏷️UneUnétiquettebadge éventueléventuelle (« Nouveau », « Promotion »,…etc.).📛Lelabel.libellé.📝 La tagline.L'accroche.🌍La catégorie/ouuniversl'univers,(déduitedéduits des catégoriesDolibarr).Dolibarr.🔗Un lien vers la page de détail.
Les visiteurs peuvent filtrer le catalogue par univers (Supply Chain, Health, Legal, …etc.) et par type (SaaS, Extension, Instant). Les filtres sont JS,en JavaScript et instantanés.
🔗 Lien direct depuis Dolibarr
Sur la fiche produit (côtédu Studio),Studio, un bouton « Voir public » ouvre la page solution publique dans un nouvel onglet. EtUn unautre bouton « Voir la fiche Dolibarr » ouvre la fiche produit Dolibarr native.
✅Aller-retour Round-tripfluide — — Vous pouvez aller-retournaviguer entre la fiche commerciale Dolibarr et l'éditeur web Studio sans casserinterrompre votre flux.flux de travail.
📋 Récapitulatif
✅ Vous savez maintenantdésormais :
- Comprendre qu'une page web est générée automatiquement par produit
publié est générée automatiquement.publié. - Préparer un produit (tosell=1, infrasstudio_published=1).
ÉditerModifier les champs natifs etextrafieldspersonnalisés depuis le Studio.DifférencierDistinguer les champs traduisiblesetdes champs non traduisibles.- Publier
/ou dépublier unproduitproduit,(gèrece qui pilote son wrapper et sa carte sur lewrapper + la card du catalogue).catalogue. - Régénérer manuellement un wrapper en cas de désynchronisation.
- Comprendre que le catalogue se filtre côté visiteur sans rechargement.
DernierLe dernier chapitre de la Partie III :aborde le SEO.référencement.