Omnibus Directive





Omnibus Directive voor Magento 2
De laagste prijs van de 30 dagen vóór een korting, naast elke actieprijs
Bij een korting een eerdere prijs tonen is in de EU geen keuze. Richtlijn 2019/2161, de Omnibusrichtlijn, verplicht dat je bij elke aangekondigde prijsverlaging de laagste prijs vermeldt die het product had in ten minste de 30 dagen vóór die verlaging. De extensie Omnibus Directive voor Magento 2 houdt die prijsgeschiedenis bij en zet de regel naast de prijs.
De extensie legt elke prijswijziging per store view vast: bij het opslaan van een product, bij imports, bij mass updates, bij catalogusprijsregels en met een dagelijkse snapshot. Uit die geschiedenis berekent ze de eerdere prijs en toont die op productpagina's, categoriepagina's, zoekresultaten en productwidgets, met een template voor Luma en een voor Hyvä.
Je stelt zelf de terugkijkperiode in, de prijstypes die meetellen, de labeltekst en de pagina's waarop de regel staat. De winkel leest uit een eigen index, dus er wordt niets berekend terwijl een pagina laadt.

Wat de Omnibus Directive-extensie doet
Automatische prijsgeschiedenis
Elke prijswijziging wordt per store view opgeslagen, bij het opslaan van producten, imports, mass updates, catalogusprijsregels en een dagelijkse snapshot.
De prijs die de richtlijn vraagt
De regel toont de laagste prijs in de 30 dagen voordat de huidige prijs inging, niet de laagste prijs teruggerekend vanaf vandaag.
Productpagina's, overzichten en zoekresultaten
Toon de regel op productpagina's, categoriepagina's, zoekresultaten en productwidgets, in Luma en in Hyvä.
Configureerbare producten
Het hoofdproduct volgt de goedkoopste ingeschakelde variant, en de regel past zich aan zodra de klant een optie of swatch kiest.
Zelf bepalen wat je toont
Kies de weergavemodus, de labeltekst en de positie, en sluit categorieën, SKU's of losse producten uit.
Gebouwd voor grote catalogi
Een eigen index en een message queue houden imports en prijsregels weg bij het laden van de pagina.
Wettelijk verplicht, geregeld met de standaardinstellingen
EU-richtlijn 2019/2161 geldt zodra je een prijsverlaging aankondigt: naast de nieuwe prijs moet de laagste prijs van de periode ervoor staan. De richtlijn stelt die periode op 30 dagen of meer, en "Lookback Period (days)" staat standaard op 30. In de admin staat de verwijzing naar de richtlijn direct onder het veld.
Onder "Price Types" kies je welke prijzen meetellen voor de bijgehouden eindprijs: "Special Price", "Catalog Price Rule" en "Tier Price (qty 1, all groups / NOT LOGGED IN)". "Regular Price" telt altijd mee, en standaard staan alle vier aan. De bijgehouden prijs is de laagste van de gekozen types.
De extensie volgt simple, virtual en downloadable producten, en configurable producten als "Track Configurable Products" op "Yes" staat. Wijzigingen op datum, zoals een special price met een startdatum, worden opgepikt door de dagelijkse snapshot om 01:30.


Zo wordt de laagste prijs berekend
De 30 dagen worden teruggeteld vanaf het moment waarop de huidige prijs inging. Een korting die al twee weken loopt, wordt dus nog steeds vergeleken met de prijzen van vóór de start, niet met de eigen actieprijs.
Neem een product dat maandenlang €100.00 kostte. Op 1 maart start een special price van €70.00 en toont de regel €100.00. Op 10 maart zakt de prijs verder naar €60.00 en toont de regel €70.00: de laagste prijs in de 30 dagen vóór die tweede stap. Op 20 maart gaat het product terug naar €100.00 en verdwijnt de regel in de modus "Only on Sale".
Een korting in stappen wordt dus altijd vergeleken met de vorige stap. Is er geen eerdere prijs bekend, dan wordt de huidige prijs gebruikt. Daarom loont het om prijzen vast te leggen voordat een actie begint.
Bepaal wanneer en waar de regel verschijnt
"Display Mode" heeft drie opties. "Only on Sale", de standaard, toont de regel als de eindprijs lager is dan de reguliere prijs. "Only when Different" toont de regel als de laagste prijs afwijkt van de huidige prijs, en "Always" toont de regel bij elk product met een prijsgeschiedenis.
In "Label Text" staat de zin vóór het bedrag. De standaard is "Lowest price in the %1 days before this discount:", waarbij %1 wordt vervangen door de terugkijkperiode. De standaardtekst is Engels en het veld stel je per store view in. Voor een Nederlandse store view vul je dus je eigen tekst in, bijvoorbeeld "Laagste prijs in de %1 dagen vóór deze korting:". Met "Display Position" zet je de regel na of vóór de prijs, en "Custom CSS Class" voegt je eigen class toe aan de wrapper.
"Show on Listing" gaat over categoriepagina's, zoekresultaten en productwidgets, "Show on Product Page" over de productpagina. Beide staan standaard aan. Het bedrag volgt de btw-weergave en de valuta van de store view.


