Probleemoplossing
Heeft u problemen met eKomi Reviews? Deze pagina behandelt de meest voorkomende problemen en hoe u ze kunt oplossen. Begin met de snelle diagnostiek sectie om te bepalen wat er mis is, spring dan naar het relevante probleem. We hebben ook debugging tips toegevoegd en wat u moet controleren wanneer dingen niet werken zoals verwacht.
Veelvoorkomende problemen en oplossingen voor eKomi Reviews.
Snelle Diagnostiek
Voordat u in specifieke problemen duikt, doorloop deze controles:
-
Controleer of module is ingeschakeld
bin/magento module:status Magmodules_EkomiSR -
Leeg alle caches
bin/magento cache:flush -
Voer de zelftest uit
bin/magento shopreview:ekomi:selftest -
Controleer logs op fouten
- Algemene fouten:
var/log/ekomi_sr_error.log - Debug info:
var/log/ekomi_sr_debug.log(vereist debug modus ingeschakeld)
- Algemene fouten:
-
Verifieer dat cron draait
bin/magento cron:run --group=default
Veelvoorkomende Problemen
Probleem: Reviews worden niet geïmporteerd
Symptomen:
- Geen reviews verschijnen in Marketing → eKomi → Reviews
- Reviewtelling blijft op nul
- Frontend toont "Geen reviews gevonden"
Oplossing:
-
Verifieer accountgegevens
- Ga naar Marketing → eKomi → Accounts Beheren
- Controleer of Interface ID en Interface Password correct zijn
- Probeer het account opnieuw op te slaan - het zou automatisch shopgegevens moeten ophalen
-
Controleer of account is geselecteerd
- Ga naar Winkels → Configuratie → Magmodules → eKomi Reviews → Accounts
- Zorg dat uw account is geselecteerd in het Accounts veld
-
Handmatige sync test
bin/magento shopreview:ekomi:sync --allLet op foutmeldingen in de output.
-
Controleer eKomi dashboard
- Log in op eKomi en verifieer dat u daadwerkelijk reviews heeft
- Nieuwe accounts hebben mogelijk nog geen reviews
Preventie:
- Test accountgegevens direct na setup
- Voer handmatige sync uit na toevoegen van nieuw account
Probleem: Reviews worden niet getoond op frontend
Symptomen:
- Reviews bestaan in admin (Marketing → eKomi → Reviews)
- Frontend pagina toont leeg of "Geen reviews gevonden"
- Widget toont niets
Oplossing:
-
Controleer review status
- Ga naar Marketing → eKomi → Reviews
- Verifieer dat reviews status "Goedgekeurd" hebben
- Als status "In Afwachting" is, keur handmatig goed of schakel Auto Approve in
-
Verifieer dat frontend is ingeschakeld
- Winkels → Configuratie → Magmodules → eKomi Reviews → Frontend
- Zet Inschakelen op Ja
-
Controleer locale instellingen
- Als taalfilter is ingeschakeld, verifieer dat overeenkomende talen zijn geselecteerd
- Uw Standaard Taal moet overeenkomen met uw review-talen
-
Leeg full page cache
bin/magento cache:flush full_page -
Controleer widget configuratie
- Voor widgets, verifieer dat de widget is toegewezen aan de juiste pagina's
- Controleer of layout updates zijn toegepast
Preventie:
- Schakel Auto Approve Reviews in voor directe weergave
- Stem locale instellingen af op uw eKomi account taal
Probleem: Uitnodigingen worden niet verstuurd
Symptomen:
- Klanten ontvangen geen reviewuitnodiging e-mails
- Uitnodigingswachtrij is leeg
- Bestellingen kwalificeren maar er gebeurt niets
Oplossing:
-
Controleer of uitnodigingsprofiel bestaat en is ingeschakeld
- Ga naar Marketing → eKomi → Uitnodigingsprofielen
- Verifieer dat minimaal één profiel is ingeschakeld
-
Verifieer profiel criteria
- Bestelstatus: Komt het overeen met uw bestellingen? (bijv. Compleet)
- Storeview: Is de juiste winkel geselecteerd?
- Klantgroepen: Zitten uw klanten in de geselecteerde groepen?
- Niet Ouder Dan: Is de waarde redelijk? (oudere bestellingen worden overgeslagen)
-
Controleer vertraging instellingen
- Als vertraging is ingesteld op 168 uur (7 dagen), verschijnen uitnodigingen niet direct
- Controleer Gepland Op kolom in uitnodigingswachtrij
-
Voer wachtrij handmatig uit
bin/magento cron:run --group=default -
Controleer uitnodigingswachtrij
- Ga naar Marketing → eKomi → Uitnodigingswachtrij
- Zoek naar wachtende uitnodigingen en hun geplande tijden
Preventie:
- Begin met korte vertraging (24 uur) voor testen
- Gebruik "Niet Ouder Dan: 7 dagen" initieel om alleen recente bestellingen te verwerken
Probleem: Dubbele uitnodigingen
Symptomen:
- Klanten ontvangen meerdere uitnodiging e-mails voor één bestelling
- Dezelfde bestelling verschijnt meerdere keren in uitnodigingswachtrij
Oplossing:
-
Controleer op overlappende profielen
- Ga naar Marketing → eKomi → Uitnodigingsprofielen
- Zoek naar profielen die dezelfde bestellingen matchen:
- Dezelfde storeview
- Dezelfde klantgroepen
- Dezelfde bestelstatus
-
Schakel dubbele profielen uit
- Houd slechts één profiel per storeview/klantgroep combinatie
- Of gebruik verschillende bestelstatussen om te differentiëren
-
Ruim bestaande wachtrij op
- Controleer uitnodigingswachtrij op duplicaten
- Verwijder dubbele entries handmatig indien nodig
Preventie:
- Plan uw uitnodigingsprofielen voordat u ze aanmaakt
- Gebruik onderscheidende criteria voor elk profiel (verschillende winkels, klantgroepen, of statussen)
Probleem: API verbindingsfouten
Symptomen:
- Foutmeldingen die "API" of "verbinding" noemen
- Reviews worden niet geïmporteerd
- Zelftest toont API fouten
Oplossing:
-
Verifieer credentials
- Dubbelcheck Interface ID en Interface Password
- Voer credentials opnieuw in en sla op
-
Controleer server connectiviteit
- Verifieer dat uw server
api.ekomi.dekan bereiken
curl -I https://api.ekomi.de - Verifieer dat uw server
-
Controleer firewall/proxy instellingen
- Zorg dat uitgaand HTTPS (poort 443) is toegestaan
- Als u een proxy gebruikt, configureer deze in Magento
-
Schakel debug modus in
- Zet debug modus aan om gedetailleerde API responses te zien
- Controleer
var/log/ekomi_sr_debug.logvoor details
-
Neem contact op met eKomi support
- Als credentials correct zijn maar API faalt, kan er een probleem zijn aan eKomi's kant
Preventie:
- Voer periodiek zelftest uit om connectiviteitsproblemen vroeg te vangen
- Monitor error logs voor API failures
Probleem: Cron draait niet
Symptomen:
- Reviews worden niet automatisch geïmporteerd
- Uitnodigingen worden niet volgens schema verstuurd
- Laatste sync tijd wordt nooit bijgewerkt
Oplossing:
-
Verifieer dat Magento cron is geconfigureerd
crontab -l | grep magentoU zou entries voor Magento cron moeten zien.
-
Controleer cron schema
bin/magento cron:run --group=default -
Zoek naar cron fouten
- Controleer
var/log/cron.log - Controleer
var/log/system.log
- Controleer
-
Verifieer dat cron jobs bestaan
SELECT * FROM cron_schedule WHERE job_code LIKE '%ekomi%'; -
Reset vastgelopen cron jobs
DELETE FROM cron_schedule WHERE job_code LIKE '%ekomi%' AND status = 'running';
Preventie:
- Stel cron monitoring in
- Controleer cron gezondheid regelmatig
Probleem: Widget wordt niet weergegeven
Symptomen:
- Widget gebied is leeg
- Widget toont in admin maar niet op frontend
- "Widget" placeholder zichtbaar maar geen inhoud
Oplossing:
-
Verifieer dat widget is toegewezen
- Ga naar Content → Widgets
- Controleer dat de widget Layout Updates heeft geconfigureerd
- Verifieer dat pagina's/posities correct zijn
-
Controleer widget instellingen
- Open de widget
- Verifieer dat account is geselecteerd (indien vereist)
- Controleer aantal te tonen reviews
-
Leeg block cache
bin/magento cache:clean block_html full_page -
Controleer op JavaScript fouten
- Open browser developer tools (F12)
- Zoek naar JS fouten in console
- Slider widgets vereisen JavaScript om te initialiseren
-
Test eerst met simpele widget
- Probeer de basis Review Widget voordat u slider probeert
- Gebruik "Plain" modus om layout problemen uit te sluiten
Preventie:
- Test widgets op een staging omgeving eerst
- Verifieer dat JavaScript dependencies zijn geladen
Probleem: Verkeerde beoordeling weergave
Symptomen:
- Sterren tonen incorrecte waarden (bijv. 4/10 in plaats van 4/5)
- Beoordelingsschaal komt niet overeen met eKomi dashboard
- Visuele beoordeling komt niet overeen met numerieke waarde
Oplossing:
-
Controleer beoordelingsschaal instelling
- Ga naar Winkels → Configuratie → Magmodules → eKomi Reviews → Accounts
- Verifieer dat Beoordelingsschaal overeenkomt met uw eKomi account
-
Verifieer in eKomi dashboard
- Log in op eKomi
- Controleer welk beoordelingssysteem uw account gebruikt
-
Update en synchroniseer opnieuw
- Corrigeer de beoordelingsschaal instelling
- Leeg cache
- Reviews zouden nu correct moeten weergeven
Preventie:
- Stel beoordelingsschaal in tijdens initiële setup
- Verifieer met een test review
Debug Modus
Debug Modus Inschakelen
- Ga naar Winkels → Configuratie → Magmodules → eKomi Reviews → Debug
- Zet Debug Modus op Ja
- Sla op en leeg cache
Debug Logs Lezen
Log locatie: var/log/ekomi_sr_debug.log
De log bevat:
- API requests en responses
- Cron job uitvoering details
- Import/sync operaties
- Wachtrij verwerking informatie
Waar te Zoeken
- API fouten: Zoek naar HTTP status codes en foutmeldingen
- Authenticatie problemen: "Invalid credentials" of vergelijkbaar
- Data problemen: Ontbrekende velden, verkeerde formaten
- Timing: Wanneer operaties starten en voltooien
Debug Modus Uitschakelen
Schakel debug modus altijd uit na troubleshooting:
- Zet Debug Modus op Nee
- Sla op en leeg cache
- Optioneel: verwijder/archiveer het debug logbestand
Hulp Krijgen
Als u deze oplossingen heeft geprobeerd en nog steeds problemen heeft:
-
Verzamel informatie
- Magento versie
- PHP versie
- Extensie versie (uit composer.json of admin)
- Foutmeldingen uit logs
- Zelftest resultaten
-
Controleer error logs
var/log/ekomi_sr_error.logvar/log/ekomi_sr_debug.logvar/log/exception.log
-
Neem contact op met support met details
- Voeg de verzamelde informatie hierboven toe
- Beschrijf wat u al heeft geprobeerd
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team