Wykres historii cen

Wykres historii cen wizualizuje zmiany cen produktu w formie kompaktowego wykresu sparkline SVG. Klienci widzą jak cena zmieniała się w wybranym okresie (30, 90 lub 180 dni), co buduje transparentność i zaufanie do promocji.

Włączenie modułu

Przejdź do Polski > Moduły i włącz Wykres historii cen. Wykres pojawi się automatycznie na stronach produktów, które mają zapisaną historię cen.

Funkcje

Wykres sparkline renderowany jako SVG (brak zależności od bibliotek JS)
Konfigurowalne okresy: 30, 90 lub 180 dni
Wyświetlanie ceny minimalnej i maksymalnej w okresie
Gradient wypełnienia pod linią wykresu
Kropka wskazująca aktualną cenę
Kolory wykresu konfigurowalne w ustawieniach
Automatyczne pobieranie danych z repozytorium Omnibus

Ustawienia

Konfiguracja w Polski > Moduły > Wykres historii cen.

Ustawienie	Domyślnie	Opis
`days`	`30`	Okres wykresu w dniach: `30`, `90` lub `180`
`show_min_max`	`true`	Wyświetlaj cenę minimalną i maksymalną pod wykresem
`color`	`#2563eb`	Kolor linii wykresu i gradientu

Opcja w bazie danych: polski_price_history.

Wygląd wykresu

Wykres składa się z następujących elementów:

Linia - przebiegu ceny w czasie (stroke SVG)
Gradient - półprzezroczyste wypełnienie od linii do dołu wykresu
Kropka - aktualna cena produktu (ostatni punkt na wykresie)
Min/Max - etykiety z ceną minimalną i maksymalną (opcjonalnie)

Rozmiar wykresu dopasowuje się do kontenera. Domyślna wysokość to 60px.

Szczegóły techniczne

Źródło danych

Wykres pobiera dane z klasy OmnibusPriceRepository, która przechowuje historię zmian cen wymaganą przez dyrektywę Omnibus. Każdy punkt danych zawiera datę i cenę produktu.

Renderowanie SVG

Wykres renderowany jest po stronie serwera jako inline SVG - brak zewnętrznych bibliotek, brak zapytań HTTP, brak JavaScript do rysowania. Dzięki temu wykres:

Wyświetla się natychmiast (brak flash of unstyled content)
Jest dostępny dla czytników ekranowych (aria-label)
Nie wpływa na Core Web Vitals

Hooki

// Zmień okres wykresu dynamicznie
add_filter('polski/price_history/days', function (int $days, int $product_id): int {
    // Dłuższy okres dla produktów sezonowych
    if (has_term('sezonowe', 'product_cat', $product_id)) {
        return 180;
    }
    return $days;
}, 10, 2);

// Zmień pozycję wykresu na stronie produktu
add_filter('polski/price_history/hook', function (): string {
    return 'woocommerce_single_product_summary'; // domyślnie: woocommerce_product_meta_start
});

// Zmień priorytet hooka
add_filter('polski/price_history/hook_priority', function (): int {
    return 25;
});

// Filtruj dane wykresu
add_filter('polski/price_history/data', function (array $prices, int $product_id): array {
    return $prices;
}, 10, 2);

Klasy CSS

.polski-price-history - kontener główny
.polski-price-history__chart - element SVG
.polski-price-history__label - etykiety min/max
.polski-price-history__min - cena minimalna
.polski-price-history__max - cena maksymalna

.polski-price-history {
    margin: 1rem 0;
    padding: 0.75rem;
    background: #f9fafb;
    border-radius: 0.5rem;
}

ID modułu

price_history_chart

Rozwiązywanie problemów

Wykres nie wyświetla się - sprawdź, czy moduł Omnibus jest włączony i czy produkt ma zapisaną historię cen. Nowe produkty nie będą miały wykresu do czasu pierwszej zmiany ceny.

Wykres jest pusty/płaski - jeśli cena nie zmieniała się w wybranym okresie, wykres pokazuje płaską linię. To prawidłowe zachowanie.

Kolory wykresu nie pasują do motywu - zmień kolor w ustawieniach modułu lub nadpisz w CSS: .polski-price-history__chart path { stroke: #your-color; }.

Zgłaszanie problemów: github.com/wppoland/polski/issues

Ta strona ma wyłącznie charakter informacyjny i nie stanowi porady prawnej. Przed wdrożeniem skonsultuj się z prawnikiem. Polski for WooCommerce jest oprogramowaniem open source (GPLv2) dostarczanym bez gwarancji.