dfomnibus: zgodność z dyrektywą Omnibus w PrestaShop

Moduł dfomnibus dostosowuje twój sklep PrestaShop do europejskiej dyrektywy 2019/2161, zwanej Omnibus, obowiązującej w całej Unii Europejskiej od 28 maja 2022. Buduje automatycznie historię cen każdego produktu i wyświetla, gdy tylko aktywna jest promocja, najniższą cenę odnotowaną w ciągu 30 dni poprzedzających.

Instalacja

Instalacja zajmuje mniej niż pięć minut.

1. Pobierz plik dfomnibus_v1.0.1.zip ze swojego konta klienta DataFirefly.
2. W back office PrestaShop przejdź do Moduły → Menedżer modułów → Zainstaluj moduł.
3. Wgraj ZIP. PrestaShop tworzy tabele, generuje token cron i rejestruje potrzebne hooki.
4. Kliknij Konfiguruj, aby otworzyć ekran ustawień.

Ustawienie codziennego crona

Cron inicjuje historię twojego katalogu i gwarantuje ciągłość codziennych migawek, także dla produktów, których cena nigdy się nie zmienia. Bez aktywnego crona moduł działa, ale jego historia ogranicza się do produktów zmienianych ręcznie.

Pobranie tokenu

Otwórz stronę konfiguracji modułu. Wyświetlony token cron jest unikalny dla twojej instalacji. Otrzymujesz adres w postaci:

https://twoj-sklep.pl/modules/dfomnibus/cron.php?token=TWOJ_TOKEN

Ustawienie przez crona uniksowego

Dodaj do swojego crontaba poniższą linię i dostosuj godzinę do swojego ruchu, najlepiej w porze o niskim obciążeniu:

15 3 * * * curl -s "https://twoj-sklep.pl/modules/dfomnibus/cron.php?token=TWOJ_TOKEN" > /dev/null

Ustawienie przez CLI

Jeśli wolisz uniknąć jakiejkolwiek ekspozycji po HTTP, uruchamiaj crona wprost z linii poleceń:

php /sciezka/do/twojego-sklepu/modules/dfomnibus/cron.php token=TWOJ_TOKEN

Konfiguracja opcji

Włączenie wyświetlania

Przełącznik Włącz wyświetlanie steruje wstawianiem komunikatu zgodności pod ceną produktu. Możesz go tymczasowo wyłączyć, żeby zbierać historię bez pokazywania komunikatu na froncie, co przydaje się przy wdrożeniu albo w czasie testów.

Tryb obliczania

Dostępne są dwa tryby:

• Ścisły: ceną odniesienia jest minimum odnotowane w ciągu 30 dni poprzedzających faktyczny początek trwającej promocji. Odpowiada literze dyrektywy.
• Zachowawczy (domyślnie zalecany): ceną odniesienia jest minimum z ostatnich 30 dni liczonych w oknie kroczącym. Interpretacja mniej korzystna dla sprzedawcy, ale bezpieczniejsza w razie kontroli.

Okres odniesienia

Okres wynosi domyślnie 30 dni, zgodnie z dyrektywą. Możesz go wydłużyć (60, 90 dni), żeby zachować jeszcze większą ostrożność, ale wartość minimalna pozostaje na poziomie 30 dni.

Wykluczenie nowych produktów

Opcja Wyklucz produkty młodsze niż X dni ukrywa komunikat na zbyt świeżych produktach. Wartość domyślna: 30 dni. Jest to spójne z duchem dyrektywy, która dotyczy produktów o istotnej historii cenowej.

Ograniczenie do UE

Jeśli sprzedajesz w UE i poza nią, zaznacz Ogranicz wyświetlanie do Unii Europejskiej. Moduł wykrywa kraj klienta w następującej kolejności:

1. Adres dostawy zalogowanego klienta
2. Adres z bieżącego koszyka
3. Domyślny kraj sklepu

Jeśli żadna z tych informacji nie jest dostępna, wyświetlanie pozostaje domyślnie aktywne, żeby uniknąć ryzyka nieumyślnej niezgodności.

