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 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.

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.