Probleemoplossing Spotler Activate Search

Symptomen:

• Feed Log toont errors
• CLI commando geeft error terug
• Leeg of incompleet feed bestand

Oplossing:

1. Schakel debug mode in: Spotler > General > Debug > Debug Mode = Yes
2. Voer feed generatie uit: bin/magento sooqr:feed:create
3. Controleer logs:

   tail -200 var/log/sooqr-debug.log
   

Veelvoorkomende oorzaken:

• Geheugenlimiet overschreden (verlaag batch size)
• Database timeout (controleer langzame queries)
• Ongeldige productdata (specifiek product veroorzaakt error)

Preventie: Voer feed generatie uit tijdens daluren voor grote catalogi.

Symptomen:

• Minder producten in Spotler dan verwacht
• Specifieke producten verschijnen niet in zoekresultaten

Oplossing:

1. Controleer product zichtbaarheid: Moet "Catalog", "Search", of "Catalog, Search" zijn
2. Controleer product status: Moet Enabled zijn
3. Controleer voorraadstatus: Als "Exclude Out of Stock" is ingeschakeld
4. Controleer categorie filters: Product moet in geïncludeerde categorieën zijn

Voor configureerbare producten:

• Simple producten moeten ook aan filtercriteria voldoen
• Controleer of "Only Linked Simple Products" is geselecteerd

Debug specifiek product: Schakel debug mode in en controleer logs voor waarom product werd overgeslagen.

Symptomen:

• 404 bij toegang tot feed URL
• Spotler kan feed niet ophalen

Oplossing:

1. Verifieer dat feed was gegenereerd: Controleer Feed Log
2. Controleer of bestandsnaam in configuratie overeenkomt
3. Verifieer dat webserver XML bestanden kan serveren vanuit pub/media/sooqr/
4. Controleer bestandspermissies op gegenereerde feed

Test lokaal:

curl -I https://uwwinkel.com/media/sooqr/feed.xml

Symptomen:

• Producten linken naar verkeerde pagina
• Simple producten linken niet naar parent

Oplossing: Controleer Product Types configuratie:

• Use Parent URL for Simples zou "Yes" of "Yes, with Auto-Link" moeten zijn
• Verifieer dat URL rewrites zijn ingeschakeld in Magento

Symptomen:

• Producten tonen zonder afbeeldingen in Spotler
• Placeholder afbeeldingen verschijnen

Oplossing:

1. Controleer Image Source instelling in Product Data
2. Verifieer dat producten afbeeldingen toegewezen hebben
3. Voor simples: Controleer "Use Parent Image for Simples" instelling
4. Zorg dat image cache is gegenereerd: bin/magento catalog:images:resize

Symptomen:

• Typen in zoekvak toont native Magento resultaten
• Geen Spotler overlay

Oplossing:

1. Verifieer Enable Search = Yes
2. Controleer of Account ID is geconfigureerd voor de store view
3. Leeg full page cache
4. Controleer browser console op JavaScript errors

Controleer script laden: Bekijk paginabron, zoek naar "sooqr" - het loader script zou aanwezig moeten zijn.

Veelvoorkomende oorzaken:

• Account ID ontbreekt of verkeerd formaat
• JavaScript conflict met andere extensies
• CSP blokkeert het Spotler script

Symptomen:

• Spotler overlay verschijnt maar is leeg
• "Geen resultaten gevonden" voor alles

Oplossing:

1. Verifieer dat feed succesvol was opgehaald door Spotler
2. Controleer Spotler dashboard - is de index gebouwd?
3. Regenereer feed en wacht tot Spotler opnieuw indexeert

Let op: Na eerste feed generatie heeft Spotler tijd nodig om te indexeren. Kan tot een uur duren.

Symptomen:

• Klikken op "Toevoegen aan winkelwagen" in zoekresultaten doet niets
• Foutmeldingen bij toevoegen

Oplossing:

1. Verifieer Add to Cart Controller = Yes in Search configuratie
2. Controleer op JavaScript errors in browser console
3. Voor Ajax: Verifieer "Use Ajax based Add to Cart" = Yes

Veelvoorkomende oorzaak: Form key problemen. Leeg cache en probeer opnieuw.

Symptomen:

• Geen zoekdata in Spotler analytics
• Klik tracking werkt niet

Oplossing:

1. Verifieer Statistics = Yes in Search configuratie
2. Controleer browser console op geblokkeerde requests
3. Verifieer dat CSP Spotler tracking niet blokkeert

Symptomen:

• Generatie duurt uren
• Timeouts tijdens generatie

Oplossing:

1. Verlaag batch size in configuratie
2. Voer uit tijdens daluren
3. Controleer op langzame database queries
4. Schakel debug mode uit indien ingeschakeld

Voor zeer grote catalogi:

• Overweeg filteren om productaantal te reduceren
• Plan via cron in plaats van handmatige generatie

Symptomen:

• Lange vertraging voordat resultaten verschijnen
• Overlay laadt langzaam

Oplossing: Dit is meestal een Spotler-kant probleem, niet de extensie. Controleer:

1. Netwerk latentie naar Spotler CDN
2. Index grootte in Spotler dashboard
3. Neem contact op met Spotler support voor server-side problemen

Navigeer naar: Spotler > General > Debug > Debug Mode = Yes

var/log/sooqr-debug.log

# Recente entries
tail -100 var/log/sooqr-debug.log

# Volg in real-time tijdens generatie
tail -f var/log/sooqr-debug.log

• Redenen waarom product werd overgeslagen
• API call responses
• Foutmeldingen
• Verwerkingstijd per batch