Dokumentacja: generator llms.txt i llms-full.txt dla PrestaShop

Moduł tworzy w katalogu głównym sklepu pliki llms.txt i llms-full.txt – zwięzły opis sklepu, katalogu i kategorii, przeznaczony dla modeli językowych.

Co moduł robi

Generator składa dwa pliki tekstowe: llms.txt ze skróconą mapą sklepu (opis firmy, lista kategorii z adresami, lista produktów) i llms-full.txt z pełniejszymi opisami. Oba lądują w katalogu głównym, więc są dostępne pod /llms.txt i /llms-full.txt. Moduł dopisuje też do .htaccess regułę wymuszającą kodowanie UTF-8 dla tych plików – bez niej przeglądarka potrafi pokazać polskie znaki jako krzaki.

Pliki są generowane tylko w domyślnym języku sklepu.

Wymagania

  • PrestaShop 1.7, 8 lub 9.
  • Prawo zapisu w katalogu głównym sklepu – moduł zapisuje tam trzy pliki.
  • Brak ionCube.

Instalacja i konfiguracja

  1. Panel → Moduły → Menedżer modułów → Wgraj moduł.
  2. W konfiguracji uzupełnij opis sklepu (PD_LLMS_STORE_DESC) – to jest tekst, który trafia na początek pliku i który model przeczyta jako pierwszy. Warto, żeby zawierał nazwę firmy, to czym się zajmuje, zakres oferty i warunki zakupu.
  3. Zdecyduj, czy pomijać opisy produktów (PD_LLMS_NO_DESC_PROD) i kategorii (PD_LLMS_NO_DESC_CAT). Pominięcie daje krótszy plik, ale mniej treści do zacytowania.
  4. Kliknij Generuj. Data ostatniego przebiegu zapisuje się w PD_LLMS_LAST_GEN.

Generowanie automatyczne

Moduł ma kontroler AdminPdLlmsGeneratorCron, chroniony tokenem porównywanym odpornie na atak czasowy. Podpięcie go pod zadanie cron raz na dobę wystarcza – pliki mają sens tylko wtedy, gdy nadążają za katalogiem.

Wpis w robots.txt

Dopisz w robots.txt:

Allow: /llms.txt
Allow: /llms-full.txt

PrestaShop nadpisuje robots.txt przy generowaniu z panelu (Ruch → SEO i adresy URL → Generuj plik robots.txt), więc po każdym takim generowaniu wpisy trzeba przywrócić.

Czego się po tym spodziewać

llms.txt to propozycja standardu, a nie standard obsługiwany przez wyszukiwarki. Google nie deklaruje jego czytania. Plik nie zaszkodzi, kosztuje kilka kilobajtów i bywa przydatny, gdy ktoś wskaże go modelowi ręcznie – ale nie zastępuje tego, co realnie decyduje o cytowaniu sklepu przez modele: treści w zwykłym HTML, danych strukturalnych i wzmianek w niezależnych źródłach.

Rozwiązywanie problemów

„Nie można zapisać pliku llms.txt”

Katalog główny sklepu nie ma prawa zapisu dla użytkownika serwera WWW. Na hostingach współdzielonych wystarczy zwykle nadać katalogowi uprawnienia zapisu dla właściciela konta.

„Nie można zapisać pliku .htaccess”

Ten sam powód. Reguła kodowania jest opcjonalna – bez niej plik nadal działa, tylko może się wyświetlać z niepoprawnym kodowaniem w przeglądarce.

Plik nie zawiera nowych produktów

Pliki nie odświeżają się same. Uruchom generowanie ręcznie albo podepnij kontroler cron.

Strona modułu w sklepie

Powrót do góry