Probleemoplossing FAQ Manager

Symptomen:

• Het bezoeken van de FAQ-pagina URL toont een 404 Not Found pagina
• De pagina bestaat in de admin en is ingesteld op actief

Oplossing:

1. Verifieer dat de URL key overeenkomt met wat u bezoekt (bijv. URL key faq = uwwinkel.nl/faq)
2. Controleer of de pagina is ingesteld op Is Actief: Ja
3. Controleer of de module is ingeschakeld in de configuratie
4. Leeg de full page cache: Systeem → Cachebeheer → Full Page Cache legen
5. Als u Varnish gebruikt, purge dan ook de Varnish cache

Preventie:

• Test de URL altijd direct na het aanmaken van een nieuwe pagina
• Vermijd URL keys die conflicteren met bestaande CMS-pagina's, categorieën of product-URL's

Symptomen:

• Productpagina laadt normaal maar er verschijnt geen FAQ-sectie
• FAQ's zijn gekoppeld aan het product in de admin

Oplossing:

1. Verifieer dat FAQ's op productpagina's inschakelen op Ja staat in de moduleconfiguratie
2. Controleer of de FAQ is ingesteld op Is Actief: Ja
3. Bevestig dat de productkoppeling bestaat: bewerk de FAQ → tabblad Producten → verifieer dat het product in de lijst staat
4. Leeg de block HTML en full page cache
5. Controleer de catalog_product_view.xml van uw thema op lay-outoverschrijvingen die het FAQ-blok mogelijk verwijderen

Preventie:

• Controleer na het koppelen van FAQ's aan producten altijd de frontend

Symptomen:

• Categoriepagina laadt maar er verschijnt geen FAQ-sectie
• FAQ's zijn gekoppeld aan de categorie in de admin

Oplossing:

1. Verifieer dat FAQ's op categoriepagina's inschakelen op Ja staat in de moduleconfiguratie
2. Controleer of de FAQ is ingesteld op Is Actief: Ja
3. Bevestig de categoriekoppeling: bewerk de FAQ → tabblad Catalogus Categorieën → verifieer dat de categorie is geselecteerd
4. Leeg de caches

Preventie:

• Hetzelfde als bij product-FAQ's — controleer altijd de frontend na wijzigingen

Symptomen:

• FAQ's worden correct weergegeven op de pagina maar er is geen structured data zichtbaar in de paginabron
• Google's Rich Results Test detecteert geen FAQPage-markup

Oplossing:

1. Bekijk de paginabron (niet alleen het inspecteerelement) en zoek naar FAQPage
2. Zorg ervoor dat u naar de daadwerkelijke frontendpagina kijkt, niet een gecachte versie
3. Verifieer dat de FAQ's worden weergegeven in het juiste template (controleer of het design thema overeenkomt met uw frontend-thema)
4. Als u een CDN of cachelaag gebruikt, zorg er dan voor dat deze geen schema-markup verwijdert

Preventie:

• Valideer na de eerste opzet altijd met Google's Rich Results Test

Symptomen:

• Het wisselen van storeview toont dezelfde taal voor alle views
• Vertaalde inhoud verschijnt niet op de frontend

Oplossing:

1. Verifieer dat u vertalingen hebt ingevoerd in het juiste storeview-bereik (schakel naar de storeview in de admin en bewerk vervolgens de entiteit)
2. Controleer of het storeview-bereik correct is — vertalingen worden ingevoerd op storeview-niveau, niet op websiteniveau
3. Leeg de configuratie- en full page cache
4. Verifieer de terugval: als er geen storeview-specifieke vertaling bestaat, wordt de standaard (Alle Storeviews) inhoud gebruikt — dit is verwacht gedrag

Preventie:

• Maak altijd eerst inhoud aan in Alle Storeviews en voeg daarna vertalingen toe per storeview
• Controleer na het toevoegen van vertalingen de frontend in elke storeview

Symptomen:

• De FAQ-pagina wordt weergegeven met de titel en optionele introtekst, maar er verschijnen geen FAQ-accordeons

Oplossing:

1. Controleer het tabblad Toegewezen topics op de pagina — er moet minstens één topic zijn toegewezen
2. Verifieer dat de toegewezen topic(s) zijn ingesteld op Is Actief: Ja
3. Verifieer dat de topic(s) actieve FAQ's hebben
4. Controleer de positiewaarden van de topics — ze moeten numeriek zijn

Preventie:

• Een pagina heeft nodig: actieve pagina → actief(ve) topic(s) toegewezen → actieve FAQ('s) in die topics. Alle drie niveaus moeten actief zijn om inhoud te tonen.

Symptomen:

• "Met Topic Iconen" design gebruikt maar iconen verschijnen niet
• Icoon-upload slaagt in de admin maar geen afbeelding op de frontend

Oplossing:

1. Verifieer dat u een design thema hebt geselecteerd dat iconen bevat (Hyva - Met Topic Iconen of Luma - Met Topic Iconen)
2. Controleer of het icoon succesvol is geüpload — bewerk het topic en verifieer dat het icoonvoorbeeld zichtbaar is
3. Verifieer dat het icoonbestand bestaat in pub/media/faq/topic/icon/
4. Controleer bestandsrechten op de mediamap

Preventie:

• Gebruik SVG-formaat voor de beste compatibiliteit en kwaliteit
• Houd icoonbestanden onder 2 MB