- dodano obsługę Content Signals
- dodano obsługę ph_simpleblog
- dodano obsługę pdfaqpro
- dodano obsługę productcomments
- dodano obsługę iqitrewievs
Vlastnosti a výhody modulu
- Markdown sestavovaný z dat PrestaShopu a podporovaných obsahových modulů, nikoli převodem vyrenderované stránky — dokument neobsahuje menu, patičku, formuláře ani kód jiných modulů.
- Radikálně nižší náklady na tokeny na straně agenta: hlavičky x-markdown-tokens a X-Markdown-Tokens-Estimate v každé odpovědi uvádějí odhadovanou velikost dokumentu a panel zobrazuje porovnání Markdownu oproti HTML pro vybranou entitu.
- Dva nezávislé kanály doručení — vyjednávání obsahu na kanonické adrese a samostatné adresy .md — takže se agent dostane k obsahu bez ohledu na to, zda posílá hlavičku Accept.
- Diagnostická pojistka před zapnutím vyjednávání: modul nedovolí funkci spustit, dokud skutečnými HTTP požadavky nezměří, že cacheující prostředník neotráví sdílenou mezipaměť.
- Zásada „agent nikdy nevidí víc než host" implementovaná jako pravidlo, nikoli jako jednotlivé výjimky — nastavení viditelnosti obchodu platí vůči agentům stejně jako vůči anonymnímu návštěvníkovi.
- Ceny počítané v kontextu hosta s výslovným určením měny a země, takže cache neuloží cenu jednoho zákazníka a nepředá ji všem ostatním.
- Plná podpora multistore a vícejazyčnosti: nastavení, soubory llms, cache i čítač jsou vedeny odděleně pro každý obchod a každý jazyk.
- Žádné externí závislosti — bez Composeru, bez externích knihoven, bez volání služeb třetích stran; modul neposílá data vašeho obchodu nikam mimo odpověď na požadavek.
- Statistiky bez identifikátorů návštěvníků: ukládají se denní agregace, obchod, kanál, rodina klienta a typ, identifikátor a jazyk dokumentu s časem posledního požadavku, bez IP adres, relací a plného User-Agent.
- Vše, co hledají validátory připravenosti pro agenty: vyjednávání obsahu na hlavní adrese obchodu, hlavička Vary: Accept, čítač tokenů pod standardním názvem x-markdown-tokens a deklarace Content Signals v robots.txt — bez ručního dopisování čehokoli do souborů serveru.
- Kompatibilita od PrestaShop 1.7.1.0 do 9.x a od PHP 7.0 do 8.5, ověřená vůči skutečným stromům zdrojových kódů, nikoli jen deklarativně.
Nejdůležitější funkce modulu
- Vyjednávání obsahu na kanonických adresách obchodu: požadavek s Accept: text/markdown dostane dokument Markdown, požadavek z prohlížeče dostane nezměněné HTML.
- Hlavička Vary: Accept a značka Link: rel="alternate" na HTML stránkách zahrnutých modulem, takže prostředníci i agenti vědí, že existuje alternativní verze.
- Paralelní adresy markdown/{typ}/{id}.md pro produkty, kategorie, CMS stránky, výrobce, domovskou stránku obchodu a integrované blogové články, pod vlastním prefixem, aby nekolidovaly s jinými moduly přepisujícími adresy.
- Záložka Integrace: podpora ph_simpleblog, pdfaqspro, pdproductsfaqpro, iqitreviews a productcomments, se samostatnou volbou rozsahu publikovaného obsahu.
- Statistický panel: filtry období, kanálu a rodiny klienta, denní graf, žebříček agentů a klientů a 20 nejčastěji stahovaných dokumentů.
- Záložka Content Signals: deklarace preferencí vůči automatickým systémům, publikovaná v robots.txt — podrobnosti v samostatné sekci níže.
- Také domovská stránka obchodu odpovídá v Markdownu — dostává vlastní dokument s názvem a popisem obchodu, hlavními kategoriemi a informačními stránkami. Právě tuto adresu standardně kontrolují validátory připravenosti pro agenty (isitagentready.com, panel Agent Diagnostics v Cloudflare), takže bez ní by byl obchod i při perfektně fungujícím vyjednávání v celém katalogu stejně označen jako nepřipravený.
- Soubor llms.txt — krátký seznam nejdůležitějších sekcí obchodu: kategorií nejvyšší úrovně, informačních stránek, vybraných blogových článků a odkazu na plný index.
- Soubor llms-full.txt — kompaktní index veřejných entit, včetně blogových článků. Obsahuje názvy, odkazy a shrnutí a u produktů také dostupná data nabídky a průměr i počet hodnocení z vybraného zdroje recenzí. Po překročení nakonfigurované velikosti se automaticky dělí na části.
- Generování llms-full.txt přes cron endpoint chráněný tokenem nebo ruční přestavbou v panelu, s časovým rozpočtem a navazováním přerušené práce. Plný index se nebuilduje během běžného požadavku návštěvníka.
- Samostatný cron token pro každý obchod, porovnávaný v konstantním čase, s hotovým příkazem curl ke zkopírování v panelu.
- Cache vygenerovaného Markdownu v databázi s konfigurovatelnou dobou života a invalidací pomocí hooků při změně produktu, kombinace, akční ceny, cenového pravidla, stavu skladu, kategorie, CMS stránky a výrobce.
- Záložka Diagnostika: sedm kontrol prováděných skutečnými HTTP požadavky proti vlastnímu sondovacímu endpointu modulu, se samostatným rozlišením poruch „HTML podané agentovi" a „Markdown podaný prohlížeči".
- Informační kontrola skutečné katalogové adresy po zapnutí vyjednávání, prezentovaná samostatně a neblokující funkci.
- Náhled dokumentu v panelu pro vybraný typ a identifikátor entity, včetně čítače tokenů Markdown versus HTML a výslovného verdiktu viditelnosti entity.
- Záložka Soubory: stav souborů llms pro každý jazyk (přítomnost, velikost, datum, počet entit, počet částí), tlačítko ruční přestavby s časovým rozpočtem a cron příkaz.
- Čítač zásahů agentů: agregace den × obchod × kanál × rodina klienta, s rozdělením na kanály vyjednávání, trasa .md a llms a rodiny openai, anthropic, perplexity, google, bing, script, browser a other.
- Hlavičky odpovědí odpovídající účelu obsahu: X-Robots-Tag: noindex, nofollow na dokumentech Markdown, X-Content-Type-Options: nosniff, ETag s podporou 304 a odlišná politika Cache-Control pro kanonickou adresu a adresu .md.
- Data produktu v hlavičce dokumentu: typ, identifikátor, kanonická adresa, adresa Markdown, název, meta popis, adresa hlavního obrázku, SKU, značka, cena s DPH a bez DPH, měna, informace o dani, dostupnost, označení sady, požadavek na personalizaci, stav produktu, kategorie, jazyk a datum aktualizace.
- Běžná cena a výše i procento slevy, pokud je produkt v akci — agent neuvidí akční cenu jako běžnou.
- Tabulka variant s cenou, množstvím, dostupností a identifikátorem kombinace, takže agent může uvést konkrétní variantu, a ne ji jen popsat.
- Obsah produktových sad s množstvími a odkazy na Markdown dokumenty jednotlivých položek.
- Informace o povinných polích personalizace, s vynecháním polí patřících jiným modulům, která PrestaShop na frontendu nezobrazuje.
- Volba typů entit zpřístupněných agentům, vynucovaná jednotně ve všech kanálech: na trasách .md, v souborech llms i ve značce alternativní verze.
- Pracovní adresář modulu zabezpečený proti přímému čtení ze sítě a soubory llms obsluhované výhradně kontrolery modulu.
- Respektování režimu údržby obchodu a geolokace — obchod uzavřený pro návštěvníky je uzavřen i pro agenty.
- Panel v konvenci PD s hlavičkou modulu a šesti záložkami: Panel, Nastavení, Integrace, Diagnostika, Soubory a Content Signals. Panel je výchozí obrazovkou a nastavení doprovází vysvětlení jejich fungování.
Blog a návody — integrace s ph_simpleblog
Integrace zpřístupňuje agentům také znalosti z blogu obchodu: nákupní průvodce, návody a informační články. Každý publikovaný a pro hosta dostupný článek může mít vlastní dokument Markdown i odkaz v souborech llms.
- Dokument článku obsahuje název, úvod, obsah, autora, blogovou kategorii, datum publikace a aktualizace a adresu zdrojové stránky.
- Respektuje se aktivita příspěvku i jeho kategorie, datum publikace, přístup nepřihlášeného hosta, přiřazení k obchodu a dostupnost překladu. Soukromé články a články naplánované do budoucna jsou vynechány.
- Veřejné články se dostávají do llms-full.txt a v krátkém llms.txt se objevuje sekce blogu a návodů s názvy, odkazy a dostupnými krátkými popisy.
- V krátkém přehledu lze zobrazit od 0 do 20 článků. Vlastní seznam identifikátorů určuje pořadí; při prázdném seznamu modul vybírá nejprve zvýrazněné články a poté nejnovější. Nastavení 0 tuto sekci skryje a články ponechá v plném indexu.
- Články používají stejné přístupové kanály jako katalog: Markdown adresu a vyjednávání obsahu na zdrojové stránce, pokud jsou příslušné funkce zapnuté. Jejich dokumenty lze kontrolovat v náhledu v panelu.
FAQ produktů, kategorií a CMS stránek
Otázky a odpovědi tvoří sekci dokumentu stránky, které se týkají. Agent dostane popis nabídky nebo obsah stránky spolu s odpověďmi na související otázky, například o montáži, výběru produktu, používání nebo podmínkách služby.
- pdfaqspro dodává FAQ přiřazené k produktům, kategoriím a CMS stránkám. Každý z těchto rozsahů lze zapnout samostatně v záložce Integrace.
- Starší pdproductsfaqpro je podporován jako zdroj FAQ produktů. FAQ kategorií a CMS vyžaduje novější pdfaqspro. Pokud jsou oba moduly aktivní, přednost má novější varianta.
- Publikují se aktivní otázky ze správného obchodu a správné stránky, s ohledem na nastavení publikace a jazyková pravidla zdrojového modulu. Pokud zdroj připouští náhradní jazyk, dokument uvádí jazyk připojené odpovědi.
- Jeden dokument může obsahovat až 500 otázek a odpovědí v pořadí určeném v FAQ modulu. Prázdné otázky nebo odpovědi jsou vynechány.
- Soubory llms vedou k dokumentům produktů, kategorií a CMS s jejich FAQ sekcemi. Jednotlivé otázky nevytvářejí další položky v indexu.
Hodnocení a recenze produktů — iqitreviews a productcomments
Dokument produktu může obsahovat shrnutí hodnocení zákazníků i obsah nejnovějších veřejných recenzí. V panelu vyberete jeden zdroj: iqitreviews nebo productcomments, takže se recenze ze dvou modulů nesčítají dohromady.
- Průměr a počet hodnocení se počítají na základě všech veřejných recenzí podle pravidel vybraného modulu, s ohledem na moderaci a skrývání příspěvků.
- K dispozici jsou dva rozsahy: pouze průměr a počet hodnocení nebo shrnutí spolu s 1–20 nejnovějšími příspěvky. Limit textů neomezuje soubor hodnocení použitý pro výpočet průměru.
- Příspěvky se vybírají od nejnovějších, bez výběru podle výše hodnocení. Zachovávají svůj původní jazyk a jsou jasně označeny jako recenze zákazníků.
- Rozsah dat jednotlivé recenze zahrnuje hodnocení, datum, název a obsah. Modul nepřipojuje pole se jménem zákazníka ani identifikátorem jeho účtu.
- V llms-full.txt může produkt dostat stručnou informaci o průměru, počtu hodnocení a zdroji. Obsah recenzí zůstává v dokumentu produktu.
Záložka Integrace — rozsah a aktuálnost obsahu
Panel ukazuje, které zdrojové moduly jsou v daném obchodě aktivní. Lze samostatně zapnout blog, FAQ produktů, FAQ kategorií a FAQ CMS a vybrat zdroj i rozsah recenzí. Integrace jsou volitelné, při instalaci ve výchozím stavu vypnuté, a jejich nastavení se týká konkrétního obchodu.
Změny a odstranění článků, FAQ a recenzí se kontrolují při požadavku na dokument Markdown, který dorazí do obchodu, i tehdy, když už je dokument v cache modulu. Soubory llms.txt a llms-full.txt se obnovují při přestavbě v záložce Soubory nebo přes CRON. Kopie uchovávané CDN a jinými externími cache podléhají nastavené době platnosti odpovědi.
Panel — statistiky agentů a nejčastěji stahovaného obsahu
Panel umožňuje vidět, které části obchodu jsou stahovány ve formátech zpřístupněných modulem. Zahrnuje katalogové dokumenty, blogové články i soubory llms.
- Volba posledních 7, 14 nebo 30 dní a filtrování podle přístupového kanálu a rodiny agenta nebo klienta.
- Shrnutí počtu požadavků, podílu rozpoznaných botů a AI agentů, počtu různých dokumentů a požadavků zaznamenaných s informací o obsahu.
- Denní graf s tabulkou hodnot, žebříček rodin agentů a klientů a porovnání kanálů: vyjednávání obsahu, Markdown adresy a soubory llms.
- Žebříček 20 nejčastěji stahovaných dokumentů s názvem, typem, jazykem, počtem požadavků, podílem na obsahovém provozu a časem posledního požadavku. Blogové články se zobrazují s vlastním názvem a odkazem.
- Statistiky pro vybraný obchod v multistore. Podrobnosti obsahu se sbírají od nasazení rozšířeného čítače; dřívější součty požadavků zůstávají dostupné.
Čítač měří požadavky obsloužené modulem, včetně podmíněných odpovědí 304, nikoli unikátní návštěvníky. Rozpoznání rodiny klienta vychází z deklarovaného User-Agent. Požadavky obsloužené zcela externí cache se do statistik modulu nedostanou.
Content Signals — deklarace, co automatickým systémům povolujete
Obchod, jehož obsah čtou AI agenti, dříve či později narazí na otázku, s čím vlastně souhlasí. Je dovoleno z něj vytvořit index vyhledávače? Je dovoleno použít popis produktu k odpovědi zákazníkovi na otázku? Je dovoleno na tomto katalogu trénovat model? Content Signals je standard, který umožňuje odpovědět na tyto tři otázky samostatně a zveřejnit odpověď tam, kam se automaty stejně dívají — v souboru robots.txt. Modul na to dává samostatnou záložku, tři jednoduché volby a náhled toho, co přesně se do souboru zapíše. Specifikace: contentsignals.org.
- Indexování ve vyhledávačích (search) — vytváření indexu a zobrazování odkazů s krátkými úryvky. Nezahrnuje shrnutí generovaná AI.
- Odpovídání na otázky na základě vašeho obsahu (ai-input) — předání obsahu modelu ve chvíli, kdy někdo položí otázku, aby se odpověď opírala o něj. Přesně tak fungují nákupní asistenti.
- Trénování AI modelů (ai-train) — využití obsahu k trénování nebo dolaďování modelů.
- Každá ze tří kategorií má nezávislé nastavení povoleno nebo zakázáno, popsané v panelu jednou větou česky — ne jen technickým štítkem, který prodejce nemusí znát.
- Deklarace se zapisuje do robots.txt v bloku vymezeném značkami s názvem modulu. Nic mimo tyto značky se neparsuje, nepřepisuje ani nepřesouvá — vaše vlastní pravidla i pravidla jiných modulů zůstávají nedotčená do posledního bajtu.
- PrestaShop přepisuje robots.txt od nuly při každém kliknutí na „Generovat soubor robots.txt" v SEO a URL adresách. Modul pak svůj blok automaticky zapíše zpět a záložka stejně ukazuje, zda je soubor aktuální, a umožňuje jej znovu uložit jedním tlačítkem.
- Panel před uložením ukazuje, zda je soubor vůbec zapisovatelný — místo aby hlásil úspěch a nechal vás s deklarací, která v souboru není.
- Funkce se instaluje vypnutá: zapisování čehokoli do souboru sdíleného celým obchodem je rozhodnutí prodejce, ne modulu. Odinstalace modulu blok opět odstraní.
- V instalaci multistore panel výslovně upozorňuje, že PrestaShop drží jeden soubor robots.txt pro všechny obchody, takže uložená deklarace se vztahuje na každý z nich.
- Jde o deklaraci preferencí, nikoli o řízení přístupu: nikoho neblokuje a její respektování je rozhodnutím druhé strany. Modul to říká přímo, místo aby naznačoval ochranu, kterou tento mechanismus neposkytuje.
Obchodní využití
- Pro obchody PrestaShop, které chtějí být správně čteny nákupními asistenty a AI agenty, místo aby spoléhaly na to, že si model HTML stránku sám odšumí.
- Pro prodejce, kteří chtějí mít pod kontrolou, co přesně se k agentům dostane — rozsah typů entit, viditelnost cen a množství i způsob publikace.
- Pro obchody s rozsáhlým katalogem, kde se rozdíl mezi plnou HTML stránkou a dokumentem Markdown promítá do reálného rozdílu nákladů na straně dotazujícího.
- Pro obchody provozující blog a FAQ databázi, které chtějí agentům zpřístupnit rady, odpovědi na otázky a recenze zákazníků spolu s produktovou nabídkou.
- Pro multistore nasazení, kde každý obchod vyžaduje vlastní nastavení, vlastní soubory llms a vlastní cron token.
- Pro firmy, které chtějí rozhodnutí o dalších investicích do tohoto kanálu opřít o data — čítač zásahů ukazuje, zda a kudy se agenti skutečně ptají.
- Pro obchody běžící za CDN nebo reverse proxy, kde by samostatné zapnutí vyjednávání obsahu bez ověření hrozilo podáním nesprávné verze stránky běžným zákazníkům.
Co modul nedělá
- Není to SEO modul a nezlepšuje pozici obchodu ve výsledcích vyhledávání Google — dokumenty Markdown jsou výslovně označeny jako neindexované.
- Zachovává vzhled a obsah HTML stránky, kterou vidí zákazníci, a přidává informaci o alternativní verzi Markdown v HTTP hlavičkách a značce odkazu.
- Neposílá data obchodu do žádné externí služby a nevyžaduje účet ani API klíč.
- Nevynucuje Content Signals a ani to dělat nemůže: deklarace v robots.txt je vyjádřením preferencí, nikoli řízením přístupu — nikoho neblokuje a její respektování zůstává rozhodnutím druhé strany. Modul neupravuje ostatní pravidla v tomto souboru.
- Neprovádí automatické překlady. Názvy polí dokumentu zůstávají pevné a anglické, obsah stránek a článků využívá dostupné překlady, FAQ respektuje jazyková pravidla zdrojového modulu a recenze zachovávají jazyk vyjádření zákazníka.
Kompatibilita
- PrestaShop: 1.7.1.0 - 9.x
- PHP: 7.0 - 8.5
- Bez Composeru a bez externích knihoven
- Multistore: ano, nastavení a soubory vedené odděleně pro každý obchod
- Vícejazyčnost: ano, dokumenty a soubory llms pro každý aktivní jazyk