- dodano obsługę Content Signals
- dodano obsługę ph_simpleblog
- dodano obsługę pdfaqpro
- dodano obsługę productcomments
- dodano obsługę iqitrewievs
Caractéristiques et avantages du module
- Markdown construit à partir des données PrestaShop et des modules de contenu pris en charge, et non par conversion d’une page rendue — le document ne contient ni menu, ni pied de page, ni formulaires, ni code d’autres modules.
- Coût en tokens radicalement plus faible côté agent : les en-têtes x-markdown-tokens et X-Markdown-Tokens-Estimate dans chaque réponse indiquent la taille estimée du document, et le panneau affiche une comparaison Markdown contre HTML pour l’entité indiquée.
- Deux canaux de diffusion indépendants — négociation de contenu à l’adresse canonique et adresses .md séparées — ainsi l’agent accède au contenu qu’il envoie ou non l’en-tête Accept.
- Dispositif de sécurité diagnostique avant l’activation de la négociation : le module ne permet pas d’activer la fonction tant qu’il n’a pas mesuré, avec de vraies requêtes HTTP, qu’un intermédiaire de cache n’empoisonnera pas le cache partagé.
- Principe « l’agent ne voit jamais plus qu’un visiteur » mis en œuvre comme règle, et non comme une série d’exceptions — les paramètres de visibilité de la boutique s’appliquent aux agents exactement comme à un visiteur anonyme.
- Prix calculés dans le contexte d’un visiteur, avec résolution explicite de la devise et du pays, afin que le cache n’enregistre pas le prix d’un client pour le servir ensuite à tous les autres.
- Prise en charge complète du multiboutique et du multilingue : paramètres, fichiers llms, cache et compteur sont gérés séparément pour chaque boutique et chaque langue.
- Zéro dépendance externe — sans Composer, sans bibliothèques externes, sans appels à des services tiers ; le module n’envoie les données de votre boutique nulle part ailleurs que dans la réponse à la requête.
- Statistiques sans identifiants de visiteurs : sont enregistrés les agrégats journaliers, la boutique, le canal, la famille de client ainsi que le type, l’identifiant et la langue du document avec l’heure de la dernière requête, sans adresses IP, sans sessions et sans User-Agent complet.
- Tout ce que recherchent les validateurs de préparation agentique : négociation de contenu sur l’adresse principale de la boutique, en-tête Vary: Accept, compteur de tokens sous le nom standard x-markdown-tokens et déclaration Content Signals dans robots.txt — sans rien ajouter manuellement aux fichiers du serveur.
- Compatibilité de PrestaShop 1.7.1.0 à 9.x et de PHP 7.0 à 8.5, vérifiée sur de véritables arborescences de sources, et non déclarée de manière purement formelle.
Fonctionnalités principales du module
- Négociation de contenu sur les adresses canoniques de la boutique : une requête avec Accept: text/markdown reçoit un document Markdown, une requête de navigateur reçoit le HTML inchangé.
- En-tête Vary: Accept et balise Link: rel="alternate" sur les pages HTML couvertes par le module, afin que les intermédiaires et les agents sachent qu’une version alternative existe.
- Adresses parallèles markdown/{typ}/{id}.md pour les produits, catégories, pages CMS, fabricants, la page d’accueil de la boutique et les articles de blog intégrés, sous leur propre préfixe afin d’éviter les conflits avec d’autres modules réécrivant les URL.
- Onglet Intégrations : prise en charge de ph_simpleblog, pdfaqspro, pdproductsfaqpro, iqitreviews et productcomments, avec sélection distincte de l’étendue des contenus publiés.
- Tableau de bord des statistiques : filtres par période, canal et famille de client, graphique journalier, classement des agents et des clients, ainsi que les 20 documents les plus souvent récupérés.
- Onglet Content Signals : déclaration des préférences vis-à-vis des systèmes automatisés, publiée dans robots.txt — détails dans une section séparée ci-dessous.
- La page d’accueil de la boutique répond aussi en Markdown — elle reçoit son propre document avec le nom et la description de la boutique, les catégories principales et les pages d’information. C’est précisément cette adresse que les validateurs de préparation agentique vérifient par défaut (isitagentready.com, panneau Agent Diagnostics de Cloudflare), donc sans elle, une boutique avec une négociation parfaitement fonctionnelle sur tout le catalogue était malgré tout marquée comme non prête.
- Fichier llms.txt — liste courte des sections les plus importantes de la boutique : catégories de premier niveau, pages d’information, articles de blog sélectionnés et lien vers l’index complet.
- Fichier llms-full.txt — index compact des entités publiques, y compris les articles de blog. Il contient les titres, les liens et les résumés, et pour les produits également les données d’offre disponibles ainsi que la moyenne et le nombre d’avis provenant de la source d’avis choisie. Découpé automatiquement en parties après dépassement de la taille configurée.
- Génération de llms-full.txt via un endpoint cron protégé par jeton ou reconstruction manuelle dans le panneau, avec budget de temps et reprise du travail interrompu. L’index complet n’est pas construit lors d’une requête ordinaire d’un visiteur.
- Jeton cron distinct pour chaque boutique, comparé en temps constant, avec une commande curl prête à copier dans le panneau.
- Cache du Markdown généré dans la base de données avec durée de vie configurable et invalidation par hooks lors d’un changement de produit, de combinaison, de prix promotionnel, de règle tarifaire, de stock, de catégorie, de page CMS et de fabricant.
- Onglet Diagnostic : sept vérifications effectuées par de vraies requêtes HTTP contre le propre point de sondage du module, avec distinction séparée entre les pannes « HTML servi à l’agent » et « Markdown servi au navigateur ».
- Vérification informative de la véritable adresse du catalogue après activation de la négociation, présentée séparément et sans bloquer la fonctionnalité.
- Aperçu du document dans le panneau pour le type et l’identifiant d’entité indiqués, avec compteur de tokens Markdown contre HTML et verdict explicite sur la visibilité de l’entité.
- Onglet Fichiers : état des fichiers llms pour chaque langue (présence, taille, date, nombre d’entités, nombre de parties), bouton de reconstruction manuelle avec budget de temps et commande cron.
- Compteur des accès des agents : agrégat jour × boutique × canal × famille de client, avec répartition par canaux négociation, route .md et llms ainsi que par familles openai, anthropic, perplexity, google, bing, script, browser et other.
- En-têtes de réponse adaptés à l’usage du contenu : X-Robots-Tag: noindex, nofollow sur les documents Markdown, X-Content-Type-Options: nosniff, ETag avec prise en charge de 304 ainsi qu’une politique Cache-Control différenciée pour l’adresse canonique et l’adresse .md.
- Données produit dans l’en-tête du document : type, identifiant, adresse canonique, adresse Markdown, titre, méta-description, adresse de l’image principale, SKU, marque, prix TTC et HT, devise, information fiscale, disponibilité, indication de lot, exigence de personnalisation, état du produit, catégories, langue et date de mise à jour.
- Prix régulier ainsi que montant et pourcentage de remise lorsque le produit est en promotion — l’agent ne verra pas le prix promotionnel comme un prix ordinaire.
- Tableau des variantes avec prix, quantité, disponibilité et identifiant de combinaison, afin que l’agent puisse indiquer une variante précise et non seulement la décrire.
- Contenu des lots de produits avec quantités et liens vers les documents Markdown de chaque élément.
- Information sur les champs de personnalisation requis, en excluant les champs appartenant à d’autres modules que PrestaShop n’affiche pas sur le front-office.
- Sélection des types d’entités mis à disposition des agents, appliquée uniformément sur tous les canaux : sur les routes .md, dans les fichiers llms et dans la balise de version alternative.
- Répertoire de travail du module protégé contre la lecture directe depuis le réseau, et fichiers llms servis exclusivement par les contrôleurs du module.
- Respect du mode maintenance de la boutique et de la géolocalisation — une boutique fermée aux visiteurs l’est aussi pour les agents.
- Panneau dans la convention PD avec en-tête du module et six onglets : Tableau de bord, Paramètres, Intégrations, Diagnostic, Fichiers et Content Signals. Le tableau de bord est l’écran d’accueil, et les paramètres sont accompagnés d’explications sur leur fonctionnement.
Blog et guides — intégration avec ph_simpleblog
L’intégration met également à disposition des agents les connaissances issues du blog de la boutique : guides d’achat, instructions et articles d’information. Chaque article publié et accessible à un visiteur peut avoir son propre document Markdown ainsi qu’un lien dans les fichiers llms.
- Le document de l’article contient le titre, l’introduction, le contenu, l’auteur, la catégorie du blog, la date de publication et de mise à jour, ainsi que l’adresse de la page source.
- Sont respectés l’activité de l’article et de sa catégorie, la date de publication, l’accès du visiteur non connecté, l’affectation à la boutique et la disponibilité de la traduction. Les articles privés et programmés pour l’avenir sont ignorés.
- Les articles publics sont ajoutés à llms-full.txt, et dans le court llms.txt apparaît une section blog et guides avec titres, liens et courtes descriptions disponibles.
- Dans l’aperçu court, il est possible d’afficher de 0 à 20 articles. Une liste personnalisée d’identifiants détermine l’ordre ; si la liste est vide, le module choisit d’abord les articles mis en avant, puis les plus récents. Le réglage 0 masque cette section tout en conservant les articles dans l’index complet.
- Les articles utilisent les mêmes canaux d’accès que le catalogue : adresse Markdown et négociation de contenu sur la page source, lorsque les fonctions correspondantes sont activées. Leurs documents peuvent être vérifiés dans l’aperçu du panneau.
FAQ des produits, catégories et pages CMS
Les questions et réponses forment une section du document de la page concernée. L’agent reçoit la description de l’offre ou le contenu de la page avec les réponses aux questions associées, par exemple sur le montage, le choix du produit, l’utilisation ou les conditions du service.
- pdfaqspro fournit des FAQ attribuées aux produits, catégories et pages CMS. Chacun de ces périmètres peut être activé séparément dans l’onglet Intégrations.
- L’ancien pdproductsfaqpro est pris en charge comme source de FAQ produits. Les FAQ de catégories et de CMS nécessitent le plus récent pdfaqspro. Si les deux modules sont actifs, la variante la plus récente est prioritaire.
- Sont publiées les questions actives de la bonne boutique et de la bonne page, en tenant compte des paramètres de publication et des règles linguistiques du module source. Si la source autorise une langue de remplacement, le document indique la langue de la réponse jointe.
- Un document peut contenir jusqu’à 500 questions et réponses, dans l’ordre défini dans le module FAQ. Les questions ou réponses vides sont ignorées.
- Les fichiers llms mènent aux documents des produits, catégories et CMS avec leurs sections FAQ. Les questions individuelles ne créent pas d’entrées supplémentaires dans l’index.
Notes et avis produits — iqitreviews et productcomments
Le document produit peut contenir un résumé des notes clients ainsi que le contenu des derniers avis publics. Dans le panneau, vous choisissez une seule source : iqitreviews ou productcomments, afin que les avis de deux modules ne soient pas additionnés entre eux.
- La moyenne et le nombre d’avis sont calculés sur la base de tous les avis publics selon les règles du module choisi, en tenant compte de la modération et du masquage des entrées.
- Deux niveaux sont disponibles : la seule moyenne et le nombre d’avis, ou le résumé avec 1 à 20 témoignages les plus récents. La limite de textes ne restreint pas l’ensemble des avis utilisé pour calculer la moyenne.
- Les témoignages sont sélectionnés du plus récent au plus ancien, sans sélection selon la note. Ils conservent leur langue d’origine et sont clairement marqués comme avis clients.
- Le périmètre de données d’un avis individuel comprend la note, la date, le titre et le contenu. Le module n’ajoute pas les champs contenant le nom du client ni l’identifiant de son compte.
- Dans llms-full.txt, le produit peut recevoir une information concise sur la moyenne, le nombre d’avis et la source. Le contenu des témoignages reste dans le document produit.
Onglet Intégrations — étendue et fraîcheur du contenu
Le panneau montre quels modules source sont actifs dans la boutique sélectionnée. Il est possible d’activer séparément le blog, les FAQ produits, les FAQ catégories et les FAQ CMS, ainsi que de choisir la source et l’étendue des avis. Les intégrations sont optionnelles, désactivées par défaut à l’installation, et leurs paramètres concernent une boutique précise.
Les modifications et suppressions d’articles, de FAQ et d’avis sont vérifiées lors d’une requête de document Markdown arrivant à la boutique, y compris lorsque le document se trouve déjà dans le cache du module. Les fichiers llms.txt et llms-full.txt sont rafraîchis lors d’une reconstruction dans l’onglet Fichiers ou via CRON. Les copies conservées par le CDN et les autres caches externes sont soumises à la durée de validité configurée de la réponse.
Tableau de bord — statistiques des agents et contenus les plus téléchargés
Le tableau de bord permet de voir quelles parties de la boutique sont récupérées dans les formats fournis par le module. Il couvre les documents du catalogue, les articles de blog ainsi que les fichiers llms.
- Sélection des 7, 14 ou 30 derniers jours et filtrage par canal d’accès et famille d’agent ou de client.
- Résumé du nombre de requêtes, de la part des bots reconnus et des agents IA, du nombre de documents différents ainsi que des requêtes enregistrées avec information de contenu.
- Graphique journalier avec tableau des valeurs, classement des familles d’agents et de clients, ainsi que comparaison des canaux : négociation de contenu, adresses Markdown et fichiers llms.
- Classement des 20 documents les plus souvent récupérés avec titre, type, langue, nombre de requêtes, part dans le trafic de contenu et heure de la dernière requête. Les articles de blog apparaissent avec leur propre titre et lien.
- Statistiques pour la boutique sélectionnée en multiboutique. Les détails de contenu sont collectés depuis le déploiement du compteur étendu ; les totaux de requêtes antérieurs restent disponibles.
Le compteur mesure les requêtes traitées par le module, y compris les réponses conditionnelles 304, et non les visiteurs uniques. La reconnaissance de la famille de client repose sur le User-Agent déclaré. Les requêtes entièrement servies par un cache externe n’entrent pas dans les statistiques du module.
Content Signals — déclaration de ce que vous autorisez aux systèmes automatisés
Une boutique dont le contenu est lu par des agents IA se retrouve tôt ou tard face à la question de ce à quoi elle consent réellement. Est-il permis d’en construire un index de moteur de recherche ? Est-il permis d’utiliser la description d’un produit pour répondre à la question d’un client ? Est-il permis d’entraîner un modèle sur ce catalogue ? Content Signals est un standard qui permet de répondre séparément à ces trois questions et de publier la réponse là où les automates regardent déjà de toute façon — dans le fichier robots.txt. Le module fournit pour cela un onglet dédié, trois choix simples et un aperçu de ce qui sera exactement écrit dans le fichier. Spécification : contentsignals.org.
- Indexation dans les moteurs de recherche (search) — construction d’un index et affichage de liens avec de courts extraits. N’inclut pas les résumés générés par l’IA.
- Réponse aux questions à partir de vos contenus (ai-input) — fournir le contenu au modèle au moment où quelqu’un pose une question, afin que la réponse s’appuie sur celui-ci. C’est exactement ainsi que fonctionnent les assistants d’achat.
- Entraînement des modèles d’IA (ai-train) — utilisation du contenu pour entraîner ou affiner des modèles.
- Chacune des trois catégories dispose d’un réglage indépendant autorisé ou interdit, décrit dans le panneau par une phrase simple en polonais — et non par la seule étiquette technique qu’un vendeur n’a aucune obligation de connaître.
- La déclaration est écrite dans robots.txt dans un bloc délimité par des marqueurs portant le nom du module. Rien en dehors de ces marqueurs n’est analysé, réécrit ou déplacé — vos propres règles et celles des autres modules restent intactes au byte près.
- PrestaShop réécrit robots.txt entièrement à chaque clic sur « Générer le fichier robots.txt » dans SEO et URL. Le module réinsère alors automatiquement son bloc, et l’onglet indique de toute façon si le fichier est à jour et permet de l’enregistrer à nouveau en un seul bouton.
- Le panneau indique avant l’enregistrement si le fichier est réellement inscriptible — au lieu d’annoncer un succès et de vous laisser avec une déclaration absente du fichier.
- La fonction s’installe désactivée : écrire quoi que ce soit dans un fichier partagé avec toute la boutique est une décision du vendeur, pas du module. La désinstallation du module supprime à nouveau le bloc.
- Dans une installation multiboutique, le panneau avertit explicitement que PrestaShop conserve un seul fichier robots.txt pour toutes les boutiques, de sorte que la déclaration enregistrée les couvre toutes.
- Il s’agit d’une déclaration de préférence, non d’un contrôle d’accès : elle ne bloque personne, et son respect relève de la décision de l’autre partie. Le module l’indique clairement, au lieu de suggérer une protection que ce mécanisme n’offre pas.
Usage métier
- Pour les boutiques PrestaShop qui veulent être correctement lues par les assistants d’achat et les agents IA, au lieu de compter sur le fait que le modèle nettoie lui-même la page HTML.
- Pour les vendeurs qui veulent contrôler exactement ce qui parvient aux agents — l’étendue des types d’entités, la visibilité des prix et des quantités, ainsi que le mode de publication.
- Pour les boutiques avec un catalogue étendu, où la différence entre une page HTML complète et un document Markdown se traduit par une différence réelle de coût côté demandeur.
- Pour les boutiques qui tiennent un blog et une base de FAQ, et qui veulent mettre à disposition des agents des conseils, des réponses aux questions et des avis clients avec l’offre produit.
- Pour les déploiements multiboutiques, où chaque boutique exige ses propres paramètres, ses propres fichiers llms et son propre jeton cron.
- Pour les entreprises qui veulent fonder leur décision d’investir davantage dans ce canal sur des données — le compteur d’accès montre si les agents interrogent réellement la boutique, et par quels chemins.
- Pour les boutiques fonctionnant derrière un CDN ou un reverse proxy, où l’activation autonome de la négociation de contenu sans vérification risquerait de servir la mauvaise version de la page aux clients ordinaires.
Ce que le module ne fait pas
- Ce n’est pas un module SEO et il n’améliore pas la position de la boutique dans les résultats de recherche Google — les documents Markdown sont explicitement marqués comme non indexables.
- Il préserve l’apparence et le contenu de la page HTML vue par les clients, en ajoutant l’information sur la version Markdown alternative dans les en-têtes HTTP et la balise de lien.
- Il n’envoie les données de la boutique à aucun service externe et ne nécessite ni compte ni clé API.
- Il n’applique pas les Content Signals et ne peut pas le faire : la déclaration dans robots.txt est l’expression d’une préférence, et non un contrôle d’accès — elle ne bloque personne, et son respect reste la décision de l’autre partie. Le module ne modifie pas les autres règles de ce fichier.
- Il n’effectue pas de traductions automatiques. Les noms des champs du document restent fixes et en anglais, le contenu des pages et des articles utilise les traductions disponibles, la FAQ respecte les règles linguistiques du module source, et les avis conservent la langue du témoignage du client.
Compatibilité
- PrestaShop : 1.7.1.0 - 9.x
- PHP : 7.0 - 8.5
- Sans Composer et sans bibliothèques externes
- Multiboutique : oui, paramètres et fichiers gérés séparément pour chaque boutique
- Multilingue : oui, documents et fichiers llms pour chaque langue active