Configureerbare producten volgen de gekozen variant
Met "Track Configurable Products" op "Yes" wordt een configurable product gevolgd met de laagste prijs van de ingeschakelde varianten. Dat is het bedrag dat de klant ziet voordat er een keuze is gemaakt.
Op de productpagina past de regel zich aan zodra een optie of swatch is gekozen: maat M toont de eerdere prijs van maat M, maat L die van maat L. Heeft een variant niets te tonen, dan verdwijnt de regel. Bij een onvolledige keuze komt de waarde van het hoofdproduct terug.
Dit werkt met dropdowns en swatches in Luma, en via het event configurable-selection-changed in Hyvä.
Optionele prijsgrafiek voor je klanten
"Show Chart on" zet een i-icoon naast de laagste prijs. Bij hover of toetsenbordfocus opent een kleine grafiek "Price history" met de prijs in de terugkijkperiode. Kies "Product page", "Category pages, search results and widgets", of allebei. Laat je het veld leeg, zoals standaard, dan is er geen grafiek.
De grafiek is een traplijn, omdat een prijs geldt tot de volgende wijziging. Ze wordt op de server opgebouwd als inline SVG, dus er wordt geen JavaScript-bibliotheek geladen in de winkel. Het icoon verschijnt alleen als er minstens twee prijspunten zijn om te tekenen.


Sluit categorieën, SKU's of één product uit
Niet elk product hoeft de regel te tonen. "Exclude Categories" verbergt de regel voor alle producten in de gekozen categorieën, en in "Exclude SKUs" vul je een lijst met SKU's in, gescheiden door komma's of nieuwe regels.
Voor uitgesloten categorieën en SKU's wordt de prijsgeschiedenis gewoon bijgehouden. Haal je de uitsluiting later weg, dan staat de regel er weer met het juiste bedrag.
Voor één product is er het attribuut "Hide Omnibus Lowest Price" in het productformulier, dat je per store view instelt.
Zelftest, logs en commando's om de data te controleren
De knop "Run Self-test" bovenaan de configuratiepagina controleert de opzet na installatie. Met "Debug Mode" aan worden prijswijzigingen, snapshots en herberekeningen in een debuglog geschreven. Fouten komen altijd in de errorlog. Beide logs hebben een eigen knop in de configuratie: "Debug Log" en "Error Log".
Voor de command line zijn er drie commando's:
bin/magento omnibus:snapshotlegt de huidige prijzen vast, naar keuze met--product-id,--store-idof--async.bin/magento omnibus:recomputeberekent de laagste prijzen opnieuw uit de geschiedenis, met--all,--product-idof--store-id.bin/magento omnibus:cleanupruimt oude geschiedenis op, met--daysen een--dry-runom eerst het effect te zien.


