DF Quantity Tiers: dokumentacja

Prezentacja i wymagania

DF Quantity Tiers zamienia natywne rabaty ilościowe PrestaShop w czytelny i klikalny blok sprzedażowy. Moduł nie wprowadza żadnej nowej logiki cenowej: odczytuje ceny specyficzne „od N sztuk” już skonfigurowane w Twoim katalogu i prezentuje je w formie kart lub tabeli, z przyciskiem dodania do koszyka dla każdego progu.

• Zgodny z PrestaShop 8.0 do 9.x, szablon Classic i szablony pochodne.
• PHP 7.4 do 8.3.
• Multisklep i wielojęzyczność (FR/EN/ES/DE/IT).
• Brak nadpisywania plików: wyłącznie natywne hooki.

Instalacja

Zainstaluj moduł jak każdy inny moduł PrestaShop:

1. Pobierz archiwum dfquantitytiers-1.1.0.zip ze swojego konta klienta.
2. W panelu administracyjnym przejdź do Moduły > Menedżer modułów.
3. Kliknij Wgraj moduł i wskaż archiwum.
4. Po instalacji kliknij Konfiguruj.

Podczas instalacji moduł rejestruje swoje hooki, tworzy tabelę statystyk i wstępnie wypełnia tytuł bloku przetłumaczony na pięć języków. Twoje istniejące ceny progowe wyświetlają się natychmiast na odpowiednich kartach produktów.

Aktualizacja z wersji 1.0.0

Aktualizacja do wersji 1.1.0 przebiega standardowo z poziomu Menedżera modułów. Wbudowany skrypt aktualizacji tworzy tabelę statystyk, rejestruje nowy hook strony koszyka i ustawia wartości domyślne nowych opcji (tryb podatkowy, JSON-LD, zachęta w koszyku, statystyki, etykiety opakowań). Żadne działanie ręczne nie jest potrzebne, a Twoja dotychczasowa konfiguracja zostaje zachowana.

Konfiguracja ogólna

Strona konfiguracji skupia wszystkie ustawienia wyświetlania:

• Tytuł bloku: tekst wyświetlany nad progami, tłumaczony per język.
• Układ: „Karty” (zalecany, jedna karta na próg) lub „Kompaktowa tabela” (jeden wiersz na próg).
• Pozycja na karcie produktu: pod blokiem zakupu (hook displayProductAdditionalInfo, domyślnie) lub bezpośrednio pod ceną (hook displayProductPriceBlock).
• Kolor akcentu: stosowany do progu „Najlepsza oferta”, odznak i przycisków.
• Wyświetlanie oszczędności: w procentach, kwotowo lub oba naraz.
• Pokaż cenę całkowitą progu: dodaje sumę dla ilości danego progu.
• Pokaż próg jednostkowy: wyświetla cenę bazową jako pierwszy próg porównawczy.

Tryb podatkowy (B2B)

Tryb podatkowy decyduje, czy ceny progów są wyświetlane netto czy brutto:

• Automatyczny: podąża za ustawieniem wyświetlania bieżącej grupy klienta (standardowe zachowanie PrestaShop).
• Wymuszony netto: zawsze wyświetla ceny netto, z oznaczeniem „netto” obok każdej ceny jednostkowej. Idealny dla sklepu profesjonalnego.
• Wymuszony brutto: zawsze wyświetla ceny brutto, z oznaczeniem „brutto”.

Wybrany tryb stosuje się jednocześnie do kart na karcie produktu i do bloku zachęty w koszyku.

Etykiety opakowań

Możesz przypisać etykietę branżową do każdej ilości, na przykład „karton” albo „paleta”. W polu Etykiety opakowań wpisz jedno przypisanie na wiersz w formacie ilość=etykieta:

12=Karton 12 sztuk
48=Półpaleta
96=Paleta

Etykieta wyświetla się pod ilością odpowiedniego progu. Pole jest tłumaczone: uzupełnij je w każdym języku z poziomu przełącznika języków w formularzu.

Zachęta do wyższego progu

Dostępne są dwa mechanizmy zachęty, włączane niezależnie od siebie.

Na karcie produktu

Pasek postępu wyświetla komunikat typu „Dodaj jeszcze 3 sztuki, aby zaoszczędzić 15 procent”, przeliczany w czasie rzeczywistym według wpisanej ilości. Gdy klient osiąga najkorzystniejszy próg, komunikat zmienia się na „Korzystasz z najwyższego rabatu!”.

Na stronie koszyka

Dla każdego produktu w koszyku, dla którego wyższy próg pozostaje osiągalny, moduł wyświetla pod koszykiem blok „Dodaj jeszcze N sztuk, aby przejść na X euro za sztukę” wraz z przyciskiem dodania jednym kliknięciem. Przycisk korzysta z natywnego mechanizmu aktualizacji koszyka PrestaShop, po czym odświeża stronę. Jeśli żaden wyższy próg nie jest osiągalny, blok nie jest wyświetlany.

Dane strukturalne (JSON-LD)

Gdy opcja jest włączona, moduł dodaje na karcie produktu znaczniki JSON-LD typu AggregateOffer, z jedną ofertą na próg i przypisaną do niej kwalifikującą ilością. Dzięki temu wyszukiwarki rozumieją Twoje przedziały cenowe według ilości.

Statystyki kliknięć per próg

Gdy opcja jest włączona, każde kliknięcie przycisku dodania per próg jest rejestrowane anonimowo: produkt, wariant, ilość i rabat klikniętego progu. Nie są używane żadne dane osobowe ani pliki cookie, co czyni funkcję zgodną z RODO.

Strona konfiguracji wyświetla pulpit z ostatnich 30 dni: łączną liczbę kliknięć oraz ranking najczęściej klikanych kombinacji produkt / próg / rabat. Te dane pomagają skalibrować rabaty przez wskazanie progów, które faktycznie wywołują dodania do koszyka.

FAQ i rozwiązywanie problemów

Blok nie wyświetla się na produkcie

Sprawdź, czy produkt ma ceny specyficzne z ilością początkową większą niż 1 oraz czy te ceny obowiązują dla bieżącej grupy klienta, waluty i kraju. Sam próg bazowy nie wywołuje wyświetlenia, jeśli nie istnieje żaden próg rabatowy.

Przycisk dodania nie działa z moim szablonem

Moduł opiera się na standardowym przycisku dodania do koszyka szablonu Classic. W silnie zmodyfikowanym szablonie upewnij się, że pole ilości i przycisk dodania zachowują standardowy kod HTML PrestaShop.

Czy działa z wariantami?

Tak. Progi są przeliczane dla każdej kombinacji, a blok aktualizuje się automatycznie przy zmianie wariantu, bez przeładowania strony.

Co dzieje się przy odinstalowaniu?

Odinstalowanie czysto usuwa hooki, zmienne konfiguracyjne i tabelę statystyk. W bazie nie pozostają żadne dane resztkowe.