# llms.txt + AEO Schema dla WooCommerce — Kompletny przewodnik
> Przegląd Wtyczka DataFirefly llms.txt + AEO Schema sprawia, że Twój sklep WooCommerce jest widoczny i poprawnie rozumiany przez agentów AI (ChatGPT, Claude, Perplexity, Gemini). Łączy dwa uzupełniające się mechanizmy: Dynamiczny…
- Strona:
- Język: pl
- Zaktualizowano: 2026-08-06
- Inne języki: [fr](https://www.datafirefly.com/documentation/llms-txt-aeo-schema-woocommerce/index.md), [en](https://www.datafirefly.com/en/documentation/llms-txt-aeo-schema-woocommerce/index.md), [es](https://www.datafirefly.com/es/documentation/llms-txt-aeo-schema-woocommerce/index.md), [de](https://www.datafirefly.com/de/documentation/llms-txt-aeo-schema-woocommerce/index.md), [it](https://www.datafirefly.com/it/documentation/llms-txt-aeo-schema-woocommerce/index.md), [nl](https://www.datafirefly.com/nl/documentation/llms-txt-aeo-schema-woocommerce/index.md), [pt](https://www.datafirefly.com/pt/documentation/llms-txt-aeo-schema-woocommerce/index.md)
- Indeks:
## Przegląd
Wtyczka **DataFirefly llms.txt + AEO Schema** sprawia, że Twój sklep WooCommerce jest widoczny i poprawnie rozumiany przez agentów AI (ChatGPT, Claude, Perplexity, Gemini). Łączy dwa uzupełniające się mechanizmy:
- **Dynamiczny endpoint /llms.txt** zgodny ze standardem llmstxt.org, generowany z Twojego katalogu z pamięcią podręczną per język.
- **Wzbogacanie schematu Product** WooCommerce o atrybuty przeciwdziałające halucynacjom, których szukają agenci: marka, GTIN, materiały, kompatybilność, polityki zwrotów i wysyłki, plus osobny schemat FAQPage skierowany do agentów.
## Wymagania
- WordPress 6.2 lub nowszy
- WooCommerce 8.0 lub nowszy (testowane do 9.4)
- PHP 8.0 lub nowszy
- Opcjonalnie: Polylang lub WPML dla generowania wielojęzycznego
## Instalacja
1. Pobierz archiwum `dfllmstxtaeo.zip` ze swojego konta DataFirefly.
2. W panelu WordPress przejdź do **Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer**, wybierz plik ZIP i kliknij **Zainstaluj**.
3. Aktywuj wtyczkę. Reguła przepisywania dla `/llms.txt` zostaje zarejestrowana, a permalinki są odświeżane automatycznie przy aktywacji.
4. Sprawdź, czy `https://twojastrona.tld/llms.txt` odpowiada. W przypadku błędu 404 przejdź do **Ustawienia → Bezpośrednie odnośniki** i kliknij **Zapisz zmiany**, aby wymusić odświeżenie reguł.
## Ustawienia ogólne
Strona konfiguracji znajduje się w **WooCommerce → llms.txt + AEO**. U góry wyświetla adres URL Twojego llms.txt z bezpośrednim linkiem podglądu.
### Serwowanie /llms.txt
Cztery przełączniki sterują głównymi funkcjami: endpointem llms.txt, wzbogacaniem schematu produktu, wyjściem schematu FAQPage i specyfikacją Speakable. Wszystko jest domyślnie włączone.
### Zawartość llms.txt
- **Uwzględnij produkty / strony / wpisy**: wybierz, które sekcje są generowane.
- **Maksymalna liczba produktów**: od 1 do 1000 (domyślnie 200). Najnowsze produkty są wymieniane jako pierwsze.
- **Czas pamięci podręcznej**: w minutach, 0 aby wyłączyć. Cache i tak jest czyszczony automatycznie przy każdej edycji produktu, strony lub ustawień.
- **Akapit wprowadzający**: dowolny tekst (zwykły tekst lub markdown) wstawiany po opisie witryny.
### Domyślne wartości schematu
- **Domyślna nazwa marki**: używana, gdy produkt nie ma własnej marki.
- **Kraj sprzedawcy (ISO-2)**: pozostaw puste, aby użyć kraju bazowego WooCommerce.
- **Domyślny okres zwrotu**: w dniach, zasila hasMerchantReturnPolicy.
- **Koszty zwrotu**: darmowy zwrot, klient płaci za wysyłkę, lub klient płaci wszystkie koszty.
## Endpoint /llms.txt
Plik jest serwowany z nagłówkami `Content-Type: text/markdown; charset=utf-8` oraz `X-Robots-Tag: noindex` (jest przeznaczony dla crawlerów AI, nie dla indeksu Google). Generowane sekcje: kategorie produktów, produkty (tytuł, URL, cena, krótki opis), strony, wpisy, oraz linki do polityki prywatności i regulaminu skonfigurowanych w WordPress i WooCommerce.
### Jak działa pamięć podręczna
Zawartość jest przechowywana w transiencie per język (`dfllmstxtaeo_llms_cache_{lang}`). Jest unieważniana automatycznie na hookach `save_post_product`, `save_post_page`, `deleted_post` oraz przy każdym zapisie ustawień wtyczki.
### Wielojęzyczność
Polylang i WPML są wykrywane automatycznie. Każdy język otrzymuje własny llms.txt serwowany pod swoim prefiksem URL (np. `/pl/llms.txt` w zależności od konfiguracji Polylang), z niezależną pamięcią podręczną. Bez wtyczki wielojęzycznej używana jest locale WordPressa.
## Zakładka AEO Schema przy produktach
Każdy produkt zyskuje zakładkę **AEO Schema** w panelu danych WooCommerce (Produkt → Edytuj).
### Dostępne pola
- **Marka**: zastępuje globalną markę dla tego produktu. W przeciwnym razie wtyczka szuka atrybutu `pa_brand` lub `brand`.
- **GTIN / EAN / UPC**: 8, 12, 13 lub 14 cyfr. Odpowiednia właściwość `gtin8/12/13/14` jest dodawana automatycznie na podstawie długości.
- **MPN**: numer katalogowy producenta.
- **Materiały**: rozdzielone przecinkami (np. „skóra, bawełna z recyklingu"). Jeden materiał tworzy ciąg znaków, kilka tworzy tablicę.
- **Kompatybilny z**: jeden element na linię. Każda linia staje się wpisem `isRelatedTo` typu Product.
### FAQ dla agentów AI
Pod polami sekcja **FAQ dla agentów** pozwala dodawać krótkie, rzeczowe pary pytanie/odpowiedź (dokładna kompatybilność, wymiary, składniki, certyfikaty). Zasilają one osobny schemat `FAQPage` JSON-LD, emitowany tylko na stronach produktów, które mają co najmniej jeden wpis. To FAQ jest niewidoczne od strony klienta: nie wyświetla się w motywie, istnieje wyłącznie dla agentów.
Pisz odpowiedzi jako weryfikowalne fakty, nie jako argumenty sprzedażowe. Agent czytający „kompatybilny z modelami X, Y i Z" zacytuje dokładnie te modele; agent czytający „kompatybilny z większością urządzeń" wymyśli listę.
## Dodane pola Schema.org
Na obiekcie **Product**: brand, gtin (+ gtin8/12/13/14), mpn, material, color, size, weight, height, width, depth (QuantitativeValue z jednostkami WooCommerce), isRelatedTo, speakable. Na każdym **Offer**: seller (Organization z nazwą i adresem URL witryny), hasMerchantReturnPolicy (kraj, okres w dniach, rodzaj opłat), shippingDetails (miejsce docelowe, deliveryTime z handlingTime 0-1 dzień i transitTime 1-5 dni).
Pola color i size są pobierane automatycznie z atrybutów `pa_color` / `color` oraz `pa_size` / `size`, jeśli istnieją. Waga i wymiary pochodzą z natywnych pól wysyłkowych produktu.
## Kompatybilność z wtyczkami SEO
Wtyczka działa wyłącznie przez natywny filtr `woocommerce_structured_data_product`, który dotyczy tylko JSON-LD generowanego przez sam WooCommerce. Yoast SEO, RankMath i SEO Press emitują swoje bloki niezależnie przez `wp_head`: brak kolizji. Wartości już obecne w schemacie WooCommerce są zachowywane.
## Hooki dla programistów
- `dfllmstxtaeo_llms_output`: filtruje końcową zawartość llms.txt. Argumenty: zawartość (string) i kod języka.
- `dfllmstxtaeo_product_schema`: filtruje tablicę wzbogaconego schematu przed wyjściem. Argumenty: tablica markup i obiekt WC_Product.
```
add_filter( 'dfllmstxtaeo_product_schema', function ( $markup, $product ) {
$markup['award'] = 'Nagroda za design 2026';
return $markup;
}, 10, 2 );
```
## Rozwiązywanie problemów
- **/llms.txt zwraca 404**: zapisz ponownie permalinki (Ustawienia → Bezpośrednie odnośniki → Zapisz zmiany).
- **Plik nie odzwierciedla niedawnej zmiany**: cache czyści się przy edycji, ale możesz to wymusić, ustawiając tymczasowo czas pamięci podręcznej na 0 lub ponownie zapisując ustawienia.
- **FAQPage się nie pojawia**: sprawdź, czy produkt ma co najmniej jedną kompletną parę pytanie/odpowiedź i czy opcja „Emituj schemat FAQPage" jest włączona.
- **Walidacja schematu**: przetestuj adres URL produktu walidatorem schema.org lub narzędziem Rich Results od Google, aby sprawdzić pełny JSON-LD.