# FAQ produktu, statyczny akordeon: dokumentacja

> Przewodnik instalacji i obsługi modułu FAQ produktu, statyczny akordeon dla PrestaShop 8 i 9.

- Strona: <https://www.datafirefly.com/pl/documentation/faq-produktu-statyczny-akordeon-prestashop/>
- Język: pl
- Zaktualizowano: 2026-08-02
- Inne języki: [fr](https://www.datafirefly.com/documentation/faq-produit-accordeon-statique/index.md), [en](https://www.datafirefly.com/en/documentation/faq-produit-accordeon-statique/index.md), [es](https://www.datafirefly.com/es/documentation/faq-produit-accordeon-statique/index.md), [de](https://www.datafirefly.com/de/documentation/faq-produit-accordeon-statique/index.md), [it](https://www.datafirefly.com/it/documentation/faq-produit-accordeon-statique/index.md), [pt](https://www.datafirefly.com/pt/documentation/faq-produit-accordeon-statique/index.md), [nl](https://www.datafirefly.com/nl/documentation/faq-produit-accordeon-statique/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Prezentacja

Moduł **FAQ produktu, statyczny akordeon** dodaje składaną listę najczęstszych pytań pod kartami produktów. Pytania i odpowiedzi wpisujesz ręcznie w panelu administracyjnym, a moduł wyświetla je w natywnym akordeonie HTML, dostępnym i bez JavaScriptu. Wstrzykuje też dane strukturalne `schema.org FAQPage` w formacie JSON-LD, na potrzeby SEO i AEO.

Chcesz generować FAQ automatycznie na podstawie cech produktu, opinii i rzeczywistych wyszukiwań? Sprawdź **FAQ AI Produktu** od DataFirefly, która automatyzuje cały proces w wielu językach.

## Instalacja

1. Pobierz archiwum `dfstaticfaq.zip` ze swojego konta DataFirefly.
2. W panelu administracyjnym PrestaShop otwórz **Moduły > Menedżer modułów**, a następnie kliknij **Wgraj moduł**.
3. Wskaż plik ZIP i uruchom instalację.
4. Po instalacji kliknij **Konfiguruj**, aby przejść do ustawień.

Moduł jest zgodny z PrestaShop od 8.0 aż po wersje 9.x, w trybie multisklep i wielojęzycznym. Nie wczytuje żadnych zależności po stronie sklepu.

## Ustawienia modułu

Strona konfiguracji skupia trzy ustawienia:

- **Tytuł bloku FAQ**: tytuł wyświetlany nad akordeonem na karcie produktu. Można go tłumaczyć per język.
- **Wyłączne otwarcie**: przy włączonej opcji tylko jedna odpowiedź pozostaje otwarta naraz. Zachowanie jest natywne, bez JavaScriptu.
- **Dane strukturalne FAQPage (JSON-LD)**: włącza lub wyłącza wstrzykiwanie znaczników `schema.org FAQPage` na karcie produktu.

Przycisk **Zarządzaj FAQ** otwiera ekran wprowadzania pytań.

## Dodawanie pytań i zarządzanie nimi

Na ekranie **Zarządzaj FAQ** kliknij **Dodaj**, aby utworzyć pytanie. Każdy wpis zawiera:

- **Pytanie**: etykieta wyświetlana w akordeonie (tłumaczona).
- **Odpowiedź**: rozwijana treść, redagowana w rozbudowanym edytorze tekstu (tłumaczona).
- **ID produktu**: identyfikator docelowego produktu. Zostaw `0`, aby wyświetlić pytanie na wszystkich kartach produktów.
- **Pozycja**: rosnąca kolejność wyświetlania.
- **Włączone**: pokazuje lub ukrywa pytanie bez usuwania go.

**FAQ globalne albo kierowane:** pytanie z `ID produktu = 0` pojawia się na wszystkich kartach. Aby przypisać pytanie do jednego produktu, wpisz jego identyfikator. Oba rodzaje mogą współistnieć na tej samej karcie.

### Zmiana kolejności pytań

Kolejność wyświetlania określa pole **Pozycja** (rosnąco). Listę możesz też posortować, klikając nagłówek kolumny Pozycja.

## Wyświetlanie na karcie produktu

Akordeon pojawia się automatycznie pod blokiem produktu, przez hook `displayFooterProduct`. Opiera się na natywnych elementach HTML `details` i `summary`: natywna nawigacja klawiaturą, brak zależności od motywu i poszanowanie preferencji ograniczonego ruchu. Ikona plus/minus pokazuje, czy pytanie jest otwarte, czy zamknięte.

## Dane strukturalne FAQPage

Gdy opcja JSON-LD jest włączona, moduł dodaje na karcie produktu skrypt `application/ld+json` opisujący FAQ w formacie `schema.org FAQPage`. Odpowiedzi są oczyszczane z formatowania HTML, aby wygenerować poprawny JSON.

Google zastrzega obecnie wyniki rozszerzone dla FAQ dla wybranych witryn instytucjonalnych. Znaczniki pozostają jednak poprawne i możliwe do wykorzystania przez wyszukiwarki odpowiedzi oraz asystentów AI. W razie potrzeby wyłączysz je jednym kliknięciem.

## Zgodność

- **PrestaShop**: od 8.0 po wersje 9.x
- **Multisklep**: tak
- **Wielojęzyczność**: pytania i odpowiedzi tłumaczone per język
- **Strona sklepu**: natywny HTML i CSS, zero JavaScriptu

## Przejście na FAQ AI Produktu

Ten moduł opiera się na ręcznym wprowadzaniu treści. Aby automatycznie generować pytania i odpowiedzi w skali całego katalogu, na podstawie cech produktu, opinii i rzeczywistych wyszukiwań, wybierz **FAQ AI Produktu** od DataFirefly. Migracja nie wymaga utraty żadnej treści.

## Rozwiązywanie problemów

- **Akordeon się nie pojawia**: sprawdź, czy co najmniej jedno pytanie jest aktywne oraz czy jest globalne (`ID produktu = 0`) albo przypisane do oglądanego produktu.
- **Zmiany nie są widoczne**: wyczyść pamięć podręczną PrestaShop (**Ustawienia zaawansowane > Wydajność**).
- **Tytuł nie jest przetłumaczony**: uzupełnij tytuł bloku dla każdego języka w ustawieniach.

Po odinstalowaniu wszystkie wprowadzone pytania i odpowiedzi zostają trwale usunięte. Wcześniej wyeksportuj bazę, jeśli chcesz je zachować.
