BStudio Plugin

OMNIBUS PRO

Wersja: 1.0.0 Autor: Biegun.Studio Wymaga: WordPress 6.0+, PHP 8.0+, WooCommerce 7.0+

Pełna zgodność z Dyrektywą OMNIBUS dla sklepów WooCommerce. Automatyczne logowanie historii cen, wyświetlanie najniższej ceny z 30 dni przy produktach w promocji, eksport raportu PDF dla UOKiK i organy kontrolne.

Co robi ta wtyczka?

Wtyczka w sposób w pełni automatyczny rejestruje każdą zmianę ceny produktu, oblicza najniższą cenę z ostatnich 30 dni i wyświetla ją pod ceną przekreśloną — zgodnie z wymogami dyrektywy OMNIBUS. Nie wymaga żadnych ręcznych działań po pierwszej konfiguracji.

Funkcje

📊
Automatyczne logowanie cen

Każda zmiana ceny produktu (zapis, import CSV, cena wariantu) jest automatycznie rejestrowana z datą, ceną regularną, ceną sprzedaży i walutą.

🏷️
Widget "Najniższa cena z 30 dni"

Pojawia się automatycznie przy każdym produkcie w promocji. Pokazuje cenę OMNIBUS, procent rzeczywistej obniżki i informację jeśli historia jest krótsza niż 30 dni.

🔄
Obsługa wariantów produktu

Pełna obsługa produktów zmiennych — każdy wariant ma własną historię cen, a widget pojawia się dynamicznie po wyborze wariantu przez klienta (AJAX).

📄
Eksport PDF / HTML dla UOKiK

Z poziomu admina możesz pobrać raport z historią cen produktu w formacie PDF (jeśli zainstalowany Dompdf) lub HTML gotowy do wydruku.

📦
Import CSV WooCommerce

Ceny zaimportowane przez standardowy eksport/import CSV WooCommerce są automatycznie rejestrowane w historii.

🧹
Automatyczne czyszczenie

Codzienny cron usuwa wpisy starsze niż 365 dni, zachowując zawsze ostatni wpis dla każdego produktu/wariantu. Baza nie rośnie w nieskończoność.

Jak to działa — dla właściciela sklepu

Po aktywacji wtyczka:

  1. Tworzy tabelę wp_bstudio_omnibus_price_log w bazie danych.
  2. Wykonuje jednorazowy snapshot aktualnych cen wszystkich produktów.
  3. Od tej chwili każdy zapis produktu (zmiana ceny) jest automatycznie rejestrowany.
  4. Na stronach produktów w promocji pojawia się widget z najniższą ceną z 30 dni.

Panel ustawień

Przejdź do WooCommerce → OMNIBUS PRO.

UstawienieOpis
Liczba dni historiiDomyślnie 30 (wymagane przez dyrektywę). Możesz zwiększyć np. do 365
Pokaż odznakęKolorowa odznaka "OMNIBUS" przy wyświetlanej cenie
Treść etykietyTekst przed ceną najniższą, np. "Najniższa cena z 30 dni:"
Styl odznakiWarianty wizualne widgetu

Eksport PDF — jak pobrać raport

  1. Otwórz dowolny produkt w panelu admina (Produkty → [produkt] → Edytuj).
  2. Znajdź meta box "BStudio OMNIBUS PRO".
  3. Kliknij Pobierz raport PDF.
  4. Plik zostanie pobrany automatycznie. Zawiera pełną historię cen, cenę OMNIBUS i procent obniżki.
PDF vs HTML: Jeśli na serwerze zainstalowana jest biblioteka Dompdf (przez Composer w katalogu vendor/ wtyczki) — generowany jest prawdziwy PDF. Bez Dompdf pobierany jest plik HTML gotowy do wydruku z przeglądarki (Plik → Drukuj → Zapisz jako PDF).

Instalacja

  1. Skopiuj folder bstudio-omnibus-pro do /wp-content/plugins/.
  2. Aktywuj wtyczkę w panelu Wtyczki → Zainstalowane wtyczki.
  3. Po aktywacji wtyczka automatycznie tworzy tabelę w bazie i wykonuje snapshot cen — możesz zobaczyć postęp w logach administracyjnych.
  4. Przejdź do WooCommerce → OMNIBUS PRO i dostosuj ustawienia wyświetlania.

Usunięcie wtyczki

  1. W panelu Wtyczki dezaktywuj BStudio OMNIBUS PRO.
  2. Kliknij Usuń.
  3. Tabela wp_bstudio_omnibus_price_log zostaje usunięta przez hook deaktywacji. Ustawienia w wp_options możesz usunąć ręcznie przez phpMyAdmin.
Uwaga: Usunięcie wtyczki usuwa całą historię cen. Przed usunięciem pobierz raporty PDF dla produktów, których historię chcesz zachować.

Tabela bazy danych

Wtyczka tworzy własną tabelę wp_bstudio_omnibus_price_log z kolumnami:

KolumnaTypOpis
idINT AUTO_INCREMENTKlucz główny
product_idBIGINTID produktu WooCommerce
variation_idBIGINTID wariantu (0 = produkt prosty)
regular_priceDECIMAL(15,4)Cena regularna w momencie zapisu
sale_priceDECIMAL(15,4) NULLCena promocyjna (NULL jeśli brak)
active_priceDECIMAL(15,4)Aktualnie aktywna cena (używana do obliczeń)
currencyCHAR(3)Kod waluty (np. PLN)
recorded_atDATETIMEData i godzina zapisu
sourceVARCHAR(20)Źródło: auto, import, snapshot

Struktura plików

bstudio-omnibus-pro/
├── bstudio-omnibus-pro.php ← Główny plik, cron, HPOS compatibility
├── includes/
│ ├── class-bstudio-omnibus-activator.php ← Tworzenie tabeli DB przy aktywacji
│ ├── class-bstudio-omnibus-deactivator.php ← Czyszczenie przy deaktywacji
│ ├── class-bstudio-omnibus-logger.php ← Przechwytywanie zmian cen i zapis do DB
│ ├── class-bstudio-omnibus-calculator.php ← Obliczanie najniższej ceny z N dni
│ ├── class-bstudio-omnibus-display.php ← Widget na stronie produktu + AJAX dla wariantów
│ └── class-bstudio-omnibus-export.php ← Generowanie i pobieranie raportu PDF/HTML
├── admin/
│ └── class-bstudio-omnibus-admin.php ← Panel WC → OMNIBUS PRO, meta box produktu
├── public/ ← CSS + JS widgetu ceny OMNIBUS
└── docs/

Wsparcie i zgłoszenia

Masz pytanie, napotkałeś problem albo chcesz rozwinąć to rozwiązanie pod swój sklep? Pomożemy.

Pomoc techniczna

Problemy z instalacją, konfiguracją lub działaniem wtyczki — opisz zgłoszenie, a wrócimy z rozwiązaniem.

Zgłoszenie (ticket)

Wyślij e-mail na shop@biegun.studio. W temacie podaj nazwę wtyczki i krótki opis. Dołącz wersje WordPressa, WooCommerce i PHP oraz kroki odtworzenia problemu.

Rozwój i modyfikacje

Potrzebujesz dodatkowej funkcji albo integracji? Realizujemy rozszerzenia i wdrożenia na zamówienie — napisz na shop@biegun.studio.

Pełna oferta wtyczek: biegun.studio/sklep