# Okazja dnia WooCommerce (Deals of the Day): pełny przewodnik

> Pełny przewodnik po instalacji, konfiguracji i obsłudze DataFirefly Deals of the Day w WooCommerce.

- Strona: <https://www.datafirefly.com/pl/documentation/deals-of-the-day-woocommerce/>
- Język: pl
- Zaktualizowano: 2026-11-19
- Inne języki: [fr](https://www.datafirefly.com/documentation/deals-of-the-day-woocommerce/index.md), [en](https://www.datafirefly.com/en/documentation/deals-of-the-day-woocommerce/index.md), [es](https://www.datafirefly.com/es/documentation/deals-of-the-day-woocommerce/index.md), [de](https://www.datafirefly.com/de/documentation/deals-of-the-day-woocommerce/index.md), [it](https://www.datafirefly.com/it/documentation/deals-of-the-day-woocommerce/index.md), [nl](https://www.datafirefly.com/nl/documentation/deals-of-the-day-woocommerce/index.md), [pt](https://www.datafirefly.com/pt/documentation/deals-of-the-day-woocommerce/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Przegląd

DataFirefly Deals of the Day dodaje do WooCommerce stronę „Deals of the Day" i mechanizm automatycznej rotacji. O wybranej godzinie wtyczka dobiera produkty według Twoich reguł, nalicza rabat i kończy poprzednie okazje. Okazje można też planować ręcznie.

Cena okazji jest liczona na bieżąco, dopóki okazja trwa. Ceny zapisane w WooCommerce nigdy się nie zmieniają: po zakończeniu okazji lub sprzedaży zaplanowanych sztuk sama wraca cena regularna.

**W skrócie:** aktywuj wtyczkę, dodaj stronę okazji do menu, ustaw reguły w **WooCommerce > Deals of the Day > Automatic rotation** i kliknij **Go live now**.

Interfejs wtyczki jest po angielsku i francusku. W tym przewodniku nazwy ekranów i przycisków podano po angielsku, tak jak w panelu administracyjnym.

## Instalacja

1. W **Wtyczki > Dodaj nową > Wyślij wtyczkę na serwer** wybierz `df-deals-of-the-day.zip` i aktywuj **DataFirefly Deals of the Day**.
2. Trafiasz do panelu wtyczki. Strona okazji jest już utworzona i opublikowana: dodaj ją do menu w **Wygląd > Menu** lub w edytorze witryny.

Wymagania: WordPress 6.2 lub nowszy, WooCommerce 7.8 lub nowszy, PHP 7.4 lub nowszy. Zgodność z HPOS, blokami Koszyk i Kasa, motywami blokowymi i klasycznymi.

## Szybki start

1. **Strona okazji**: tworzona przy aktywacji z blokiem „Deals of the Day". Dodaj ją do menu.
2. **Reguły rotacji**: w zakładce **Automatic rotation** wybierz tryb, godzinę, liczbę produktów, rabat i wykluczenia, a następnie zapisz.
3. **Publikacja**: kliknij **Go live now** pod zaplanowanym wyborem, aby od razu uruchomić pierwszą rotację, albo poczekaj na zaplanowaną godzinę. Okazję ręczną utworzysz w zakładce **Deals**.

## Trzy tryby

- **Automatic**: produkty rotują według harmonogramu i Twoich reguł.
- **Hybrid** (domyślnie): trwające okazje ręczne zajmują swoje miejsca jako pierwsze, rotacja uzupełnia pozostałe do ustawionej liczby produktów.
- **Manual**: aktywne są tylko okazje, które zaplanujesz. Przejście na tryb ręczny kończy trwające okazje automatyczne.

Dla tego samego produktu okazja ręczna ma zawsze pierwszeństwo przed automatyczną.

## Harmonogram rotacji

- **Every day**: codziennie o wybranej godzinie (domyślnie o północy).
- **Every X hours**: co X godzin od godziny początkowej. Co 6 godzin od 08:00 daje 02:00, 08:00, 14:00 i 20:00.
- **Every week**: co tydzień w wybrany dzień i o wybranej godzinie.

Godziny są liczone w strefie czasowej sklepu (**Ustawienia > Ogólne**). Każda okazja automatyczna trwa do następnej rotacji. Harmonogram co 5 minut sprawdza, czy przypada rotacja i czy jakaś okazja się zaczęła, skończyła lub wyprzedała.

## Wybór i rabat

- **Products per rotation**: od 1 do 60.
- **Priority**: losowo, produkty słabo się sprzedające (aby upłynnić zalegający towar), bestsellery, największy stan (produkty z zarządzaniem stanem), nowości, najwyższe ceny.
- **Featured deal**: największy rabat, pierwszy wybrany produkt lub brak. Okazja wyróżniona jest pokazywana na dużej karcie u góry strony.
- Rabat: **Same percentage for all** lub **Random within a range** z krokiem. Od 15 do 40% co 5 daje 15, 20, 25, 30, 35 lub 40%.
- **Maximum discount per unit**: gdy procent przekroczyłby tę kwotę przy drogim produkcie, rabat jest do niej ograniczony.
- **Units per deal**: liczba sztuk po cenie okazji. 0 = bez limitu. Przy limicie wyświetla się pasek stanu.
- **Maximum per order**: klient nie kupi więcej sztuk po cenie okazji w jednym zamówieniu. 0 = bez limitu.

## Pula produktów i reguły wykluczeń

Rotacja dobiera produkty z **całego katalogu**, **wybranych kategorii** (z podkategoriami), **wybranych tagów** lub **listy produktów**. Produkt, który spełnia którąkolwiek z tych reguł, nigdy nie trafia do rotacji automatycznej:

- wykluczone kategorie, tagi, marki (WooCommerce Brands i popularne wtyczki marek) lub konkretne produkty;
- zaznaczone typy produktów (produkty grupowe są zawsze wykluczone, nie mają własnej ceny);
- produkty już przecenione, niedostępne, w zamówieniu oczekującym, bez zdjęcia, ukryte w katalogu lub wyróżnione, zależnie od włączonych przełączników;
- cena regularna spoza zakresu min / max;
- stan poniżej minimum (produkty z zarządzaniem stanem);
- produkty opublikowane mniej niż X dni temu (nowości);
- produkty, które miały okazję automatyczną w ostatnich X dniach (**Cooldown**, domyślnie 30 dni).

Aby wykluczyć pojedynczy produkt, otwórz go i zaznacz **Never include this product in automatic rotations** w **Dane produktu > Ogólne**.

Ramka **Live check** pokazuje podczas edycji, jeszcze przed zapisaniem, ile produktów spełnia Twoje reguły. Jeśli liczba jest mniejsza niż liczba produktów w rotacji, zmienia kolor na pomarańczowy.

Z opcją **Relax if not enough products** rotacja wypełnia puste miejsca produktami, którym nie minął jeszcze okres karencji, zamiast zostawiać wolne miejsca. Zaplanowany wybór oznacza je jako „Cooldown relaxed".

## Wybór na następną rotację

Pod regułami **Next rotation lineup** pokazuje zaplanowane produkty z ceną regularną, ceną okazji i rabatem. Wybór jest przeliczany, gdy tylko zmienisz reguły.

- Przycisk **Swap for another product** zastępuje produkt innym kwalifikującym się produktem.
- **Shuffle** przelicza cały wybór.
- **Go live now** kończy trwające okazje automatyczne i od razu publikuje wybór. Następna rotacja odbędzie się o zaplanowanej godzinie.

W chwili rotacji każdy zaplanowany produkt jest sprawdzany ponownie: jeśli nie spełnia już reguł (bo np. się wyprzedał), zostaje zastąpiony, a historia rotacji to odnotowuje.

## Okazje ręczne

W zakładce **Deals** kliknij **New deal**. Możesz też zacząć od produktu: link **Create a deal** na liście produktów albo przycisk **Schedule a deal for this product** na stronie edycji.

1. **Produkt**: produkt prosty, produkt z wariantami (rabat obejmuje wszystkie warianty) lub pojedynczy wariant.
2. **Rabat**: procent (**Percentage**), kwota (**Amount off**) lub dokładna cena (**Deal price**). Podgląd pokazuje cenę regularną, cenę okazji i rzeczywisty rabat.
3. **Termin**: początek i koniec w strefie czasowej sklepu, z szybkimi czasami trwania (24 godziny, 48 godzin, 3 dni, 1 tydzień, do północy).
4. **Limity**: sztuki dostępne po cenie okazji, maksimum na zamówienie, okazja wyróżniona.

Listę okazji można filtrować według statusu (trwająca, zaplanowana, zakończona) i źródła (automatyczna, ręczna). Każdą okazję można edytować, od razu zakończyć, wznowić jako okazję ręczną na ten sam czas albo usunąć (statystyki zostają zachowane).

## Karta produktu, sklep i koszyk

W zakładce **Design**:

- **Badge**: tekst (domyślnie „Deal of the day", do zmiany), ikona, procent i styl na zdjęciach: pigułka, wstążka, narożnik lub naklejka. Odznaka zastępuje odznakę „Promocja!" WooCommerce na produktach w okazji.
- **Colours & shape**: sześć gotowych palet lub własne kolory oraz zaokrąglenie narożników, z podglądem na żywo.
- **Product page**: położenie bloku okazji (pod tytułem, pod ceną, nad lub pod przyciskiem Dodaj do koszyka albo ukryty) i widoczne elementy: odliczanie, pasek stanu, kwota oszczędności, dowód społeczny. Próg pilności pokazuje „Only X left!", gdy pozostałe sztuki spadną poniżej tego procentu.
- **Shop & category listings**: odznaka na zdjęciach i odliczanie pod ceną.

W motywie blokowym odznaka zastępuje tę z bloków Zdjęcie produktu i Odznaka promocji, a blok okazji pojawia się pod blokiem Cena produktu. W page builderze ukryj blok automatyczny i wstaw shortcode `[df_deal_panel]` w wybranym miejscu.

W koszyku i w kasie produkt ma oznaczenie „Deal of the day: -30%". Limity sztuk i na zamówienie są sprawdzane w klasycznym koszyku oraz w blokach Koszyk i Kasa. Jeśli okazja skończy się, gdy produkt jest w koszyku, wraca cena regularna.

## Strona okazji

Strona pokazuje nagłówek z tytułem, liczbą okazji, największym rabatem i odliczaniem do kolejnych okazji, okazję wyróżnioną, siatkę pozostałych okazji i zapowiedź „Coming next" z rozmytymi zdjęciami następnego wyboru i zaplanowanych okazji. Gdy odliczanie dojdzie do zera, strona się przeładowuje.

W **Design > Deals page** ustawisz tytuł i podtytuł (wpisz je po polsku), układ (okazja wyróżniona + siatka, siatka lub lista), liczbę kolumn, kolejność, odliczanie, zapowiedź, automatyczne odświeżanie i komunikat bez okazji.

```
[df_deals_of_the_day layout="hero_grid|grid|list" columns="3" limit="12" show_hero="no" show_upcoming="no" sort="featured|discount|price_asc|ending"]
[df_deal_panel id="123"]
[df_deal_badge id="123"]
[df_deals_countdown format="boxes|inline"]
```

W edytorze blok **Deals of the Day** (kategoria WooCommerce) ma własne ustawienia układu, kolumn i liczby okazji.

## Ustawienia

- **Deals page**: strona z okazjami lub utworzenie nowej.
- **The discount applies to**: cena regularna (zalecane, okazja zastępuje cenę promocyjną) lub cena aktualna (okazja sumuje się z trwającą promocją).
- **Price rounding**: cena dokładna, ,99, ,95, ,90 lub pełna liczba. Zawsze w dół, więc pokazany rabat nigdy nie jest zawyżony.
- **EU Omnibus reference price**: pod ceną najniższa cena z 30 dni przed okazją, liczona z ceny regularnej, ceny aktualnej i wcześniejszych okazji wtyczki.
- **Deal label in cart & checkout**.
- **Purge page cache when deals change**, z listą wykrytych wtyczek cache.
- **Delete all data when the plugin is deleted**: okazje, statystyki i ustawienia. Ceny produktów nigdy nie są zmieniane.

Cena referencyjna Omnibus uwzględnia okazje wtyczki i trwającą promocję, ale nie wcześniejsze promocje obsługiwane przez inną wtyczkę. Sprawdź, czy odpowiada Twojej sytuacji, zanim ją wyświetlisz.

## Statystyki

Panel pokazuje za 30 dni przychód netto po cenach okazji, sprzedane sztuki i zamówienia, współczynnik koszyk do zamówienia, oszczędności klientów, przychód dzienny z 14 dni, trwające okazje ze sprzedażą i pozostałym czasem, najlepsze produkty, historię rotacji i stan harmonogramu. Sprzedaż jest liczona, gdy zamówienie ma status wstrzymane, w trakcie realizacji lub zrealizowane, i odejmowana po anulowaniu, niepowodzeniu lub zwrocie.

## Cache i harmonogram

Gdy okazja się zaczyna, kończy lub wyprzedaje, wtyczka czyści cache produktów WooCommerce i cache stron WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround Speed Optimizer, Breeze, Autoptimize, Nginx Helper i Cachify. Inne cache mogą korzystać z akcji `dfdod_purge_cache`.

Rotacje działają przez WP-Cron co 5 minut, a awaryjnie przy pierwszej wizycie po zaplanowanej godzinie. Jeśli zdefiniowano `DISABLE_WP_CRON`, ustaw cron serwera tak, by wywoływał `wp-cron.php` co 5 minut.

## Dla programistów

- Filtry: `dfdod_deal_price`, `dfdod_apply_deal_pricing`, `dfdod_rotation_query_args`, `dfdod_product_rejection_reason`, `dfdod_rotation_discount`, `dfdod_next_rotation`, `dfdod_badge_html`, `dfdod_panel_html`, `dfdod_card_html`, `dfdod_page_html`, `dfdod_admin_capability`.
- Akcje: `dfdod_rotated`, `dfdod_order_counted`, `dfdod_purge_cache`.
- Meta produktu: `_dfdod_exclude` = `yes` wyklucza produkt z rotacji.

## Rozwiązywanie problemów

### Brak produktów w zaplanowanym wyborze

Licznik Live check pokazuje 0: wykluczenia odrzucają cały katalog. Wyłącz „Already on sale" lub „Without an image", poszerz zakres cen albo skróć okres karencji.

### Rotacja nie odbyła się o czasie

Sprawdź stan harmonogramu w historii rotacji. Jeśli WP-Cron jest wyłączony, a witryna nie miała odwiedzin, rotacja czeka na pierwszą wizytę. Dodaj cron serwera.

### Klient wciąż widzi starą cenę

Została wyświetlona strona z cache. Sprawdź, czy czyszczenie cache jest włączone i czy Twoja wtyczka cache jest wykryta; w przeciwnym razie użyj akcji `dfdod_purge_cache`.

### Odznaka nie wyświetla się w moim motywie

Niektóre motywy nie używają odznaki promocji WooCommerce. Wstaw shortcode `[df_deal_badge]` do szablonu karty produktu lub kafelka produktu.
