# Moduł Cena „Od” (dffromprice): dokumentacja

> Moduł dffromprice („Od”) wyświetla najniższą cenę ilościową bezpośrednio na listach produktów, gdy tylko produkt ma rabat ilościowy. Ta dokumentacja obejmuje instalację, pełną konfigurację i rozwiązywanie problemów. Wprowadzenie Gdy produkt ma…

- Strona: <https://www.datafirefly.com/pl/documentation/dffromprice/>
- Język: pl
- Zaktualizowano: 2026-07-31
- Inne języki: [fr](https://www.datafirefly.com/documentation/dffromprice/index.md), [en](https://www.datafirefly.com/en/documentation/dffromprice/index.md), [es](https://www.datafirefly.com/es/documentation/dffromprice/index.md), [de](https://www.datafirefly.com/de/documentation/dffromprice/index.md), [it](https://www.datafirefly.com/it/documentation/dffromprice/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffromprice/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffromprice/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

Moduł **dffromprice** („Od”) wyświetla najniższą cenę ilościową bezpośrednio na listach produktów, gdy tylko produkt ma rabat ilościowy. Ta dokumentacja obejmuje instalację, pełną konfigurację i rozwiązywanie problemów.

## Wprowadzenie

Gdy produkt ma rabaty ilościowe (na przykład „3 sztuki = 20% oszczędności”), informacja ta jest widoczna wyłącznie na karcie produktu, na samym dole. Moduł przenosi etykietę „Od X zł” na miniaturę produktu: do kategorii, wyszukiwarki, bloków sprzedaży krzyżowej i produktów wyróżnionych. Wyświetlana cena jest obliczana natywnym mechanizmem PrestaShop, z uwzględnieniem grupy klientów, waluty, kraju i metody naliczania podatku.

## Instalacja

### Przez panel administracyjny

1. Przejdź do _Moduły > Menedżer modułów_.
2. Kliknij _Zainstaluj moduł_ i wybierz plik ZIP modułu.
3. Po zakończeniu przesyłania moduł instaluje się automatycznie i rejestruje swoje hooki.

### Przez FTP

1. Rozpakuj archiwum i umieść katalog `dffromprice` w folderze `/modules` swojego sklepu.
2. W _Moduły > Menedżer modułów_ wyszukaj „Od” i kliknij _Zainstaluj_.

Po instalacji wyczyść pamięć podręczną PrestaShop (_Ustawienia zaawansowane > Wydajność > Wyczyść pamięć podręczną_), aby style CSS modułu zostały uwzględnione.

## Ustawienia

Konfiguracja znajduje się w _Moduły > Menedżer modułów > dffromprice > Konfiguruj_. Jest podzielona na dwa panele.

### Wyświetlanie

- **Włącz moduł**: przełącznik główny.
- **Pokazuj na listach produktów**: kategorie, wyszukiwarka, sprzedaż krzyżowa, produkty wyróżnione.
- **Pokazuj na karcie produktu**: dodaje cenę „Od” za ceną główną na karcie produktu.
- **Etykieta**: tekst wyświetlany przed ceną, tłumaczony osobno dla każdego języka („Od”, „From” i tak dalej).
- **Pokazuj minimalną ilość**: wskazuje ilość wymaganą do uzyskania najlepszej ceny.
- **Etykieta ilości**: tekst towarzyszący ilości, ze zmienną `%qty%` (na przykład „od %qty% sztuk”).
- **Pokazuj procent oszczędności**: plakietka „-21%” wyliczana z różnicy między ceną bazową a najlepszą ceną ilościową.
- **Etykieta podatku (brutto / netto)**: Nigdy, Zgodnie z ustawieniami sklepu, albo Zawsze.
- **Tryb wyświetlania**: _Zastąp cenę zwykłą_ albo _Pokaż obok ceny zwykłej_.
- **Selektory CSS do ukrycia**: w trybie zastąpienia selektory CSS ukrywane, gdy pojawia się cena „Od”.

### Wygląd i ograniczenia

- **Kolor tekstu**: próbnik kolorów, domyślnie `#f1a019`.
- **Minimalna oszczędność do wyświetlenia (%)**: ukrywa cenę „Od”, jeśli oszczędność jest niższa od tego progu. 0 oznacza wyświetlanie zawsze.
- **Wykluczone ID produktów**: lista identyfikatorów rozdzielonych przecinkami.
- **Wykluczone ID kategorii**: lista identyfikatorów rozdzielonych przecinkami (na podstawie domyślnej kategorii produktu).
- **Własny CSS**: dodawany na wszystkich stronach witryny, do stylowania bloku `.df-fromprice` i jego elementów podrzędnych.

## Działanie i obliczanie ceny

Moduł opiera się na `SpecificPrice::getQuantityDiscounts()` z tymi samymi parametrami co natywna tabela „Rabat ilościowy” (sklep, waluta, kraj, grupa klientów, klient). Dla każdego progu ilościowego większego niż 1 rzeczywista cena jednostkowa jest obliczana przez `Product::getPriceStatic()`. Cena „Od” pojawia się wyłącznie wtedy, gdy jest ściśle niższa od ceny bazowej. Statyczna pamięć podręczna dla każdego produktu i każdej odmiany gwarantuje jedno zapytanie obliczeniowe na miniaturę w obrębie jednej strony.

## Zgodność z motywami

Moduł podpina się pod hook `displayProductPriceBlock`, obecny we wszystkich standardowych listach produktów PrestaShop. W trybie zastąpienia cena zwykła jest ukrywana przez konfigurowalny selektor CSS. Wartość domyślna obsługuje motywy oparte na Classic oraz motyw Falcon:

```
.df-fromprice + .wrapper-price-taxe, .df-fromprice + .price
```

W innym motywie sprawdź kontener ceny w miniaturze i odpowiednio dostosuj selektor.

## Rozwiązywanie problemów

### Cena „Od” się nie wyświetla

- Sprawdź, czy produkt faktycznie ma rabat ilościowy (próg ilościowy większy niż 1) i czy cena progowa jest niższa od ceny bazowej.
- Sprawdź, czy wyświetlanie na listach produktów jest włączone.
- Zweryfikuj minimalny próg oszczędności: jeśli jest zbyt wysoki, może blokować wyświetlanie.
- Upewnij się, że produkt ani jego kategoria nie znajdują się na listach wykluczeń.

### Cena zwykła pozostaje widoczna w trybie zastąpienia

Selektor CSS odpowiedzialny za ukrywanie nie pasuje do kontenera ceny w Twoim motywie. Popraw pole „Selektory CSS do ukrycia”, a następnie wyczyść pamięć podręczną.

Po każdej zmianie ustawień lub CSS wyczyść pamięć podręczną PrestaShop i wygeneruj ponownie plik CSS, aby zmiany zostały zastosowane.