Probleemoplossing OpenAI Commerce Extensie
Veelvoorkomende problemen en oplossingen voor de OpenAI Commerce extensie. Begin met snelle diagnostiek, vind dan uw specifieke probleem hieronder.
Snelle Diagnostiek
- Controleer module ingeschakeld: Magmodules → OpenAI - Feed Configuration → General → Enable
- Controleer feed generatie ingeschakeld: Generation → Enable (per store view)
- Verifieer cron draait: Controleer
cron_scheduletabel of voer feed generatie handmatig uit - Controleer logs:
var/log/voor debug informatie
Veelvoorkomende Problemen
Probleem: Feed is leeg of heeft geen producten
Symptomen:
- Feed genereert maar bevat 0 producten
- Feed bestand is erg klein
Oplossingen:
-
Controleer visibility filter:
- Filter Options → Visibility → Zorg dat correcte visibilities geselecteerd zijn
- De meeste producten moeten "Catalog" of "Catalog, Search" zijn
-
Controleer voorraad filter:
- Als "Exclude Out of Stock" ingeschakeld is, zorg dat producten op voorraad zijn
-
Controleer categorie filter:
- Als categorie filter ingeschakeld is, zorg dat producten in opgenomen categorieën zitten
-
Controleer product type instellingen:
- Voor configurable products: Als ingesteld op "Only Linked Simple Products", zorg dat simples bestaan en ingeschakeld zijn
Preventie: Begin met minimale filters, voeg dan beperkingen toe zodra feed werkt.
Probleem: Feed generatie faalt of timeout
Symptomen:
- Feed generatie wordt nooit voltooid
- PHP timeout fouten in logs
- Memory exhausted fouten
Oplossingen:
-
Voer uit via CLI in plaats van admin:
bin/magento mm-openai:feed:create --store-id=1CLI heeft langere timeouts en geen browser beperkingen.
-
Verklein feed grootte:
- Voeg filters toe om onnodige producten uit te sluiten
- Schakel categorie filtering in om te focussen op relevante producten
-
Verhoog PHP limieten (tijdelijk):
- Verhoog
max_execution_timeenmemory_limitvoor CLI
- Verhoog
Probleem: Producten ontbreken in feed
Symptomen:
- Specifieke producten verschijnen niet in feed
- Product aantal is lager dan verwacht
Oplossingen:
-
Controleer product status:
- Product moet Enabled zijn
- Controleer of "Add disabled products" correct ingesteld is
-
Controleer visibility:
- Product visibility moet overeenkomen met filter instellingen
- "Not Visible Individually" producten kunnen uitgesloten zijn
-
Controleer voorraad status:
- Als out-of-stock filter ingeschakeld is, controleer voorraad status
-
Controleer categorie toewijzing:
- Als categorie filter actief is, moet product in opgenomen categorie zitten
-
Controleer advanced filters:
- Review eventuele aangepaste filter condities
Debug tip: Schakel Debug Mode in en controleer logs voor waarom specifieke producten uitgesloten zijn.
Probleem: Ongeldige JSON in feed
Symptomen:
- Feed URL geeft fout
- JSON parsing faalt
- Ongeldige karakters in output
Oplossingen:
-
Controleer productbeschrijvingen:
- Verwijder of repareer producten met speciale karakters die niet UTF-8 gecodeerd zijn
- Controleer op controle karakters in tekstvelden
-
Verifieer attribuutwaarden:
- Zorg dat gemapte attributen geldige data bevatten
- Controleer op NULL of lege vereiste waarden
-
Regenereer feed:
bin/magento mm-openai:feed:create --store-id=1
Probleem: Verkoperdata verschijnt niet in feed
Symptomen:
- Feed genereert maar mist verkoperinformatie
- Beleid niet gelinkt
Oplossingen:
-
Controleer verkoper configuratie:
- Seller Data → Seller Name moet ingevuld zijn
- Beleidspagina's moeten geselecteerd zijn (niet alleen aangemaakt)
-
Verifieer CMS pagina's bestaan:
- Controleer dat geselecteerde CMS pagina's ingeschakeld zijn
- Zorg dat pagina's inhoud hebben
-
Sla configuratie op:
- Na wijzigingen, klik Save Config
- Wis cache indien nodig
Probleem: Afbeeldingen verschijnen niet in feed
Symptomen:
- Producten tonen geen afbeeldingen in feed
- Afbeelding URLs zijn leeg of ongeldig
Oplossingen:
-
Controleer image source instelling:
- Attributes → Source → Probeer "All Images" of specifieke image role
-
Voor configurable products:
- Product Types → Use Parent Image for Simples → "Only if Empty"
- Zorgt dat parent afbeeldingen gebruikt worden wanneer simples geen afbeeldingen hebben
-
Verifieer afbeelding URLs:
- Controleer dat uw base URL correct geconfigureerd is
- Zorg dat media URLs toegankelijk zijn van buitenaf
Probleem: Feed URL geeft 404
Symptomen:
- Klik feed URL maar pagina niet gevonden
- Feed bestand bestaat niet
Oplossingen:
-
Controleer feed was gegenereerd:
- Zoek naar bestand in
var/export/openai/directory - Controleer generatie timestamp in admin
- Zoek naar bestand in
-
Regenereer feed:
- Klik Generate knop of voer CLI commando uit
-
Controleer bestandsrechten:
- Zorg dat webserver kan schrijven naar
var/export/directory
- Zorg dat webserver kan schrijven naar
Debug Mode
Schakel gedetailleerde logging in:
- Ga naar OpenAI - Feed Configuration → Debug
- Zet Debug Mode op Yes
- Sla op en regenereer feed
- Controleer
var/log/voor gedetailleerde logs
Onthoud: Schakel debug mode uit in productie wanneer troubleshooting klaar is.
CLI Commando's voor Troubleshooting
# Genereer feed handmatig (omzeilt cron)
bin/magento mm-openai:feed:create --store-id=1
# Genereer alle feeds
bin/magento mm-openai:feed:create
# Ruim oude feed bestanden op
bin/magento mm-openai:feed:cleanup
CLI output toont voortgang en eventuele fouten tijdens generatie.
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team