Ukryj przy równej cenie

Opcja Ukryj, jeśli cena identyczna usuwa komunikat, gdy bieżąca cena dokładnie odpowiada najniższej cenie z ostatnich 30 dni. Przydatna, żeby nie wyświetlać informacji bez wartości dla konsumenta.

Rzeczywista obniżka

Włącz Pokaż rzeczywistą obniżkę, aby uzupełnić komunikat o procent liczony względem ceny Omnibus, a nie ceny przekreślonej. Przykład: produkt za 389 zł, w promocji za 259 zł, z ceną Omnibus 285 zł, pokaże -9,1% rzeczywistej obniżki zamiast -33% liczonych od ceny przekreślonej. Jest to uczciwsze, ale każdy sprzedawca decyduje sam.

Wykres

Wykres z 30 dni może wyświetlać się w osobnej zakładce karty produktu albo w linii pod ceną. Jest ładowany leniwie przez IntersectionObserver i uruchamia się dopiero po wejściu w widok, co gwarantuje zerowy wpływ na Core Web Vitals twoich kart produktu.

Śledzenie per wariant

Zaznacz Śledź warianty, jeśli twoje produkty mają różne ceny per kombinacja (na przykład rozmiary XL z dopłatą). Historia jest wtedy dzielona według id_product_attribute, a komunikat Omnibus dostosowuje się do ceny wybranego wariantu.

Retencja

Domyślny czas przechowywania to 365 dni. Starsza historia jest automatycznie czyszczona przy uruchomieniu crona. Wartość minimalna to 60 dni, co gwarantuje zapas bezpieczeństwa wobec ustawowego okna 30 dni.

Pulpit zgodności

Pulpit dostępny przez Moduły → Pulpit DataFirefly Omnibus zbiera:

• Liczbę śledzonych produktów
• Łączną liczbę zapisanych migawek
• Datę i godzinę ostatniego przejścia crona
• Listę produktów z datą pierwszej migawki, datą ostatniej migawki, najniższą ceną z 30 dni i wskaźnikiem aktywnej promocji

Dla każdego produktu dostępne są trzy akcje:

• Zobacz historię: wyświetla do 1000 migawek ze znacznikami czasu
• Migawka ręczna: wymusza natychmiastowy zapis
• Usuń historię: resetuje śledzenie tego produktu (używaj ostrożnie)

Eksport CSV

W widoku historii produktu przycisk Eksportuj do CSV generuje plik ze wszystkimi kolumnami opatrzonymi znacznikiem czasu (data, cena netto, cena brutto, waluta, sklep, wariant, wskaźnik promocji, źródło migawki). Format gotowy do archiwizacji albo przekazania kontrolerowi Inspekcji Handlowej.

Zachowanie na froncie

Na karcie produktu, gdy tylko aktywna jest promocja, pod ceną wyświetla się automatycznie komunikat:

Najniższa cena z 30 dni przed obniżką: 285,00 zł

Komunikat jest tłumaczony zgodnie z językiem sklepu (francuski, angielski, hiszpański, niemiecki). Wyświetlanie korzysta ze standardowego hooka displayProductPriceBlock i działa ze wszystkimi szablonami przestrzegającymi standardów PrestaShop (Classic, Hummingbird, Warehouse, Transformer, Panda).

Multisklep i wielowalutowość

Historia jest zapisywana per unikalna kombinacja (id_product, id_product_attribute, id_shop, id_currency). Każdy sklep w twojej instalacji zachowuje więc własną historię, a każda aktywna waluta ma własną krzywą cenową. Bez przeliczeń w locie: wyświetlane kwoty odpowiadają dokładnie temu, co zapisano w chwili wykonania migawki.

Rozwiązywanie problemów

Komunikat nie pojawia się na karcie produktu

Sprawdź po kolei:

1. Czy opcja Włącz wyświetlanie jest zaznaczona w konfiguracji?
2. Czy cron wykonał się co najmniej raz? Jeśli nie, historia nie istnieje.
3. Czy ograniczenie do UE jest włączone, podczas gdy testujesz z kraju spoza UE?
4. Czy opcja Ukryj, jeśli cena identyczna jest włączona, a bieżąca cena odpowiada cenie minimalnej?
5. Czy produkt ma mniej niż 30 dni, przy włączonej opcji wykluczania nowości?

