Omnibus by iLabs 2.0.0 – Wtyczka do WooCommerce gwarantująca zgodność z dyrektywą Omnibus

Dyrektywa Omnibus wymaga, by przy każdej obniżce ceny sklep pokazywał najniższą cenę produktu z ostatnich 30 dni przed rozpoczęciem promocji. W teorii proste, w praktyce oznacza konieczność śledzenia historii cen każdego produktu, wariantu i produktu grupowego – ręcznie nie do utrzymania przy większym katalogu. Omnibus by iLabs to wtyczka WooCommerce, która robi to automatycznie, w tle, bez wpisywania czegokolwiek ręcznie. Wersja 2.0.0 to spore przebudowanie – rozszerza obsługę o dodatkowe reżimy prawne i wprowadza migrację danych ze starszych rozwiązań.

Czym jest Omnibus by iLabs?

Wtyczka, dostępna w repozytorium WordPress.org, dostosowuje sklep WooCommerce do wymogów dyrektywy Omnibus w zakresie informowania o cenach towarów i usług. Automatycznie zapisuje historię cen każdego produktu i pokazuje klientom najniższą cenę sprzed obniżki – dokładnie tak, jak wymaga tego prawo – bez potrzeby ręcznego uruchamiania czegokolwiek przy każdej promocji.

Wymagania: WordPress 6.2 lub nowszy, WooCommerce 5.1 lub nowszy, PHP 7.4 lub nowszy.

Co nowego w wersji 2.0.0

Automatyczne śledzenie historii cen

Każda zmiana ceny produktu – ręczna w panelu administracyjnym, zaplanowana promocja WooCommerce, czy zmiana programistyczna (integracja, import, REST API) – jest automatycznie zapisywana w historii cen produktu. Nic nie trzeba uruchamiać ręcznie.

Prawidłowy punkt odniesienia dla obniżki

Zgodnie z przepisami 30-dniowe okno służące do wyznaczenia najniższej ceny liczy się od momentu rozpoczęcia promocji i nie przesuwa się w miarę jej trwania. Wtyczka pilnuje tego punktu odniesienia automatycznie – zarówno dla promocji uruchamianych ręcznie, jak i tych zaplanowanych z wyprzedzeniem w WooCommerce.

Trzy reżimy prawne produktu

To główna nowość wersji 2.0.0 – wtyczka rozpoznaje trzy sytuacje prawne i stosuje do każdej właściwą regułę:

• Produkt standardowy – w sprzedaży od co najmniej 30 dni: klasyczne okno 30-dniowe.
• Nowy produkt – po raz pierwszy w sprzedaży krócej niż 30 dni: okno liczone od dnia wprowadzenia do sprzedaży, a nie od 30 dni wstecz.
• Produkt szybko psujący się – oznaczany ręcznie w edytorze produktu (zakładka Ogólne): zamiast najniższej ceny z ostatnich 30 dni pokazywana jest cena sprzed pierwszej obniżki.

Promocje ręczne i zaplanowane

Obsługiwane są zarówno promocje wpisywane ręcznie w edytorze produktu, jak i te zaplanowane z wyprzedzeniem (data początku/końca wyprzedaży w WooCommerce) – w obu przypadkach wtyczka poprawnie wyznacza punkt startowy obniżki.

Informacja na stronie produktu i w listingach

Informacja o najniższej cenie pojawia się automatycznie na stronie produktu, opcjonalnie w listingach sklepu (włączane w ustawieniach), na wariantach produktu oraz w tabeli produktów grupowych. Treść notki można dostosować programistycznie filtrem ilabs_omnibus_price_note, dostępny jest też shortcode [omnibus_by_ilabs_message_single_product] do ręcznego umieszczenia notki w dowolnym miejscu, np. w szablonie motywu. Notka nie pojawia się w widżetach produktów powiązanych/polecanych – tylko na głównej stronie produktu i w listingu sklepu.

Nowy ekran WooCommerce → Omnibus

Nowy ekran administracyjny pokazuje stan danych sklepu: liczbę produktów przetworzonych i wymagających uwagi, pozwala uruchomić migrację danych oraz wypisuje produkty, które po migracji wymagają ręcznego przeglądu.

Migracja danych – dwa scenariusze

Aktualizacja z wcześniejszej wersji 1.x

Sklepy korzystające z wcześniejszej wersji Omnibus by iLabs (1.x) mają swoje dane automatycznie wykryte jako wymagające aktualizacji formatu. Migrację uruchamia się jednym kliknięciem na ekranie WooCommerce → Omnibus – proces działa w tle, partiami, i można go bezpiecznie wstrzymać oraz wznowić.

Migracja z wtyczki „Omnibus — show the lowest price” (Marcin Pietrzak)

Sklepy korzystające wcześniej z wtyczki „Omnibus — show the lowest price” autorstwa Marcina Pietrzaka mogą jednym kliknięciem zaimportować całą historię cen do Omnibus by iLabs – bez utraty istniejącej historii i bez przerwy w prawidłowym wyznaczaniu ceny referencyjnej.

Warunki migracji:

• Wtyczka źródłowa musi być dezaktywowana przed rozpoczęciem importu – jeśli jest aktywna, import jest blokowany (obie wtyczki zapisywałyby dane jednocześnie, co mogłoby je uszkodzić).
• Wtyczkę źródłową można bezpiecznie usunąć po migracji – nawet jeśli jej pliki zostały usunięte wcześniej, pozostałe w bazie danych informacje są nadal wykrywane i importowane. Zaleca się jednak przeprowadzenie migracji PRZED usunięciem plików wtyczki źródłowej.
• Import obejmuje wszystkie produkty z historią cen, nie tylko te aktualnie objęte promocją.
• Import nigdy nie nadpisuje ani nie usuwa istniejącej historii Omnibus by iLabs – dodaje wyłącznie nowe, niepowtarzające się wpisy.
• Proces można bezpiecznie uruchomić ponownie – powtórny import nie tworzy duplikatów.

