Omnibus Richtlijn probleemoplossing | Magento 2
Op zoek naar Omnibus Directive? Bekijk de volledige Omnibus Directive pagina voor functies, configuratieopties en prijzen.
Problemen met de Omnibus Richtlijn extensie? Deze pagina behandelt de problemen die we het vaakst zien: de laagste prijs die niet verschijnt, een waarde die je niet verwacht, configureerbare producten, prijswijzigingen in de queue die niet aankomen, en wat elke uitkomst van de selftest betekent. Begin met de snelle diagnose, die lost de meeste gevallen binnen een minuut op, en ga daarna naar het probleem dat overeenkomt met wat je ziet. Onderaan lees je hoe je debug logging aanzet en waar je in de logs op let.
Veelvoorkomende problemen en oplossingen voor Omnibus Richtlijn.
Snelle diagnose
- Controleer of de module aan staat voor de store view (Winkels → Configuratie → Magmodules → Omnibus Directive → General)
- Klik op Run Self-test bovenaan de configuratiepagina
- Controleer of het product prijshistorie heeft: Catalogus → Voorraad → Omnibus Price History, filter op de SKU
- Leeg de full page cache
- Bekijk de logs:
var/log/omnibus-directive-error.logen, met debug mode aan,var/log/omnibus-directive-debug.log
Veelvoorkomende problemen
Probleem: De laagste prijs wordt helemaal niet getoond
Symptomen:
- Geen regel "Laagste prijs in de afgelopen 30 dagen" op product- of categoriepagina's
Oplossing:
- Controleer de weergavemodus. Met "Only on Sale" verschijnt de regel alleen als de eindprijs lager is dan de normale prijs. Zet tijdelijk "Always" aan om te bevestigen dat de module werkt.
- Controleer "Show on Listing" en "Show on Product Page".
- Controleer of het product niet is uitgesloten (Exclude SKUs, Exclude Categories) en of "Hide Omnibus Lowest Price" op No staat.
- Controleer of het product historie heeft in het prijshistorie-grid. Zo niet, voer dan uit:
bin/magento omnibus:snapshot --product-id=123 - Controleer de status van de indexer en bouw hem zo nodig opnieuw op:
bin/magento indexer:status mm_omnibus_lowest_price bin/magento indexer:reindex mm_omnibus_lowest_price - Leeg de full page cache.
Voorkomen:
- Houd de cron draaiende, zodat de dagelijkse snapshot en de indexer-updates plaatsvinden
Probleem: De laagste prijs is gelijk aan de actieprijs
Symptomen:
- Het product is afgeprijsd, maar de laagste prijs toont hetzelfde bedrag als de huidige prijs
Oplossing:
- Open het prijshistorie-grid voor het product. Is de eerste regel de actieprijs, dan begon de prijsverlaging voordat de module werd ingeschakeld en is er geen eerdere prijs om mee te vergelijken.
- Toont de historie een eerdere, hogere prijs die meer dan 30 dagen vóór het begin van de prijsverlaging eindigde, dan valt die buiten het terugkijkvenster en wordt hij terecht genegeerd.
- Loopt de actie al langer dan de terugkijkperiode plus 7 dagen, dan is de eerdere prijs opgeruimd en geldt de actieprijs nu als normale prijs.
Voorkomen:
- Zet de module minstens 30 dagen vóór een actie aan
Probleem: Configureerbaar product toont niets
Symptomen:
- Simpele producten tonen de laagste prijs, een configureerbaar product niet
Oplossing:
- Controleer of "Track Configurable Products" op Yes staat.
- Controleer of het configureerbare product op voorraad is. Magento toont helemaal geen prijs bij een configureerbaar product dat niet op voorraad is, dus er is niets om de laagste prijs naast te zetten.
- Controleer of minstens één variant ingeschakeld is, op voorraad is en aan de website is gekoppeld.
- Voer
bin/magento omnibus:snapshot --product-id=<id van het configureerbare product>uit.
Tip: Zolang er geen optie is gekozen, toont het configureerbare product de laagste prijs van zijn goedkoopste variant. Na het kiezen van een optie of swatch schakelt de regel over naar de laagste prijs van die variant, of verdwijnt hij als die variant niet is afgeprijsd.
Probleem: Prijswijzigingen uit imports of catalogusregels komen niet door
Symptomen:
- Prijzen zijn gewijzigd via een CSV-import, mass update of catalogusprijsregel, maar het prijshistorie-grid toont niets nieuws
Oplossing:
- Deze wijzigingen gaan via de queue
omnibus.price.snapshot. Controleer of de consumer draait:ps aux | grep omnibusPriceSnapshot - Zo niet, controleer dan of
cron_consumers_runnerinapp/etc/env.phpniet is uitgeschakeld, of start de consumer handmatig:bin/magento queue:consumers:start omnibusPriceSnapshot - Voor catalogusprijsregels: "Save and Apply" plant de regels alleen in. De prijzen worden toegepast wanneer de indexer cron de catalogusregel-index opnieuw opbouwt. Controleer
bin/magento indexer:status catalogrule_rule.
Voorkomen:
- Houd in de gaten dat de Magento cron en de queue consumers draaien
Probleem: Een gewijzigde instelling heeft geen effect
Symptomen:
- Je hebt de terugkijkperiode of de prijstypes aangepast, maar de laagste prijzen blijven gelijk
Oplossing:
- Deze instellingen zetten de Omnibus indexer op "Reindex required". Bouw hem opnieuw op:
bin/magento indexer:reindex mm_omnibus_lowest_price - Leeg de full page cache.
Probleem: De selftest meldt een mislukte controle
Oplossing per controle:
| Controle | Wat een mislukking betekent | Wat te doen |
|---|---|---|
| PHP-versie | PHP is ouder dan de module ondersteunt | Upgrade PHP naar 8.1 of hoger |
| Magento-versie | Magento is ouder dan de module ondersteunt | Upgrade Magento |
| Extensie ingeschakeld | De module staat uit in de standaard scope | Zet Enabled op Yes |
| Cron | Geen geslaagde cron job in het afgelopen uur | Herstel de Magento cron (crontab-regel voor bin/magento cron:run) |
| Indexer | De Omnibus indexer heeft een reindex nodig | bin/magento indexer:reindex mm_omnibus_lowest_price |
| Prijshistorie | Er is nog geen prijs vastgelegd | bin/magento omnibus:snapshot, of wacht op de dagelijkse cron |
Probleem: De prijshistorie-tabel blijft groeien
Symptomen:
- De tabel
mm_omnibus_price_historyis groter dan verwacht
Oplossing:
- Alleen prijswijzigingen worden opgeslagen, dus de groei hangt af van hoe vaak prijzen veranderen.
- De dagelijkse cron (02:00) verwijdert historie die ouder is dan de terugkijkperiode plus 7 dagen. Bekijk wat er verwijderd zou worden:
bin/magento omnibus:cleanup --dry-run - Voer de opschoning handmatig uit als de cron niet heeft gedraaid:
bin/magento omnibus:cleanup
De prijs die op dit moment geldt, wordt nooit verwijderd.
Debug Mode
- Ga naar Winkels → Configuratie → Magmodules → Omnibus Directive → Debug & Logging
- Zet Debug Mode op Yes
- Reproduceer het probleem (sla bijvoorbeeld een product op of voer een import uit)
- Klik op "Show last 100 debug log records" of open
var/log/omnibus-directive-debug.log
Waar je op let:
Product save: Product 123 (SKU): price change recorded- het opslaan van een product is vastgelegdPrice snapshot: Store 1: recorded 5 price change(s)- een snapshot heeft wijzigingen gevondenQueue publish/Queue consumer- imports en regels worden in de queue gezet en verwerktLowest price: Store 1: updated 5 lowest price(s)- laagste prijzen opnieuw berekend
Fouten worden altijd naar var/log/omnibus-directive-error.log geschreven. Zet debug mode weer uit als je klaar bent.
Meer Hulp Nodig?
Documentatie:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team
Voor een compleet overzicht van functies en configuratieopties, bekijk Omnibus Directive.