- dodano obsługę Content Signals
- dodano obsługę ph_simpleblog
- dodano obsługę pdfaqpro
- dodano obsługę productcomments
- dodano obsługę iqitrewievs
Merkmale und Vorteile des Moduls
- Markdown wird aus PrestaShop-Daten und unterstützten Inhaltsmodulen aufgebaut, nicht durch die Konvertierung der gerenderten Seite — das Dokument enthält weder Menü, Footer, Formulare noch den Code anderer Module.
- Radikal geringere Token-Kosten auf Agentenseite: Die Header x-markdown-tokens und X-Markdown-Tokens-Estimate geben in jeder Antwort die geschätzte Dokumentgröße an, und das Panel zeigt einen Vergleich von Markdown gegenüber HTML für die angegebene Entität.
- Zwei unabhängige Auslieferungskanäle — Inhaltsaushandlung unter der kanonischen Adresse sowie separate .md-Adressen — sodass der Agent den Inhalt erreicht, unabhängig davon, ob er den Header Accept sendet.
- Diagnostische Sicherheitsprüfung vor dem Aktivieren der Aushandlung: Das Modul erlaubt das Einschalten der Funktion erst, nachdem es mit echten HTTP-Anfragen gemessen hat, dass ein zwischengeschalteter Cache die gemeinsame Zwischenspeicherung nicht vergiftet.
- Die Regel „der Agent sieht nie mehr als ein Gast“ ist als Prinzip umgesetzt, nicht als einzelne Ausnahmen — die Sichtbarkeitseinstellungen des Shops gelten gegenüber Agenten genauso wie gegenüber anonymen Besuchern.
- Preise werden im Gastkontext berechnet, mit expliziter Auflösung von Währung und Land, sodass der Cache nicht den Preis eines Kunden speichert und ihn allen anderen ausliefert.
- Volle Unterstützung für Multistore und Mehrsprachigkeit: Einstellungen, llms-Dateien, Cache und Zähler werden für jeden Shop und jede Sprache getrennt geführt.
- Keine externen Abhängigkeiten — kein Composer, keine externen Bibliotheken, keine Aufrufe an Drittanbieter-Dienste; das Modul sendet keine Daten Ihres Shops irgendwohin außer in der Antwort auf die Anfrage.
- Statistiken ohne Besucherkennungen: Gespeichert werden Tagesaggregate, Shop, Kanal, Client-Familie sowie Typ, Kennung und Sprache des Dokuments mit dem Zeitpunkt der letzten Anfrage, ohne IP-Adressen, Sitzungen und vollständigen User-Agent.
- Alles, wonach Validatoren für Agentenbereitschaft suchen: Inhaltsaushandlung auf der Hauptadresse des Shops, Header Vary: Accept, Token-Zähler unter dem Standardnamen x-markdown-tokens sowie die Deklaration Content Signals in robots.txt — ohne irgendetwas manuell in Serverdateien einzutragen.
- Kompatibilität von PrestaShop 1.7.1.0 bis 9.x und von PHP 7.0 bis 8.5, anhand realer Quellbäume verifiziert und nicht nur deklarativ.
Wichtigste Funktionen des Moduls
- Inhaltsaushandlung auf kanonischen Shop-Adressen: Eine Anfrage mit Accept: text/markdown erhält ein Markdown-Dokument, eine Browser-Anfrage erhält unverändertes HTML.
- Header Vary: Accept sowie Kennzeichnung Link: rel="alternate" auf HTML-Seiten, die vom Modul abgedeckt werden, damit Vermittler und Agenten wissen, dass eine alternative Version existiert.
- Parallele Adressen markdown/{typ}/{id}.md für Produkte, Kategorien, CMS-Seiten, Hersteller, die Startseite des Shops und integrierte Blogartikel, unter eigenem Präfix, damit sie nicht mit anderen Modulen kollidieren, die Adressen umschreiben.
- Registerkarte Integrationen: Unterstützung für ph_simpleblog, pdfaqspro, pdproductsfaqpro, iqitreviews und productcomments, mit separater Auswahl des Umfangs der veröffentlichten Inhalte.
- Statistik-Dashboard: Filter nach Zeitraum, Kanal und Client-Familie, Tagesdiagramm, Ranking von Agenten und Clients sowie die 20 am häufigsten abgerufenen Dokumente.
- Registerkarte Content Signals: Deklaration von Präferenzen gegenüber automatischen Systemen, veröffentlicht in robots.txt — Details in einem separaten Abschnitt weiter unten.
- Auch die Startseite des Shops antwortet in Markdown — sie erhält ein eigenes Dokument mit Shop-Name und -Beschreibung, Hauptkategorien und Informationsseiten. Genau diese Adresse prüfen Validatoren für Agentenbereitschaft standardmäßig (isitagentready.com, Agent Diagnostics Panel in Cloudflare), sodass ein Shop ohne sie trotz perfekt funktionierender Aushandlung im gesamten Katalog dennoch als nicht vorbereitet markiert wurde.
- Datei llms.txt — ein kurzes Verzeichnis der wichtigsten Shop-Bereiche: Kategorien der obersten Ebene, Informationsseiten, ausgewählte Blogartikel und ein Verweis auf den vollständigen Index.
- Datei llms-full.txt — ein kompakter Index öffentlicher Entitäten, einschließlich Blogartikeln. Enthält Titel, Verweise und Zusammenfassungen sowie bei Produkten zusätzlich verfügbare Angebotsdaten sowie Durchschnitt und Anzahl der Bewertungen aus der gewählten Bewertungsquelle. Wird nach Überschreiten der konfigurierten Größe automatisch in Teile aufgeteilt.
- Erzeugung von llms-full.txt über einen token-geschützten Cron-Endpunkt oder durch manuellen Neuaufbau im Panel, mit Zeitbudget und Wiederaufnahme unterbrochener Arbeit. Der vollständige Index wird nicht während einer normalen Besucheranfrage aufgebaut.
- Separates Cron-Token für jeden Shop, mit konstanter Laufzeit verglichen, mit einem im Panel kopierfertigen curl-Befehl.
- Cache des erzeugten Markdown in der Datenbank mit konfigurierbarer Lebensdauer sowie Invalidierung per Hooks bei Änderungen an Produkt, Kombination, Aktionspreis, Preisregel, Lagerbestand, Kategorie, CMS-Seite und Hersteller.
- Registerkarte Diagnose: sieben Prüfungen, die mit echten HTTP-Anfragen gegen den eigenen Prüfpunkt des Moduls ausgeführt werden, mit separater Unterscheidung der Fehler „HTML an den Agenten geliefert“ und „Markdown an den Browser geliefert“.
- Informative Prüfung der echten Katalogadresse nach dem Aktivieren der Aushandlung, separat dargestellt und ohne Sperrwirkung für die Funktion.
- Dokumentvorschau im Panel für den angegebenen Entitätstyp und die angegebene Entitätskennung, zusammen mit dem Token-Zähler Markdown gegenüber HTML und einem expliziten Sichtbarkeitsurteil der Entität.
- Registerkarte Dateien: Status der llms-Dateien für jede Sprache (Vorhandensein, Größe, Datum, Anzahl der Entitäten, Anzahl der Teile), Schaltfläche für manuellen Neuaufbau mit Zeitbudget und Cron-Befehl.
- Zähler für Agentenaufrufe: Aggregat Tag × Shop × Kanal × Client-Familie, mit Aufteilung nach den Kanälen Aushandlung, .md-Route und llms sowie den Familien openai, anthropic, perplexity, google, bing, script, browser und other.
- Antwort-Header passend zum Verwendungszweck des Inhalts: X-Robots-Tag: noindex, nofollow auf Markdown-Dokumenten, X-Content-Type-Options: nosniff, ETag mit Unterstützung für 304 sowie differenzierte Cache-Control-Richtlinie für die kanonische Adresse und die .md-Adresse.
- Produktdaten im Dokumentkopf: Typ, Kennung, kanonische Adresse, Markdown-Adresse, Titel, Meta-Beschreibung, Adresse des Hauptbildes, SKU, Marke, Bruttopreis und Nettopreis, Währung, Steuerinformation, Verfügbarkeit, Kennzeichnung als Set, Personalisierungspflicht, Produktzustand, Kategorien, Sprache und Aktualisierungsdatum.
- Regulärer Preis sowie Höhe und Prozentsatz des Rabatts, wenn das Produkt von einer Aktion betroffen ist — der Agent sieht den Aktionspreis nicht als normalen Preis.
- Variantentabelle mit Preis, Menge, Verfügbarkeit und Kennung der Kombination, sodass der Agent eine konkrete Variante angeben und nicht nur beschreiben kann.
- Inhalt von Produktsets mit Mengen und Verweisen auf die Markdown-Dokumente der einzelnen Positionen.
- Information über erforderliche Personalisierungsfelder, unter Auslassung von Feldern anderer Module, die PrestaShop im Frontend nicht anzeigt.
- Auswahl der Entitätstypen, die Agenten bereitgestellt werden, einheitlich durchgesetzt in allen Kanälen: auf .md-Routen, in llms-Dateien und in der Kennzeichnung der alternativen Version.
- Arbeitsverzeichnis des Moduls gegen direktes Auslesen aus dem Netz geschützt, und llms-Dateien werden ausschließlich über die Controller des Moduls ausgeliefert.
- Beachtung des Wartungsmodus und der Geolokalisierung des Shops — ein für Besucher geschlossener Shop ist auch für Agenten geschlossen.
- Panel im PD-Stil mit Modul-Header und sechs Registerkarten: Dashboard, Einstellungen, Integrationen, Diagnose, Dateien und Content Signals. Das Dashboard ist der Startbildschirm, und die Einstellungen werden von Erläuterungen zu ihrer Funktionsweise begleitet.
Blog und Anleitungen — Integration mit ph_simpleblog
Die Integration stellt Agenten auch Wissen aus dem Blog des Shops bereit: Kaufberatungen, Anleitungen und Informationsartikel. Jeder veröffentlichte und für Gäste zugängliche Artikel kann ein eigenes Markdown-Dokument sowie einen Verweis in den llms-Dateien haben.
- Das Artikeldokument enthält Titel, Einleitung, Inhalt, Autor, Blogkategorie, Veröffentlichungs- und Aktualisierungsdatum sowie die Adresse der Quellseite.
- Berücksichtigt werden die Aktivität des Eintrags und seiner Kategorie, das Veröffentlichungsdatum, der Zugriff für nicht eingeloggte Gäste, die Zuordnung zum Shop und die Verfügbarkeit der Übersetzung. Private und für die Zukunft geplante Artikel werden ausgelassen.
- Öffentliche Artikel gelangen in llms-full.txt, und in der kurzen llms.txt erscheint ein Bereich für Blog und Anleitungen mit Titeln, Verweisen und verfügbaren Kurzbeschreibungen.
- In der kurzen Übersicht können 0 bis 20 Artikel angezeigt werden. Eine eigene Liste von Kennungen legt die Reihenfolge fest; bei leerer Liste wählt das Modul zuerst hervorgehobene und anschließend die neuesten Artikel. Die Einstellung 0 blendet diesen Bereich aus, behält die Artikel aber im vollständigen Index.
- Artikel nutzen dieselben Zugriffskanäle wie der Katalog: die Markdown-Adresse sowie die Inhaltsaushandlung auf der Quellseite, wenn die entsprechenden Funktionen aktiviert sind. Ihre Dokumente können in der Vorschau im Panel geprüft werden.
FAQ für Produkte, Kategorien und CMS-Seiten
Fragen und Antworten bilden einen Abschnitt des Dokuments der jeweiligen Seite. Der Agent erhält die Angebotsbeschreibung oder den Seiteninhalt zusammen mit den Antworten auf zugehörige Fragen, zum Beispiel zu Montage, Produktauswahl, Nutzung oder Leistungsbedingungen.
- pdfaqspro liefert FAQ, die Produkten, Kategorien und CMS-Seiten zugeordnet sind. Jeder dieser Bereiche kann in der Registerkarte Integrationen separat aktiviert werden.
- Das ältere pdproductsfaqpro wird als Quelle für Produkt-FAQ unterstützt. FAQ für Kategorien und CMS erfordern das neuere pdfaqspro. Wenn beide Module aktiv sind, hat die neuere Variante Vorrang.
- Veröffentlicht werden aktive Fragen aus dem richtigen Shop und von der richtigen Seite, unter Berücksichtigung der Veröffentlichungseinstellungen und Sprachregeln des Quellmoduls. Wenn die Quelle eine Ersatzsprache zulässt, weist das Dokument auf die Sprache der beigefügten Antwort hin.
- Ein Dokument kann bis zu 500 Fragen und Antworten enthalten, in der im FAQ-Modul festgelegten Reihenfolge. Leere Fragen oder Antworten werden ausgelassen.
- Die llms-Dateien führen zu Produkt-, Kategorie- und CMS-Dokumenten mit ihren FAQ-Bereichen. Einzelne Fragen erzeugen keine zusätzlichen Einträge im Index.
Produktbewertungen und Rezensionen — iqitreviews und productcomments
Das Produktdokument kann eine Zusammenfassung der Kundenbewertungen sowie den Inhalt der neuesten öffentlichen Rezensionen enthalten. Im Panel wählen Sie eine Quelle: iqitreviews oder productcomments, sodass Rezensionen aus zwei Modulen nicht miteinander zusammengezählt werden.
- Durchschnitt und Anzahl der Bewertungen werden auf Grundlage aller öffentlichen Rezensionen nach den Regeln des gewählten Moduls berechnet, unter Berücksichtigung von Moderation und Ausblendung von Einträgen.
- Es stehen zwei Umfänge zur Verfügung: nur Durchschnitt und Anzahl der Bewertungen oder die Zusammenfassung zusammen mit 1–20 neuesten Aussagen. Das Textlimit begrenzt nicht die Menge der Bewertungen, die zur Berechnung des Durchschnitts verwendet wird.
- Die Aussagen werden von den neuesten an ausgewählt, ohne Selektion nach Höhe der Bewertung. Sie behalten ihre Originalsprache und sind klar als Kundenmeinungen gekennzeichnet.
- Der Datenumfang einer einzelnen Rezension umfasst Bewertung, Datum, Titel und Inhalt. Das Modul fügt keine Felder mit dem Kundennamen oder der Kennung seines Kontos hinzu.
- In llms-full.txt kann das Produkt eine knappe Information über Durchschnitt, Anzahl der Bewertungen und Quelle erhalten. Die Inhalte der Aussagen bleiben im Produktdokument.
Registerkarte Integrationen — Umfang und Aktualität der Inhalte
Das Panel zeigt, welche Quellmodule im ausgewählten Shop aktiv sind. Blog, Produkt-FAQ, Kategorie-FAQ und CMS-FAQ können separat aktiviert werden, außerdem lassen sich Quelle und Umfang der Rezensionen auswählen. Integrationen sind optional, bei der Installation standardmäßig deaktiviert, und ihre Einstellungen gelten für den jeweiligen Shop.
Änderungen und Löschungen von Artikeln, FAQ und Rezensionen werden bei einer Markdown-Dokumentanfrage geprüft, die den Shop erreicht, auch dann, wenn sich das Dokument bereits im Cache des Moduls befindet. Die Dateien llms.txt und llms-full.txt werden beim Neuaufbau in der Registerkarte Dateien oder per CRON aktualisiert. Kopien, die von CDN und anderen externen Caches gespeichert werden, unterliegen der eingestellten Gültigkeitsdauer der Antwort.
Dashboard — Statistiken zu Agenten und am häufigsten abgerufenen Inhalten
Das Dashboard zeigt, welche Teile des Shops in den vom Modul bereitgestellten Formaten abgerufen werden. Es umfasst Katalogdokumente, Blogartikel und llms-Dateien.
- Auswahl der letzten 7, 14 oder 30 Tage sowie Filterung nach Zugriffskanal und Agenten- oder Client-Familie.
- Zusammenfassung der Anzahl der Anfragen, des Anteils erkannter Bots und KI-Agenten, der Anzahl verschiedener Dokumente sowie der mit Inhaltsinformation registrierten Anfragen.
- Tagesdiagramm mit Wertetabelle, Ranking der Agenten- und Client-Familien sowie Vergleich der Kanäle: Inhaltsaushandlung, Markdown-Adressen und llms-Dateien.
- Ranking der 20 am häufigsten abgerufenen Dokumente mit Titel, Typ, Sprache, Anzahl der Anfragen, Anteil am Inhaltsverkehr und Zeitpunkt der letzten Anfrage. Blogartikel erscheinen mit eigenem Titel und Verweis.
- Statistiken für den ausgewählten Shop im Multistore. Inhaltsdetails werden seit der Einführung des erweiterten Zählers erfasst; frühere Summen der Anfragen bleiben verfügbar.
Der Zähler misst die vom Modul bedienten Anfragen, einschließlich bedingter Antworten 304, und nicht eindeutige Besucher. Die Erkennung der Client-Familie basiert auf dem deklarierten User-Agent. Anfragen, die vollständig von einem externen Cache bedient werden, gelangen nicht in die Statistiken des Moduls.
Content Signals — Deklaration, was Sie automatischen Systemen erlauben
Ein Shop, dessen Inhalte von KI-Agenten gelesen werden, steht früher oder später vor der Frage, worin er eigentlich einwilligt. Darf daraus ein Suchindex aufgebaut werden? Darf eine Produktbeschreibung verwendet werden, um einem Kunden eine Frage zu beantworten? Darf auf diesem Katalog ein Modell trainiert werden? Content Signals ist ein Standard, der es erlaubt, diese drei Fragen getrennt zu beantworten und die Antwort dort zu veröffentlichen, wo Automatisierungen ohnehin nachsehen — in der Datei robots.txt. Das Modul bietet dafür eine eigene Registerkarte, drei einfache Auswahlmöglichkeiten und eine Vorschau dessen, was genau in die Datei geschrieben wird. Spezifikation: contentsignals.org.
- Indexierung in Suchmaschinen (search) — Aufbau eines Indexes und Anzeige von Links mit kurzen Ausschnitten. Umfasst keine von KI erzeugten Zusammenfassungen.
- Beantwortung von Fragen auf Grundlage Ihrer Inhalte (ai-input) — Übergabe des Inhalts an ein Modell in dem Moment, in dem jemand eine Frage stellt, damit die Antwort darauf basiert. Genau so funktionieren Einkaufsassistenten.
- Training von KI-Modellen (ai-train) — Nutzung der Inhalte zum Trainieren oder Feinabstimmen von Modellen.
- Jede der drei Kategorien hat eine unabhängige Einstellung erlaubt oder nicht erlaubt, im Panel mit einem Satz auf Polnisch beschrieben — nicht nur mit einem technischen Label, das ein Händler nicht kennen muss.
- Die Deklaration wird in robots.txt in einem Block eingefügt, der durch Marker mit dem Modulnamen begrenzt ist. Nichts außerhalb dieser Marker wird geparst, umgeschrieben oder umgestellt — Ihre eigenen Regeln und die Regeln anderer Module bleiben bytegenau unberührt.
- PrestaShop überschreibt robots.txt bei jedem Klick auf „Datei robots.txt generieren“ in SEO und URL-Adressen vollständig. Das Modul schreibt dann seinen Block automatisch wieder hinein, und die Registerkarte zeigt dennoch an, ob die Datei aktuell ist, und erlaubt es, sie mit einer Schaltfläche erneut zu speichern.
- Das Panel zeigt vor dem Speichern an, ob die Datei überhaupt beschreibbar ist — statt Erfolg zu melden und Sie mit einer Deklaration zurückzulassen, die in der Datei nicht vorhanden ist.
- Die Funktion wird deaktiviert installiert: Irgendetwas in eine mit dem gesamten Shop geteilte Datei zu schreiben, ist eine Entscheidung des Händlers, nicht des Moduls. Bei der Deinstallation des Moduls wird der Block wieder entfernt.
- In einer Multistore-Installation warnt das Panel ausdrücklich davor, dass PrestaShop eine einzige Datei robots.txt für alle Shops verwendet, sodass die gespeicherte Deklaration für jeden von ihnen gilt.
- Es handelt sich um eine Präferenzdeklaration, nicht um Zugriffskontrolle: Sie blockiert niemanden, und ihre Beachtung ist die Entscheidung der Gegenseite. Das Modul sagt das ausdrücklich, statt einen Schutz zu suggerieren, den dieser Mechanismus nicht bietet.
Geschäftlicher Einsatz
- Für PrestaShop-Shops, die von Einkaufsassistenten und KI-Agenten korrekt gelesen werden sollen, statt darauf zu hoffen, dass das Modell die HTML-Seite selbstständig entrauscht.
- Für Händler, die kontrollieren möchten, was genau an Agenten übermittelt wird — der Umfang der Entitätstypen, die Sichtbarkeit von Preisen und Mengen sowie die Art der Veröffentlichung.
- Für Shops mit umfangreichem Katalog, in denen sich der Unterschied zwischen einer vollständigen HTML-Seite und einem Markdown-Dokument in einen realen Kostenunterschied auf Seiten des Abfragenden übersetzt.
- Für Shops mit Blog und FAQ-Datenbank, die Agenten Ratgeber, Antworten auf Fragen und Kundenmeinungen zusammen mit dem Produktangebot bereitstellen möchten.
- Für Multistore-Implementierungen, bei denen jeder Shop eigene Einstellungen, eigene llms-Dateien und ein eigenes Cron-Token benötigt.
- Für Unternehmen, die die Entscheidung über weitere Investitionen in diesen Kanal auf Daten stützen möchten — der Aufrufzähler zeigt, ob und auf welchen Wegen Agenten tatsächlich anfragen.
- Für Shops hinter CDN oder Reverse Proxy, bei denen das eigenständige Aktivieren der Inhaltsaushandlung ohne Verifizierung dazu führen könnte, dass normalen Kunden die falsche Seitenversion ausgeliefert wird.
Was das Modul nicht macht
- Es ist kein SEO-Modul und verbessert nicht die Position des Shops in den Google-Suchergebnissen — Markdown-Dokumente sind ausdrücklich als nicht indexierbar gekennzeichnet.
- Es bewahrt das Erscheinungsbild und den Inhalt der HTML-Seite, die Kunden sehen, und ergänzt nur die Information über eine alternative Markdown-Version in den HTTP-Headern und im Link-Tag.
- Es sendet keine Shop-Daten an irgendeinen externen Dienst und erfordert weder ein Konto noch einen API-Schlüssel.
- Es setzt Content Signals nicht durch und kann das auch nicht: Die Deklaration in robots.txt ist ein Ausdruck von Präferenzen und keine Zugriffskontrolle — sie blockiert niemanden, und ihre Beachtung bleibt die Entscheidung der Gegenseite. Das Modul verändert die übrigen Regeln in dieser Datei nicht.
- Es führt keine automatischen Übersetzungen aus. Die Feldnamen des Dokuments bleiben fest und englisch, die Inhalte von Seiten und Artikeln nutzen verfügbare Übersetzungen, FAQ respektieren die Sprachregeln des Quellmoduls, und Rezensionen behalten die Sprache der Kundenaussage bei.
Kompatibilität
- PrestaShop: 1.7.1.0 - 9.x
- PHP: 7.0 - 8.5
- Ohne Composer und ohne externe Bibliotheken
- Multistore: ja, Einstellungen und Dateien werden für jeden Shop getrennt geführt
- Mehrsprachigkeit: ja, Dokumente und llms-Dateien für jede aktive Sprache