FAQ AI Produkt — Kompletny przewodnik instalacji i konfiguracji

Prezentacja

DataFirefly FAQ AI Produkt automatycznie generuje kontekstowe FAQ dla kart produktów PrestaShop 8 przez OpenAI lub Anthropic Claude, z wstrzykiwaniem rich snippets Schema.org FAQPage do sekcji head dla wyników rozszerzonych Google. FAQ są przechowywane w bazie (tabela ps_product_faq) — żadne wywołanie API nie jest wykonywane po stronie front-office.

• Kompatybilność: PrestaShop 8.0 → 8.99, PHP 7.2 → 8.3
• Wielojęzyczność: FAQ generowane i przechowywane per język
• Multistore: niezależna konfiguracja per pod-sklep

Instalacja

1. W back-office przejdź do Moduły → Menedżer modułów → Zainstaluj moduł.
2. Wgraj productfaqai-3.0.0.zip.
3. Kliknij Zainstaluj, potem Konfiguruj.

1. Dostawca AI i model

Pierwszy formularz strony konfiguracji.

• Dostawca AI: OpenAI lub Anthropic Claude. Moduł automatycznie przełącza się na właściwe API.
• Klucz API OpenAI: z platform.openai.com (zaczyna się od sk-).
• Klucz API Anthropic: z console.anthropic.com (zaczyna się od sk-ant-).
• Model: dla OpenAI zalecany gpt-4o-mini (najtańszy). Dla Anthropic zalecany claude-haiku-4-5.
• Liczba pytań: 1 do 15 (domyślnie 5).
• Temperatura: 0 = deterministyczna, 2 = bardzo kreatywna. Zalecane: 0,7.
• Max tokens: maksymalna długość odpowiedzi (domyślnie 2000). Zwiększ, jeśli generujesz ponad 8 pytań.
• Auto-generowanie: automatycznie generuje FAQ (język domyślny) przy każdym utworzeniu produktu.

2. Prompt i wytyczne treści

Drugi formularz — steruje jakością i stylem generowanych FAQ.

• Ton wypowiedzi: profesjonalny, przyjazny, swobodny, techniczny, entuzjastyczny lub uspokajający.
• Grupa docelowa (opcjonalnie): tekst dowolny, np. „profesjonaliści medyczni B2B”, „kupujący po raz pierwszy”. AI dostosowuje słownictwo i poziom szczegółowości.
• Własny prompt systemowy (opcjonalnie): całkowicie zastępuje domyślne instrukcje. Zostaw puste, aby użyć wbudowanego promptu.
• Dodatkowe wytyczne (opcjonalnie): instrukcje dodawane do promptu, np. „zawsze wspominaj o 2-letniej gwarancji”, „unikaj żargonu”.
• Dołącz kategorię / producenta / cechy: trzy przełączniki wzbogacające kontekst wysyłany do AI. Włącz „cechy” dla produktów technicznych — precyzja odpowiedzi wyraźnie rośnie.

3. Wyświetlanie i SEO

• Pozycja wyświetlania (hook): wybierz spośród 5 miejsc:
  • displayProductFooter — pod całą kartą (domyślnie, działa wszędzie)
  • displayFooterProduct — wariant zależny od motywu
  • displayProductAdditionalInfo — pod przyciskiem zakupu (bardziej widoczny)
  • displayReassurance — blok zaufania
  • displayAfterProductThumbs — pod miniaturami
• Tytuł FAQ: jedno pole na każdy język sklepu. Domyślne wartości w FR/EN/ES/DE/IT/PT/NL.
• Tryb akordeonu: włączony = pytania zwijane (pierwsze otwarte). Wyłączony = wszystkie odpowiedzi widoczne.
• Rich snippets JSON-LD: wstrzykuje znaczniki Schema.org FAQPage do head. Zalecane: włączone.
• Wykluczone kategorie: ID rozdzielone przecinkami (np. 12,45,78). Produkty z tych kategorii są pomijane przy generowaniu masowym.

Generowanie FAQ

Generowanie pojedyncze

W panelu „Generuj FAQ dla produktów” każdy wiersz produktu ma przycisk Generuj. Najpierw wybierz język docelowy w rozwijanym menu u góry tabeli. Liczba istniejących FAQ per język jest wyświetlana dla każdego produktu.

Generowanie masowe

• Generuj dla wszystkich produktów (bieżący język): przetwarza wszystkie produkty bez FAQ w aktywnym języku.
• Generuj dla wszystkich produktów (wszystkie języki): przetwarza wszystkie aktywne języki sklepu.
• Wymuś regenerację: zaznacz, aby nadpisać istniejące FAQ — przydatne po zmianie promptu, tonu lub dostawcy.

Auto-generowanie

Jeśli włączone w pierwszym formularzu, każdy nowy produkt (hook actionProductAdd) automatycznie otrzymuje FAQ w domyślnym języku sklepu.

Edytor FAQ per produkt

Kliknij Edytuj FAQ w wierszu produktu, aby otworzyć edytor:

• Selektor języka u góry — natychmiastowe przełączanie między językami.
• Pozycja: waga numeryczna, rosnąca kolejność wyświetlania.
• Pytanie / Odpowiedź: bezpośrednia edycja tekstu.
• Status: włączanie/wyłączanie wpisu bez usuwania (nieaktywny wpis nie pojawia się ani na karcie, ani w JSON-LD).
• Usuń: trwałe usunięcie wpisu.
• Dodaj FAQ: ręczne dodanie pytania/odpowiedzi.

Kliknij Zapisz, aby zatwierdzić wszystkie zmiany na stronie.

Rich snippets FAQPage

Gdy opcja JSON-LD jest aktywna, moduł wstrzykuje do head każdej karty produktu z co najmniej jedną aktywną FAQ blok application/ld+json zgodny ze Schema.org FAQPage:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "…",
      "acceptedAnswer": { "@type": "Answer", "text": "…" }
    }
  ]
}

Zweryfikuj znaczniki testem wyników rozszerzonych Google. Pojawienie się w SERP zależy od Google i może zająć kilka dni po ponownym zaindeksowaniu strony.

Rozwiązywanie problemów

„Skonfiguruj swój klucz API”

Klucz wybranego dostawcy jest pusty lub nieprawidłowy. Sprawdź, czy klucz odpowiada aktywnemu dostawcy (OpenAI = sk-…, Anthropic = sk-ant-…).

Błędy generowania masowego

Błędy API (przekroczony limit, unieważniony klucz, timeout) są zapisywane w Zaawansowane → Logi przez PrestaShopLogger. Podsumowanie po przetworzeniu pokazuje szczegóły sukcesów / pominięć / błędów per język.

FAQ nie wyświetla się na karcie produktu

1. Sprawdź, czy produkt ma co najmniej jedną aktywną FAQ w przeglądanym języku.
2. Sprawdź, czy skonfigurowany hook istnieje w Twoim motywie — wróć na displayProductFooter dla testu.
3. Wyczyść cache PrestaShop (Zaawansowane → Wydajność).

Rich snippets nie pojawiają się w Google

Znaczniki mogą być poprawne, a Google i tak ich nie wyświetlać: pokazywanie wyników rozszerzonych pozostaje decyzją Google. Najpierw sprawdź znaczniki testem wyników rozszerzonych, potem poczekaj na ponowne zaindeksowanie.

Odinstalowanie

Odinstalowanie usuwa tabelę ps_product_faq (wszystkie wygenerowane FAQ) i wszystkie klucze konfiguracji. Wymagane jest potwierdzenie. W razie potrzeby wcześniej wyeksportuj dane.