Przejdź do treści
🌸

Przewodnik użytkowania

Szczegółowy opis każdej dostępnej opcji konfiguracji.

Zakładka Ogólne

Włącz wtyczkę

Główny przełącznik. Gdy wyłączony, wtyczka nadal rejestruje zmiany cen (żebyś nie stracił danych historycznych), ale przestaje wyświetlać notatkę na froncie.

Okno historyczne (dni)

Liczba dni wstecz, z których wtyczka szuka najniższej ceny. Domyślnie 30 — zgodnie z dyrektywą Omnibus. Wartości poniżej 30 NIE SĄ zgodne z prawem UE i powinny być stosowane wyłącznie w celach testowych.

Retencja danych (dni)

Jak długo przechowywać wpisy historyczne. Domyślnie 90 dni. Cron wpnest_ph_cleanup raz dziennie usuwa wpisy starsze niż ten okres. Minimum: 30 dni (mniej niż okno historyczne nie ma sensu).

Metoda kalkulacji

  • omnibus (domyślna, zalecana) — okno = od momentu rozpoczęcia bieżącej promocji wstecz o 30 dni. Zgodne z polską ustawą.
  • rolling — zwykłe okno [DZIŚ−30d, DZIŚ]. UWAGA: ta metoda technicznie NIE JEST zgodna z dyrektywą gdy promocja trwa kilka dni — cena promocyjna wpada do okna i zaniża wynik.

Pozostaw metodę omnibus jeśli sprzedajesz w UE. Metoda rolling jest pozostawiona jedynie dla kompatybilności z innymi pluginami i prawnie ryzykowna.

Etykieta promocji

Tekst notatki dla produktu na promocji. Domyślnie:

Najniższa cena z {window} dni przed obniżką: {price}

Dostępne placeholdery: {window} (liczba dni), {price} (sformatowana kwota), {currency} (symbol waluty).

Etykieta bez promocji

Tekst dla produktów bez aktywnej promocji (gdy Kiedy wyświetlać = zawsze). Domyślnie pusty — notatka się nie pokazuje.

Zakładka Wyświetlanie

Pokaż na stronie produktu

Włącz/wyłącz notatkę na stronie pojedynczego produktu. Włączona domyślnie — wymagane prawem.

Pokaż w shop loop

Wyświetlanie notatki w listach produktów (kategorie, sklep, wyniki wyszukiwania). Wyłączona domyślnie — może wpływać na układ kart produktów.

Pokaż w koszyku

Notatka pod każdą pozycją w koszyku. Wyłączona domyślnie.

Pozycja

  • after_price (domyślnie) — bezpośrednio pod ceną
  • before_price — nad ceną
  • summary — w sekcji opisu produktu

Kiedy wyświetlać

  • on_sale (domyślnie) — tylko gdy produkt jest na promocji
  • always — zawsze (wymaga ustawienia Etykiety bez promocji)

Custom CSS

Pole na własny CSS dla notatki. Możesz tu wkleić dowolne style — zostaną wstawione inline w <head> tylko na stronach gdzie notatka się pokazuje. Klasa kontenera: .wpnest-ph-omnibus.

.wpnest-ph-omnibus {
  font-size: 13px;
  color: #666;
  font-style: italic;
  margin-top: 8px;
}

Mini wykres w panelu produktu

W widoku edycji produktu (Produkty → Edytuj) znajdziesz metabox „Historia cen (WPNest)” z wykresem ostatnich 90 dni zmian cen. Pomocne przy diagnozowaniu problemów z notatką lub auditingu.

Komendy WP-CLI

# Wymuś snapshot wszystkich produktów
wp wpnest-ph snapshot

# Usuń wpisy starsze niż retencja
wp wpnest-ph cleanup

# Backfill (powtórz dla nowo dodanych produktów bez historii)
wp wpnest-ph backfill