Elke vastgelegde prijs in één overzicht
Onder "Catalog" > "Inventory" > "Omnibus Price History" is elke vastgelegde prijswijziging een rij, met de kolommen "Product Name", "SKU", "Store View", "Price", "Special Price", "Final Price" en "Date". Je ziet wanneer een prijs veranderde en wat de bijgehouden eindprijs op dat moment was.
"Snapshot now" legt de huidige prijzen direct vast, bijvoorbeeld meteen na installatie of vóór een actie. "View history" opent de geschiedenis van één product, met de laagste prijs van de terugkijkperiode en een knop "Edit Product".
Omnibus Directive voor Magento 2: technische details voor developers en winkeliers
De voordelen voor developers
- Index: de winkel leest alleen uit de index
mm_omnibus_lowest_price. Overzichtspagina's laden alle producten van de collectie in één query. - Queue: imports, mass updates en catalogusprijsregels lopen via de queue
omnibus.price.snapshot. Het opslaan van een product wordt direct verwerkt. - Cache: verandert een laagste prijs, dan wordt de full page cache van dat product geleegd op cache tag.
- Markup:
div.omnibus-price[data-role="omnibus-price"]met.omnibus-price__labelen.omnibus-price__value, plus je eigen class uit "Custom CSS Class". - Thema's: een Luma-template en een Hyvä-template met Tailwind-classes. Op Hyvä is de productpagina afgedekt voor het View-blok (tot en met 1.3) en het Price-blok (1.4 en hoger).
- Vereisten: Magento 2.4.4 of hoger en PHP 8.1 of hoger.
Goed om te weten voor winkeliers
- Uit na installatie: zet de extensie aan met "Enabled" onder "Stores" > "Configuration" > "Magmodules" > "Omnibus Directive".
- Geen geschiedenis van vroeger: het bijhouden begint zodra de extensie aanstaat. Draai meteen "Snapshot now" of
bin/magento omnibus:snapshot, en doe dat voordat een actie start. Een product dat bij de eerste snapshot al is afgeprijsd, krijgt de actieprijs als laagste prijs. - Lange kortingen: geschiedenis wordt bewaard voor de terugkijkperiode plus 7 dagen. Loopt een korting langer, dan vervalt de eerdere referentieprijs en wordt de actieprijs de laagste prijs.
- Alleen productprijzen: de extensie volgt reguliere prijzen, special prices, catalogusprijsregels en tier prices. Kortingen via winkelwagenregels, of kortingen die alleen in een banner worden aangekondigd, vallen erbuiten.
- Tier prices: deze tellen mee voor aantal 1, voor alle groepen of voor klanten die niet zijn ingelogd.
- Producttypes: bundle- en grouped-producten worden niet gevolgd.
- Datums: een special price of prijsregel die op datum ingaat, wordt vastgelegd door de dagelijkse snapshot om 01:30. Het vastgelegde moment kan dus tot een dag achterlopen.
- Scope: de instellingen onder "Pricing" gelden per website, die onder "Frontend" per store view.
Toon de verplichte laagste prijs bij je kortingen
De Omnibus Directive-extensie legt je prijsgeschiedenis vast vanaf de dag dat je haar aanzet. Installeer de extensie vóór je volgende actie, zodat de 30 dagen zijn vastgelegd op het moment dat de korting start.
Kennisbank
Alle bekende helpartikelen
Een lijst met de meest gestelde vragen over de Omnibus Directive-extensie voor Magento 2. We hebben ons best gedaan om je te helpen met de installatie, configuratie en probleemoplossing. Als je het antwoord dat je zocht niet kunt vinden, kun je ons altijd een bericht sturen via dit formulier.
Installatieartikelen
Configuratie
Kwaliteit
Goedgekeurd, compatibel en getest

Adobe Commerce Goedgekeurd door Marketplace
Deze extensie staat op de officiele Adobe Commerce Marketplace en heeft het reviewproces doorlopen op codekwaliteit, performance en beveiliging.
Goedkeuring via de Adobe Marketplace betekent dat de extensie voldoet aan de Magento coding standards en correct integreert met het platform. Updates doorlopen hetzelfde reviewproces.

Hyvä Compatibele Plugin
Deze extensie biedt volledige ondersteuning voor Hyva Themes. Alle frontend-componenten, widgets en templates werken native met Hyva's Alpine.js en Tailwind CSS stack.
De extensie werkt direct op Hyva en wordt bij elke nieuwe Hyva-release getest om compatibiliteit te blijven garanderen.

GraphQL Klaargemaakt
Deze extensie stelt data en configuratie beschikbaar via Magento's GraphQL API. Je kunt data direct opvragen en muteren vanuit headless frontends of eigen applicaties.
Het GraphQL-schema volgt de conventies van Magento en dekt alle kernfunctionaliteit van de extensie. Hierdoor is het geschikt voor PWA Studio, Vue Storefront of elke andere headless setup.

Magento Cloud Ondersteuning
Deze extensie is volledig compatibel met Adobe Commerce Cloud (Magento Cloud). Het werkt met het read-only filesystem, de build- en deploy-pipeline en cloud-specifieke caching-lagen.
Er is geen extra configuratie of workaround nodig voor cloud-omgevingen. De extensie gaat op dezelfde manier om met static content deployment en configuratiebeheer als bij on-premise installaties.

Privé Composer Repo
Na aankoop krijg je toegang tot een prive Composer-repository met persoonlijke credentials. Installeer en update de extensie met een enkel composer-commando, net als elke andere dependency.
Je Composer-credentials zijn beschikbaar in je accountdashboard. Updates worden gepubliceerd zodra een nieuwe versie beschikbaar is, zodat je altijd toegang hebt tot de laatste versie.