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 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.

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ą.