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

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.

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.

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.