Wykres się nie ładuje

Otwórz konsolę przeglądarki. Moduł oczekuje punktu wejścia AJAX udostępnianego przez kontroler frontowy pricehistory. Sprawdź, czy żaden system cache ani firewall nie przechwytuje tej trasy. Jeśli używasz CDN, dopuść wprost adresy /module/dfomnibus/pricehistory.

Cron zwraca błąd 403 albo 401

Token w adresie nie odpowiada temu zapisanemu. Wróć do konfiguracji modułu i skopiuj aktualny token. Przy podejrzeniu wycieku kliknij Wygeneruj token ponownie i zaktualizuj swojego crona uniksowego.

Błąd SQL w chwili wykonania migawki

Jeśli używasz wersji 1.0.0, zaktualizuj do 1.0.1. Pierwsza wersja miała wadę w trzech zapytaniach Db::getRow(), które dopisywały ręczne LIMIT 1, podczas gdy PrestaShop dodaje je już automatycznie, co dawało nieprawidłowe w SQL LIMIT 1 LIMIT 1. Zobacz historię zmian.

FAQ

Czy moduł jest obowiązkowy dla mojego sklepu?

Tak, jeśli sprzedajesz konsumentom w Unii Europejskiej i wyświetlasz ceny obniżone, promocje, kody rabatowe, wyprzedaże albo jakąkolwiek wzmiankę o obniżce. Dyrektywa Omnibus obowiązuje bez progu obrotu.

Czym to się różni od CartRule?

Moduł śledzi wyłącznie ceny wynikające z SpecificPrice w PrestaShop (rabaty produktowe, rabaty ilościowe, rabaty grup klientów). Reguły koszyka (CartRule) działają na etapie zamówienia i nie zmieniają ceny jednostkowej pokazywanej na karcie produktu, więc pozostają poza zakresem dyrektywy.

Jak dokładnie działa tryb ścisły?

Moduł szuka w historii ostatniej migawki bez promocji, a następnie pierwszej migawki promocyjnej po niej. Ta data stanowi początek trwającej promocji. Oknem odniesienia jest wtedy 30 dni poprzedzających tę datę. Jeśli przejścia z braku promocji do promocji nie da się wykryć, moduł przełącza się automatycznie na tryb zachowawczy.

Czy mogę ukryć komunikat na wybranych produktach?

Moduł działa globalnie, ale opcja wykluczania nowych produktów i opcja ukrywania przy równej cenie pokrywają większość sytuacji, w których komunikat nie wnosi użytecznej informacji.

Czy działa z cenami netto i brutto?

Tak. Moduł zapisuje przy każdej migawce obie kwoty (price_tax_excl i price_tax_incl) i wyświetla tę używaną przez sklep. Jeśli przełączysz się z jednego trybu na drugi, historia pozostaje użyteczna.

Historia zmian

1.0.1, 14 maja 2026

• Poprawka: usunięcie ręcznego LIMIT 1 z trzech zapytań Db::getRow(), które dawały nieprawidłowe w SQL LIMIT 1 LIMIT 1. Dotyczyło zabezpieczenia idempotencji zapisu i wykrywania początku promocji w trybie ścisłym.

1.0.0, 14 maja 2026

• Pierwsze wydanie
• Automatyczne zbieranie historii cen przez hooki i codzienny cron
• Wyświetlanie najniższej ceny z 30 dni na karcie produktu
• Wykres z 30 dni w czystym canvasie, ładowany leniwie, około 3 KB
• Pulpit zgodności ze statystykami i eksportem CSV
• Tryby obliczania ścisły i zachowawczy
• Obsługa multisklepu, wielu walut i wariantów
• Konfigurowalne ograniczenie do UE, wykluczanie nowych produktów, opcja ukrywania przy identycznej cenie
• Tłumaczenia FR, EN, ES, DE