Znane ograniczenia migracji, czasem wymagające ręcznego przeglądu: starsza wersja wtyczki źródłowej (schemat „v3”) zapisywała w historii wyłącznie zdarzenia promocyjne – zwykłe zmiany ceny bez wyprzedaży mogły nie zostać zarejestrowane u źródła. Jeśli import nie znajdzie wiarygodnego punktu odniesienia dla produktu aktualnie objętego promocją, trafia on na listę „wymaga ręcznego przeglądu” na ekranie WooCommerce → Omnibus, gdzie datę rozpoczęcia obniżki można wskazać ręcznie. Dodatkowo, jeśli wtyczka źródłowa przeszła już własną wewnętrzną migrację formatu danych, część historii darmowych promocji (cena 0) mogła zostać bezpowrotnie utracona po stronie źródłowej, zanim import w ogóle ją zobaczył – tego przypadku nie da się automatycznie odtworzyć.

Instalacja krok po kroku

1. Wgraj katalog wtyczki do /wp-content/plugins/ albo zainstaluj ją przez panel WordPressa.
2. Aktywuj wtyczkę w menu „Wtyczki”.
3. Sprawdź ustawienia w WooCommerce → Ustawienia → Ogólne (sekcja Omnibus by iLabs).
4. Jeśli aktualizujesz z wersji 1.x albo migrujesz z wtyczki Omnibus (Marcin Pietrzak), przejdź do WooCommerce → Omnibus i postępuj zgodnie z instrukcjami na ekranie.

Najczęściej zadawane pytania o Omnibus by iLabs

Czy muszę ręcznie wpisywać ceny promocyjne?

Nie. Wtyczka automatycznie zapisuje historię cen przy każdej zmianie ceny produktu – ręcznej, zaplanowanej lub programistycznej.

Aktualizuję z wersji 1.x – co się stanie z moimi danymi?

Po aktywacji nowej wersji wtyczka wykryje, że dane wymagają aktualizacji formatu, i wyświetli odpowiednie powiadomienie w panelu. Migrację uruchamia się ręcznie, jednym kliknięciem, na ekranie WooCommerce → Omnibus. Proces działa w tle i można go bezpiecznie wstrzymać oraz wznowić – nic nie zostanie utracone ani zduplikowane.

Korzystałem wcześniej z innej wtyczki Omnibus – czy stracę historię cen?

Nie, o ile wtyczką źródłową jest „Omnibus — show the lowest price” (Marcin Pietrzak) – patrz sekcja o migracji powyżej. Historię cen z tej wtyczki można zaimportować jednym kliknięciem, bez utraty danych już zapisanych przez Omnibus by iLabs.

Czy notka pojawi się przy kuponach rabatowych?

Nie w tej wersji. Omnibus by iLabs śledzi zmiany ceny regularnej/promocyjnej produktu w WooCommerce – kody rabatowe (kupony) nie są obecnie obsługiwane.

Czy obsługiwane są warianty produktu i produkty grupowe?

Tak – produkty proste, warianty (każdy niezależnie) oraz produkty grupowe. Produkt wariantowy pełniący rolę „rodzica” (bez własnej ceny) nie jest traktowany jako produkt sprzedawalny – notka zawsze dotyczy konkretnego wariantu.

Dla kogo jest Omnibus by iLabs?

Dla każdego sklepu WooCommerce działającego na rynku UE, który stosuje obniżki cen – od okazjonalnych wyprzedaży po stałe promocje sezonowe. Rozróżnienie trzech reżimów prawnych (produkt standardowy, nowy, szybko psujący się) czyni wtyczkę szczególnie przydatną dla sklepów z szerokim katalogiem, gdzie ręczne pilnowanie każdego przypadku byłoby niepraktyczne, a także dla branży spożywczej i innej sprzedającej towary o krótkim terminie przydatności.

Na co zwrócić uwagę

Wersja 2.0.0 to świeże wydanie, wprowadzające istotne zmiany w formacie danych względem wersji 1.x, dlatego przed aktualizacją produkcyjnego sklepu warto przetestować migrację na kopii środowiska – zwłaszcza jeśli sklep korzystał wcześniej z innej wtyczki Omnibus i planuje import historii cen. Warto też zwrócić uwagę na wymienione w opisie ograniczenia migracji (m.in. możliwą utratę historii darmowych promocji ze starszych schematów danych źródłowej wtyczki) i sprawdzić po migracji listę produktów wymagających ręcznego przeglądu na ekranie WooCommerce → Omnibus.

Podsumowanie

Omnibus by iLabs w wersji 2.0.0 zdejmuje z właściciela sklepu WooCommerce odpowiedzialność za ręczne pilnowanie zgodności z dyrektywą Omnibus – historia cen jest zbierana automatycznie, a wtyczka sama rozpoznaje, czy produkt podlega standardowemu 30-dniowemu oknu, jest nowością w ofercie, czy towarem szybko psującym się. Dodatkowa możliwość migracji danych zarówno z wcześniejszej wersji wtyczki, jak i z konkurencyjnego rozwiązania, ułatwia przejście bez utraty historii cen zebranej wcześniej.

Jeśli potrzebujesz pomocy z wdrożeniem Omnibus by iLabs, migracją danych ze starszej wersji lub konfiguracją zgodną ze specyfiką Twojego katalogu produktów, zespół iLabs może to zrobić za Ciebie.