- dodano obsługę Content Signals
- dodano obsługę ph_simpleblog
- dodano obsługę pdfaqpro
- dodano obsługę productcomments
- dodano obsługę iqitrewievs
Особливості та переваги модуля
- Markdown будується з даних PrestaShop і підтримуваних модулів контенту, а не шляхом конвертації відрендереної сторінки — документ не містить меню, футера, форм чи коду інших модулів.
- Радикально менша вартість токенів на боці агента: заголовки x-markdown-tokens та X-Markdown-Tokens-Estimate у кожній відповіді вказують орієнтовний розмір документа, а панель показує порівняння Markdown проти HTML для вказаної сутності.
- Два незалежні канали доставки — узгодження вмісту на канонічній адресі та окремі адреси .md — тож агент отримає контент незалежно від того, чи надсилає заголовок Accept.
- Діагностичний запобіжник перед увімкненням узгодження: модуль не дозволяє запустити функцію, доки не перевірить реальними HTTP-запитами, що кешувальний посередник не отруїть спільний кеш.
- Принцип «агент ніколи не бачить більше, ніж гість» реалізований як правило, а не як окремі винятки — налаштування видимості магазину діють щодо агентів так само, як і щодо анонімного відвідувача.
- Ціни обчислюються в контексті гостя, з явним визначенням валюти та країни, тож кеш не збереже ціну одного клієнта і не покаже її всім іншим.
- Повна підтримка multistore і багатомовності: налаштування, файли llms, кеш і лічильник ведуться окремо для кожного магазину та кожної мови.
- Жодних зовнішніх залежностей — без Composer, без зовнішніх бібліотек, без звернень до сторонніх сервісів; модуль не надсилає дані вашого магазину нікуди, окрім відповіді на запит.
- Статистика без ідентифікаторів відвідувачів: зберігаються добові агрегати, магазин, канал, сімейство клієнта, а також тип, ідентифікатор і мова документа з часом останнього запиту, без IP-адрес, сесій і повного User-Agent.
- Повний набір того, що шукають валідатори готовності до агентів: узгодження вмісту на головній адресі магазину, заголовок Vary: Accept, лічильник токенів під стандартною назвою x-markdown-tokens та декларація Content Signals у robots.txt — без ручного дописування будь-чого у файли сервера.
- Сумісність від PrestaShop 1.7.1.0 до 9.x і від PHP 7.0 до 8.5, перевірена на реальних деревах вихідного коду, а не декларативно.
Найважливіші функціональні можливості модуля
- Узгодження вмісту на канонічних адресах магазину: запит із Accept: text/markdown отримує документ Markdown, запит браузера отримує незмінений HTML.
- Заголовок Vary: Accept та мітка Link: rel="alternate" на HTML-сторінках, охоплених модулем, завдяки чому посередники й агенти знають, що існує альтернативна версія.
- Паралельні адреси markdown/{typ}/{id}.md для товарів, категорій, сторінок CMS, виробників, головної сторінки магазину та інтегрованих статей блогу, під власним префіксом, щоб не конфліктувати з іншими модулями, які переписують адреси.
- Вкладка Інтеграції: підтримка ph_simpleblog, pdfaqspro, pdproductsfaqpro, iqitreviews і productcomments, з окремим вибором обсягу опублікованого контенту.
- Панель статистики: фільтри періоду, каналу та сімейства клієнта, щоденний графік, рейтинг агентів і клієнтів та 20 документів, що завантажуються найчастіше.
- Вкладка Content Signals: декларація уподобань щодо автоматичних систем, що публікується в robots.txt — подробиці в окремому розділі нижче.
- Головна сторінка магазину теж відповідає Markdown — вона отримує власний документ із назвою та описом магазину, основними категоріями й інформаційними сторінками. Саме цю адресу за замовчуванням перевіряють валідатори готовності до агентів (isitagentready.com, панель Agent Diagnostics у Cloudflare), тож без неї магазин навіть з ідеально працюючим узгодженням по всьому каталогу все одно позначався як непідготовлений.
- Файл llms.txt — короткий перелік найважливіших розділів магазину: категорій верхнього рівня, інформаційних сторінок, вибраних статей блогу та посилання на повний індекс.
- Файл llms-full.txt — компактний індекс публічних сутностей, зокрема й статей блогу. Містить заголовки, посилання та стислий опис, а для товарів також доступні дані пропозиції та середню оцінку й кількість відгуків із вибраного джерела відгуків. Автоматично ділиться на частини після перевищення налаштованого розміру.
- Генерація llms-full.txt через cron endpoint, захищений токеном, або ручне перебудування в панелі, з бюджетом часу та відновленням перерваної роботи. Повний індекс не будується під час звичайного запиту відвідувача.
- Окремий токен cron для кожного магазину, що порівнюється за сталий час, із готовою командою curl для копіювання в панелі.
- Кеш згенерованого Markdown у базі даних із налаштовуваним часом життя та інвалідацією через hook-и при зміні товару, комбінації, акційної ціни, цінового правила, складського стану, категорії, сторінки CMS і виробника.
- Вкладка Діагностика: сім перевірок, що виконуються реальними HTTP-запитами до власної точки зондування модуля, з окремим розрізненням збоїв «HTML подано агенту» і «Markdown подано браузеру».
- Інформаційна перевірка реальної адреси каталогу після ввімкнення узгодження, що показується окремо і не блокує функцію.
- Попередній перегляд документа в панелі для вказаного типу та ідентифікатора сутності, разом із лічильником токенів Markdown проти HTML і явним вердиктом видимості сутності.
- Вкладка Файли: стан файлів llms для кожної мови (наявність, розмір, дата, кількість сутностей, кількість частин), кнопка ручного перебудування з бюджетом часу та команда cron.
- Лічильник звернень агентів: агрегат доба × магазин × канал × сімейство клієнта, з поділом на канали узгодження, маршрут .md і llms та сімейства openai, anthropic, perplexity, google, bing, script, browser і other.
- Заголовки відповіді, що відповідають призначенню контенту: X-Robots-Tag: noindex, nofollow на документах Markdown, X-Content-Type-Options: nosniff, ETag з підтримкою 304 та диференційована політика Cache-Control для канонічної адреси й адреси .md.
- Дані товару в заголовку документа: тип, ідентифікатор, канонічна адреса, адреса Markdown, заголовок, meta description, адреса головного зображення, SKU, бренд, ціна брутто і нетто, валюта, інформація про податок, наявність, позначення комплекту, вимога персоналізації, стан товару, категорії, мова та дата оновлення.
- Звичайна ціна, а також розмір і відсоток знижки, якщо товар бере участь в акції — агент не побачить акційну ціну як звичайну.
- Таблиця варіантів із ціною, кількістю, наявністю та ідентифікатором комбінації, завдяки чому агент може вказати конкретний варіант, а не лише описати його.
- Вміст товарних комплектів із кількостями та посиланнями на документи Markdown окремих позицій.
- Інформація про обов’язкові поля персоналізації, без полів, що належать іншим модулям, які PrestaShop не показує на фронтенді.
- Вибір типів сутностей, що надаються агентам, який однаково застосовується в усіх каналах: на маршрутах .md, у файлах llms і в мітці альтернативної версії.
- Робочий каталог модуля захищений від прямого читання з мережі, а файли llms віддаються виключно через контролери модуля.
- Дотримання режиму технічного обслуговування магазину та геолокації — магазин, закритий для відвідувачів, закритий також і для агентів.
- Панель у конвенції PD із заголовком модуля та шістьма вкладками: Панель, Налаштування, Інтеграції, Діагностика, Файли і Content Signals. Панель є стартовим екраном, а налаштування супроводжуються поясненнями їхньої дії.
Блог і посібники — інтеграція з ph_simpleblog
Інтеграція надає агентам також знання з блогу магазину: посібники з покупок, інструкції та інформаційні статті. Кожна опублікована й доступна для гостя стаття може мати власний документ Markdown і посилання у файлах llms.
- Документ статті містить заголовок, вступ, вміст, автора, категорію блогу, дату публікації та оновлення, а також адресу вихідної сторінки.
- Враховуються активність запису та його категорії, дата публікації, доступ незалогіненого гостя, прив’язка до магазину та доступність перекладу. Приватні статті та статті, заплановані на майбутнє, пропускаються.
- Публічні статті потрапляють до llms-full.txt, а в короткому llms.txt з’являється розділ блогу та посібників із заголовками, посиланнями й доступними короткими описами.
- У короткому огляді можна показати від 0 до 20 статей. Власний список ідентифікаторів визначає порядок; якщо список порожній, модуль спочатку вибирає рекомендовані статті, а потім найновіші. Значення 0 приховує цей розділ, зберігаючи статті в повному індексі.
- Статті використовують ті самі канали доступу, що й каталог: адресу Markdown та узгодження вмісту на вихідній сторінці, якщо відповідні функції ввімкнені. Їхні документи можна перевіряти в попередньому перегляді в панелі.
FAQ товарів, категорій і сторінок CMS
Запитання та відповіді формують розділ документа сторінки, якої вони стосуються. Агент отримує опис пропозиції або вміст сторінки разом із відповідями на пов’язані запитання, наприклад про монтаж, підбір товару, використання чи умови послуги.
- pdfaqspro надає FAQ, прив’язані до товарів, категорій і сторінок CMS. Кожен із цих діапазонів можна ввімкнути окремо у вкладці Інтеграції.
- Старіший pdproductsfaqpro підтримується як джерело FAQ для товарів. FAQ категорій і CMS потребує новішого pdfaqspro. Якщо обидва модулі активні, пріоритет має новіший варіант.
- Публікуються активні запитання з відповідного магазину та відповідної сторінки, з урахуванням налаштувань публікації та мовних правил вихідного модуля. Якщо джерело допускає запасну мову, документ вказує мову доданої відповіді.
- Один документ може містити до 500 запитань і відповідей, у порядку, встановленому в модулі FAQ. Порожні запитання або відповіді пропускаються.
- Файли llms ведуть до документів товарів, категорій і CMS з їхніми розділами FAQ. Окремі запитання не створюють додаткових позицій в індексі.
Оцінки та відгуки про товари — iqitreviews і productcomments
Документ товару може містити підсумок оцінок клієнтів і вміст найновіших публічних відгуків. У панелі ви вибираєте одне джерело: iqitreviews або productcomments, завдяки чому відгуки з двох модулів не підсумовуються між собою.
- Середня оцінка та кількість відгуків обчислюються на основі всіх публічних відгуків за правилами вибраного модуля, з урахуванням модерації та приховування записів.
- Доступні два обсяги: лише середня оцінка та кількість відгуків або підсумок разом із 1–20 найновішими висловлюваннями. Ліміт текстів не обмежує набір оцінок, що використовується для обчислення середньої.
- Висловлювання вибираються від найновіших, без відбору за величиною оцінки. Вони зберігають свою оригінальну мову й чітко позначені як відгуки клієнтів.
- Обсяг даних окремого відгуку охоплює оцінку, дату, заголовок і вміст. Модуль не додає поля з ім’ям клієнта чи ідентифікатором його облікового запису.
- У llms-full.txt товар може отримати стислу інформацію про середню оцінку, кількість відгуків і джерело. Тексти висловлювань залишаються в документі товару.
Вкладка Інтеграції — обсяг і актуальність контенту
Панель показує, які вихідні модулі активні у вибраному магазині. Можна окремо ввімкнути блог, FAQ товарів, FAQ категорій і FAQ CMS, а також вибрати джерело та обсяг відгуків. Інтеграції є опціональними, за замовчуванням вимкнені під час встановлення, а їхні налаштування стосуються конкретного магазину.
Зміни та видалення статей, FAQ і відгуків перевіряються під час запиту документа Markdown, що надходить до магазину, також тоді, коли документ уже є в кеші модуля. Файли llms.txt і llms-full.txt оновлюються під час перебудови у вкладці Файли або через CRON. Копії, що зберігаються CDN та іншими зовнішніми кешами, підпорядковуються встановленому часу дії відповіді.
Панель — статистика агентів і контенту, що завантажується найчастіше
Панель дає змогу побачити, які частини магазину завантажуються у форматах, що надаються модулем. Вона охоплює документи каталогу, статті блогу та файли llms.
- Вибір останніх 7, 14 або 30 днів і фільтрація за каналом доступу та сімейством агента або клієнта.
- Підсумок кількості запитів, частки розпізнаних ботів і AI-агентів, кількості різних документів і запитів, зареєстрованих з інформацією про контент.
- Щоденний графік із таблицею значень, рейтинг сімейств агентів і клієнтів та порівняння каналів: узгодження вмісту, адреси Markdown і файли llms.
- Рейтинг 20 документів, що завантажуються найчастіше, із заголовком, типом, мовою, кількістю запитів, часткою в трафіку контенту та часом останнього запиту. Статті блогу з’являються з власним заголовком і посиланням.
- Статистика для вибраного магазину в multistore. Деталі контенту збираються з моменту впровадження розширеного лічильника; попередні суми запитів залишаються доступними.
Лічильник вимірює запити, оброблені модулем, зокрема умовні відповіді 304, а не унікальних відвідувачів. Розпізнавання сімейства клієнта ґрунтується на заявленому User-Agent. Запити, повністю оброблені зовнішнім кешем, не потрапляють до статистики модуля.
Content Signals — декларація того, що ви дозволяєте автоматичним системам
Магазин, контент якого читають AI-агенти, рано чи пізно стикається з питанням, на що саме він погоджується. Чи можна побудувати на його основі індекс пошукової системи? Чи можна використати опис товару, щоб відповісти клієнту на запитання? Чи можна навчати на цьому каталозі модель? Content Signals — це стандарт, який дає змогу відповісти на ці три запитання окремо й опублікувати відповідь там, куди автомати все одно заглядають — у файлі robots.txt. Модуль надає для цього окрему вкладку, три прості вибори та попередній перегляд того, що саме потрапить до файлу. Специфікація: contentsignals.org.
- Індексування в пошукових системах (search) — побудова індексу та показ посилань із короткими фрагментами. Не охоплює резюме, згенеровані AI.
- Відповіді на запитання на основі вашого контенту (ai-input) — передача контенту моделі в момент, коли хтось ставить запитання, щоб відповідь ґрунтувалася на ньому. Саме так працюють асистенти покупок.
- Навчання моделей AI (ai-train) — використання контенту для навчання або донавчання моделей.
- Кожна з трьох категорій має незалежне налаштування дозволено або заборонено, описане в панелі одним реченням українською — а не лише технічною міткою, яку продавець не зобов’язаний знати.
- Декларація потрапляє до robots.txt у блоці, обмеженому мітками з назвою модуля. Нічого поза цими мітками не парситься, не переписується і не переставляється — ваші власні правила та правила інших модулів залишаються недоторканими байт у байт.
- PrestaShop перезаписує robots.txt з нуля при кожному натисканні «Згенерувати файл robots.txt» у SEO та URL-адресах. Модуль тоді автоматично вписує свій блок назад, а вкладка все одно показує, чи файл актуальний, і дає змогу зберегти його повторно однією кнопкою.
- Панель показує перед збереженням, чи файл узагалі доступний для запису — замість того, щоб повідомити про успіх і залишити вас із декларацією, якої у файлі немає.
- Функція встановлюється вимкненою: запис будь-чого у файл, спільний для всього магазину, є рішенням продавця, а не модуля. Видалення модуля прибирає блок назад.
- У multistore-інсталяції панель прямо попереджає, що PrestaShop зберігає один файл robots.txt для всіх магазинів, тож збережена декларація охоплює кожен із них.
- Це декларація уподобань, а не контроль доступу: вона нікого не блокує, а її дотримання є рішенням іншої сторони. Модуль говорить про це прямо, замість натякати на захист, якого цей механізм не дає.
Бізнес-застосування
- Для магазинів PrestaShop, які хочуть, щоб їх коректно читали асистенти покупок і AI-агенти, замість того щоб сподіватися, що модель самостійно очистить HTML-сторінку від шуму.
- Для продавців, які хочуть контролювати, що саме потрапляє до агентів — обсяг типів сутностей, видимість цін і кількостей, а також спосіб публікації.
- Для магазинів із розгалуженим каталогом, у яких різниця між повною HTML-сторінкою та документом Markdown перетворюється на реальну різницю у вартості на боці того, хто запитує.
- Для магазинів, що ведуть блог і базу FAQ та хочуть надавати агентам поради, відповіді на запитання й відгуки клієнтів разом із товарною пропозицією.
- Для multistore-впроваджень, де кожен магазин потребує власних налаштувань, власних файлів llms і власного токена cron.
- Для компаній, які хочуть спирати рішення про подальші інвестиції в цей канал на дані — лічильник звернень показує, чи й яким шляхом агенти справді запитують.
- Для магазинів, що працюють за CDN або reverse proxy, де самостійне ввімкнення узгодження вмісту без перевірки загрожувало б показом неправильної версії сторінки звичайним клієнтам.
Чого модуль не робить
- Це не SEO-модуль і він не покращує позиції магазину в результатах пошуку Google — документи Markdown явно позначені як такі, що не індексуються.
- Він зберігає вигляд і вміст HTML-сторінки, яку бачать клієнти, додаючи інформацію про альтернативну версію Markdown у HTTP-заголовках і мітці посилання.
- Він не надсилає дані магазину до жодного зовнішнього сервісу й не потребує облікового запису чи API-ключа.
- Він не забезпечує виконання Content Signals і не може цього робити: декларація в robots.txt є вираженням уподобань, а не контролем доступу — вона нікого не блокує, а її дотримання залишається рішенням іншої сторони. Модуль не змінює решту правил у цьому файлі.
- Він не виконує автоматичних перекладів. Назви полів документа залишаються сталими й англійськими, вміст сторінок і статей використовує доступні переклади, FAQ дотримується мовних правил вихідного модуля, а відгуки зберігають мову висловлювання клієнта.
Сумісність
- PrestaShop: 1.7.1.0 - 9.x
- PHP: 7.0 - 8.5
- Без Composer і без зовнішніх бібліотек
- Multistore: так, налаштування та файли ведуться окремо для кожного магазину
- Багатомовність: так, документи та файли llms для кожної активної мови