Pas uitgebracht

Omnibus Directive


Toon bij een prijsverlaging de laagste prijs van de 30 dagen ervoor op productpagina's, categoriepagina's en zoekresultaten, zoals EU-richtlijn 2019/2161 verplicht. De prijsgeschiedenis wordt automatisch per store view vastgelegd.
Links
15 dagen geld-terug-garantie Eenmalige betaling
Magento Cloud Ondersteuning GraphQL Ondersteuning Hyvä Ondersteuning Adobe Goedgekeurd Privé Composer Repo
Documentatie

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.

Productpagina van de Fjord Table Lamp bij Nordic Living met een actieprijs van €70.00 en daaronder de regel met de laagste prijs in de 30 dagen voor de korting, €100.00

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.

Pricing-instellingen met Lookback Period (days) op 30, de vier prijstypes geselecteerd en Track Configurable Products op Yes
Prijslijn van een product dat op 1 maart van €100.00 naar €70.00 gaat en op 10 maart naar €60.00, met de 30 dagen voor 10 maart gemarkeerd en €70.00 als laagste prijs in die periode

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.

Frontend-instellingen met Display Mode op Only on Sale, de labeltekst en de positie, naast een categoriepagina waarop alleen de afgeprijsde lamp de regel met de laagste prijs toont
Twee weergaven van de productpagina van de Linen Bathrobe: met maat M gekozen toont de regel €79.00, met maat L gekozen €89.00

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.

Show Chart on ingesteld op Product page, naast een productprijs waarbij het i-icoon achter de regel met de laagste prijs een kleine grafiek Price history opent
Exclude Categories met de categorie Outlet geselecteerd en Exclude SKUs met twee SKU's, naast het productattribuut Hide Omnibus Lowest Price op Yes

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:snapshot legt de huidige prijzen vast, naar keuze met --product-id, --store-id of --async.
  • bin/magento omnibus:recompute berekent de laagste prijzen opnieuw uit de geschiedenis, met --all, --product-id of --store-id.
  • bin/magento omnibus:cleanup ruimt oude geschiedenis op, met --days en een --dry-run om eerst het effect te zien.
Logging-instellingen met Debug Mode en de knoppen Debug Log en Error Log, naast een terminal met de commando's voor snapshot, recompute en cleanup

Overzicht Omnibus Price History met de prijswijzigingen van de Fjord Table Lamp per datum, de knop Snapshot now en per rij de actie View history

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__label en .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.

Bekijk de extensie Lees de documentatie

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.

star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025