Generator voor FAQ Schema.org: documentatie

Overzicht

DfFaqSchema voegt bewerkbare vraag-en-antwoordblokken toe aan de productpagina’s, de categoriepagina’s en de Shopping Experiences-layouts van Shopware 6. Elk blok wordt weergegeven als een Bootstrap-accordeon en gaat vergezeld van Schema.org FAQPage-markup in JSON-LD, die automatisch in de pagina wordt ingevoegd. De plugin is compatibel met Shopware 6.5, 6.6 en 6.7 en vereist geen enkele wijziging aan uw thema.

Installatie

Via de administration

1. Open Extensies en daarna Mijn extensies en upload het ZIP-bestand van de plugin.
2. Klik op Installeren en activeer daarna de plugin.

Via de console

bin/console plugin:refresh
bin/console plugin:install --activate DfFaqSchema
bin/console cache:clear

Compilatie van de administration

De administratiemodule en het CMS-element vereisen een eenmalige compilatie van de assets:

./bin/build-administration.sh

Configuratie

Open Extensies, Mijn extensies en daarna de configuratie van DfFaqSchema. Er zijn twee opties beschikbaar, globaal of per verkoopkanaal in te stellen:

• FAQ’s tonen op de productpagina’s: activeert de accordeon en de JSON-LD op de productpagina’s (standaard ingeschakeld).
• FAQ’s tonen op de categoriepagina’s: activeert de accordeon en de JSON-LD op de navigatiepagina’s (standaard ingeschakeld).

FAQ-items aanmaken

Open Content en daarna FAQ Schema.org. Het overzicht toont alle items met hun vraag, hun toewijzing, hun positie en hun status.

Velden van een item

• Vraag: de tekst van de vraag (vertaald veld).
• Antwoord: het antwoord in opgemaakte tekst via de geïntegreerde editor (vertaald veld).
• Positie: de weergavevolgorde in de accordeon, oplopend.
• Actief: alleen actieve items worden getoond en van markup voorzien.
• Toewijzing: product, categorie of CMS-pagina. De typekiezer toont het bijbehorende zoekveld.

Een item vertalen

Gebruik de taalkiezer bovenaan de detailpagina om van taal te wisselen en voer daarna de vertaalde vraag en het vertaalde antwoord in. Elke shop toont de inhoud in zijn taal en de JSON-LD volgt automatisch.

Weergave op product- en categoriepagina’s

Items die aan een product zijn toegewezen, verschijnen onder de hoofdinhoud van de productpagina. Items die aan een categorie zijn toegewezen, verschijnen onder het overzicht van de navigatiepagina. In beide gevallen wordt de bijbehorende FAQPage JSON-LD in de header van het document ingevoegd. De eerste vraag van de accordeon staat standaard open.

CMS-element voor de Shopping Experiences

1. Maak uw items in de module aan zonder ze aan een product of een categorie toe te wijzen (toewijzing aan een CMS-pagina).
2. Open Content en daarna Shopping Experiences en bewerk een layout.
3. Voeg een tekstblok toe en vervang het element ervan door het element FAQ (Schema.org).
4. Selecteer in de configuratie van het element de items die u wilt tonen.

De accordeon en de bijbehorende JSON-LD worden precies op de plaats van het element gerenderd. U kunt meerdere FAQ-elementen in dezelfde layout gebruiken.

JSON-LD-markup en validatie

De plugin genereert een FAQPage-object met per weergegeven item een Question-entiteit, met het antwoord als HTML in het veld text van de Answer-entiteit, wat Google accepteert. De markup dekt uitsluitend de inhoud die daadwerkelijk op de pagina zichtbaar is, conform de richtlijnen voor rich results.

Gebruik om een pagina te valideren de test voor rich results van Google: plak de URL van uw productpagina en controleer of het FAQ-element foutloos wordt herkend.

Probleemoplossing

• Het menu FAQ Schema.org verschijnt niet: voer de compilatie van de administration uit en leeg daarna de cache van de browser.
• De accordeon verschijnt niet op een productpagina: controleer of het item actief is, of het daadwerkelijk aan dat product is toegewezen en of de weergaveoptie voor producten geactiveerd is voor het betreffende verkoopkanaal.
• De JSON-LD ontbreekt: de markup wordt alleen gegenereerd als er ten minste één actief item op de pagina wordt getoond. Controleer de broncode van de pagina door op application/ld+json te zoeken.
• Het CMS-element toont niets: controleer of er items in de configuratie van het element zijn geselecteerd en of ze actief zijn.

Verwijderen

Het verwijderen wist de tabellen van de plugin en zijn configuratie. Vink bij het verwijderen de optie om de gegevens te behouden aan om uw vragen en antwoorden te bewaren met het oog op een herinstallatie.