# Generator FAQ Schema.org — Dokumentacja
> Przegląd DfFaqSchema dodaje edytowalne bloki pytań i odpowiedzi na kartach produktów, stronach kategorii i layoutach Shopping Experiences w Shopware 6. Każdy blok jest renderowany jako akordeon Bootstrap i uzupełniony znacznikiem…
- Strona:
- Język: pl
- Zaktualizowano: 2026-08-12
- Inne języki: [fr](https://www.datafirefly.com/documentation/dffaqschema/index.md), [en](https://www.datafirefly.com/en/documentation/dffaqschema/index.md), [es](https://www.datafirefly.com/es/documentation/dffaqschema/index.md), [de](https://www.datafirefly.com/de/documentation/dffaqschema/index.md), [it](https://www.datafirefly.com/it/documentation/dffaqschema/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffaqschema/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffaqschema/index.md)
- Indeks:
## Przegląd
DfFaqSchema dodaje edytowalne bloki pytań i odpowiedzi na kartach produktów, stronach kategorii i layoutach Shopping Experiences w Shopware 6. Każdy blok jest renderowany jako akordeon Bootstrap i uzupełniony znacznikiem Schema.org FAQPage w JSON-LD, automatycznie wstrzykiwanym do strony. Wtyczka obsługuje Shopware 6.5, 6.6 i 6.7 i nie wymaga żadnych zmian w Twoim motywie.
## Instalacja
### Przez administrację
1. Otwórz Rozszerzenia, następnie Moje rozszerzenia, i prześlij plik ZIP wtyczki.
2. Kliknij Zainstaluj, a następnie aktywuj wtyczkę.
### Przez konsolę
```
bin/console plugin:refresh
bin/console plugin:install --activate DfFaqSchema
bin/console cache:clear
```
### Budowanie administracji
Moduł administracyjny i element CMS wymagają jednorazowego zbudowania zasobów:
```
./bin/build-administration.sh
```
Bez tego kroku pozycja menu FAQ Schema.org i element CMS nie pojawią się w administracji. Sklep działa natychmiast po aktywacji.
## Konfiguracja
Otwórz Rozszerzenia, Moje rozszerzenia, a następnie konfigurację DfFaqSchema. Dostępne są dwie opcje, globalnie lub dla każdego kanału sprzedaży:
- **Pokazuj FAQ na kartach produktów**: włącza akordeon i JSON-LD na stronach produktów (domyślnie włączone).
- **Pokazuj FAQ na stronach kategorii**: włącza akordeon i JSON-LD na stronach nawigacji (domyślnie włączone).
## Tworzenie wpisów FAQ
Otwórz Treści, a następnie FAQ Schema.org. Lista pokazuje wszystkie wpisy z pytaniem, przypisaniem, pozycją i statusem.
### Pola wpisu
- **Pytanie**: tekst pytania (pole tłumaczone).
- **Odpowiedź**: odpowiedź w formacie rich text przez wbudowany edytor (pole tłumaczone).
- **Pozycja**: kolejność wyświetlania w akordeonie, rosnąco.
- **Aktywny**: tylko aktywne wpisy są wyświetlane i oznaczane.
- **Przypisanie**: produkt, kategoria lub strona CMS. Selektor typu pokazuje odpowiednie pole wyszukiwania.
### Tłumaczenie wpisu
Użyj przełącznika języka u góry strony szczegółów, aby zmienić język, a następnie wpisz przetłumaczone pytanie i odpowiedź. Każdy język sklepu pokazuje własne treści, a JSON-LD dostosowuje się automatycznie.
Wpis bez tłumaczenia w danym języku korzysta z domyślnego języka systemu, zgodnie ze standardowym mechanizmem Shopware.
## Wyświetlanie na produkcie i kategorii
Wpisy przypisane do produktu pojawiają się pod główną treścią karty produktu. Wpisy przypisane do kategorii pojawiają się pod listą produktów strony nawigacji. W obu przypadkach odpowiedni JSON-LD FAQPage jest wstrzykiwany do sekcji head dokumentu. Pierwsze pytanie akordeonu jest domyślnie otwarte.
## Element CMS dla Shopping Experiences
1. Utwórz wpisy w module bez przypisywania ich do produktu lub kategorii (przypisanie strona CMS).
2. Otwórz Treści, następnie Shopping Experiences, i edytuj layout.
3. Dodaj blok tekstowy, a następnie zamień jego element na element **FAQ (Schema.org)**.
4. W konfiguracji elementu wybierz wpisy do wyświetlenia.
Akordeon i jego JSON-LD renderują się dokładnie w miejscu elementu. Możesz użyć kilku elementów FAQ na tym samym layoucie.
## Znacznik JSON-LD i walidacja
Wtyczka generuje obiekt FAQPage z encją Question dla każdego wyświetlonego wpisu, z odpowiedzią w formacie HTML w polu text encji Answer, co Google akceptuje. Znacznik obejmuje wyłącznie treść faktycznie widoczną na stronie, zgodnie z wytycznymi dotyczącymi rich results.
Aby zweryfikować stronę, użyj testu wyników z elementami rozszerzonymi Google: wklej adres URL karty produktu i sprawdź, czy element FAQ jest wykrywany bez błędów.
Faktyczne pojawienie się rich results pozostaje w gestii Google, które od 2023 roku pokazuje je głównie autorytatywnym stronom rządowym i medycznym. Znacznik pozostaje wartościowy dla zrozumienia Twoich stron przez wyszukiwarki i asystentów AI.
## Rozwiązywanie problemów
- **Pozycja menu FAQ Schema.org nie pojawia się**: uruchom budowanie administracji i wyczyść pamięć podręczną przeglądarki.
- **Akordeon nie pojawia się na karcie produktu**: sprawdź, czy wpis jest aktywny, przypisany do tego produktu i czy opcja wyświetlania na produkcie jest włączona dla danego kanału sprzedaży.
- **Brak JSON-LD**: znacznik jest generowany tylko wtedy, gdy na stronie wyświetlany jest co najmniej jeden aktywny wpis. Wyszukaj application/ld+json w kodzie źródłowym strony.
- **Element CMS niczego nie pokazuje**: sprawdź, czy w konfiguracji elementu wybrano wpisy i czy są one aktywne.
## Deinstalacja
Deinstalacja usuwa tabele wtyczki i jej konfigurację. Zaznacz opcję zachowania danych podczas deinstalacji, aby zachować pytania i odpowiedzi na potrzeby ponownej instalacji.