Zakupy Grupowe i Zbiorowa Cena Degresywna: kompletny przewodnik

Prezentacja i wymagania

Zakupy Grupowe wprowadzają zbiorową cenę degresywną: im więcej kupujących na danym produkcie, tym niższa cena jednostkowa dla wszystkich. Definiujesz progi (osiągnięcie liczby kupujących odblokowuje cenę), a moduł automatycznie stosuje cenę osiągniętego progu przez natywne ceny specyficzne PrestaShop. Bieżąca stawka wyświetla się więc wszędzie bez najmniejszej zmiany w Twoim motywie: karta produktu, listingi, koszyk i e-maile.

• Zgodny z PrestaShop 8.0 do 9.x, motyw Classic i motywy pochodne.
• PHP 7.4 do 8.3.
• Multisklep i wielojęzyczność (FR/EN/ES/DE/IT).
• Bez zadania CRON: przeliczenie jest sterowane zdarzeniami zamówień.
• Architektura zgodna ze standardami PrestaShop (ModuleAdminController, ObjectModel), bez zależności Composer.

Instalacja

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

1. Pobierz archiwum dfgroupbuy-1.0.2.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ł tworzy swoje tabele (kampanie, progi, uczestnicy), rejestruje hooki i dodaje zakładkę Zakupy Grupowe w menu Katalog. Pierwszą kampanię możesz utworzyć od razu.

Ustawienia ogólne modułu

Strona konfiguracji zbiera ustawienia globalne, wspólne dla wszystkich kampanii:

• Kolor główny i kolor akcentu: stosowane w widżecie na karcie produktu (pasek postępu, odznaki, bieżąca cena).
• Wyślij e-mail przy zwrocie różnicy: powiadamia kupującego, gdy zostanie mu przyznany kupon.
• Okres ważności kuponów: liczba dni ważności kuponów zwrotu różnicy (domyślnie 30).
• Interwał odświeżania: częstotliwość aktualizacji widżetu na żywo, w sekundach (domyślnie 30).

Tworzenie kampanii zakupów grupowych

W zakładce Katalog > Zakupy Grupowe kliknij Dodaj kampanię. Kampania wiąże produkt z siatką progów w oknie dat.

• Indeks: wewnętrzny identyfikator kampanii (dowolny).
• Produkt: wyszukaj i wybierz produkt objęty kampanią. Możesz wskazać konkretną kombinację albo zostawić wszystkie kombinacje.
• Nazwa i opis: teksty tłumaczalne, wyświetlane w widżecie.
• Tryb liczenia: patrz osobna sekcja poniżej.
• Tylko ważne zamówienia: liczy wyłącznie potwierdzone zamówienia (zalecane).
• Cena odniesienia: cena wyjściowa (przekreślona) przed jakimkolwiek progiem.
• Data początku i końca: okno aktywności kampanii.
• Zwrot różnicy: patrz osobna sekcja.
• Aktywna: włącza lub wstrzymuje kampanię.

Definiowanie progów

Każdy próg wiąże wartość progową (liczba kupujących, sztuk lub klientów, zależnie od trybu) z ceną jednostkową netto. Dodaj tyle progów, ile potrzebujesz, na przykład:

10 kupujących  → 18,00 € netto
50 kupujących  → 15,00 € netto
100 kupujących → 12,00 € netto

Przy każdym zapisie moduł przelicza bieżący próg i aktualizuje cenę specyficzną. Ceny muszą maleć wraz ze wzrostem wartości progowej.

Tryby liczenia

Tryb liczenia decyduje o tym, co zwiększa zbiorowy licznik:

• Zamówienia: liczba odrębnych zamówień zawierających produkt.
• Sprzedane sztuki: łączna liczba sprzedanych sztuk produktu.
• Unikalni klienci: liczba różnych klientów, którzy kupili produkt.

Opcja Tylko ważne zamówienia ogranicza liczenie do zamówień uznawanych przez PrestaShop za ważne (płatność zaakceptowana i podobne), co pozwala pominąć zamówienia anulowane lub oczekujące.

Cena zbiorowa w czasie rzeczywistym

Gdy tylko zamówienie zostaje zatwierdzone albo zmienia status, moduł przelicza kampanię, ustala osiągnięty próg i aktualizuje cenę specyficzną stosowaną wobec wszystkich kupujących. Nowa cena wyświetla się natychmiast wszędzie, bez żadnej interwencji. Żaden CRON nie jest potrzebny: wszystko jest sterowane zdarzeniami zamówień.

Cena progu ilościowego (zakup hurtowy)

W trybie Sprzedane sztuki klient zamawiający dużą ilość naraz samodzielnie przekracza próg: natychmiast otrzymuje cenę tego progu na własnym zamówieniu, nie czekając, aż osiągnie go zbiorowość. Na przykład przy progu 10 sztuk klient, który doda 10 egzemplarzy do koszyka, od razu płaci cenę progu 10.

Ta logika pozostaje zgodna z zasadą najlepszej ceny dla wszystkich: jeśli bieżąca cena zbiorowa jest już niższa niż cena progu ilościowego, obowiązuje cena zbiorowa. Całość przechodzi przez natywne ceny specyficzne (progi ilościowe), więc właściwa stawka widoczna jest już w koszyku.

Zwrot różnicy

Przy włączonej opcji obowiązuje zasada najlepszej ceny dla wszystkich: gdy tylko odblokuje się niższy próg, wcześniejsi kupujący automatycznie otrzymują kupon rabatowy równy różnicy między ceną, którą zapłacili, a nową ceną, pomnożonej przez kupioną ilość. E-mail powiadamiający jest wysyłany, jeśli opcja wysyłki jest aktywna.

• Kupon to imienny kod rabatowy (CartRule), ważny przez skonfigurowaną liczbę dni.
• Kupon otrzymują wyłącznie kupujący, którzy zapłacili więcej niż nowa cena.
• Cena efektywna każdego uczestnika jest aktualizowana, aby uniknąć podwójnego zwrotu przy kolejnych obniżkach.

Widżet na karcie produktu

Na karcie produktu moduł wyświetla widżet pokazujący dynamikę zbiorową:

• Odznaka oraz przekreślona cena odniesienia zestawiona z ceną bieżącą.
• Zbiorowy licznik i pasek postępu do następnego progu.
• Pełna skala progów z wyróżnionym progiem bieżącym.
• Odliczanie czasu do końca kampanii.
• Informacja o zwrocie różnicy, gdy opcja jest aktywna.

Całość odświeża się na żywo przez AJAX, w interwale zdefiniowanym w ustawieniach, bez przeładowania strony.

FAQ i rozwiązywanie problemów

Widżet nie wyświetla się na produkcie

Sprawdź, czy aktywna kampania rzeczywiście obejmuje ten produkt, czy dzisiejsza data mieści się między datą początku a datą końca, i czy kampania należy do bieżącego sklepu. Jeśli wskazujesz konkretną kombinację, widżet pojawia się tylko dla tej kombinacji.

Cena nie spada, choć próg został osiągnięty

Przeliczenie jest wyzwalane przez zatwierdzenie zamówień i zmiany statusu. Jeśli liczysz wyłącznie ważne zamówienia, upewnij się, że dane zamówienia rzeczywiście są w ważnym stanie. Zwykła edycja i zapis kampanii również wymusza przeliczenie.

Duży kupujący nie otrzymuje ceny swojej ilości

Cena progu ilościowego działa wyłącznie w trybie Sprzedane sztuki i dla wartości progowych równych co najmniej 2. W trybie Zamówienia lub Klienci ilość z jednego zamówienia sama nie przekracza progu.

Czy działa z kombinacjami?

Tak. Kampania może obejmować konkretną kombinację albo wszystkie kombinacje produktu. Kampania wskazująca konkretną kombinację ma pierwszeństwo przed kampanią obejmującą wszystkie kombinacje.

Co dzieje się przy deinstalacji?

Deinstalacja usuwa ceny specyficzne utworzone przez moduł, kasuje jego hooki i zakładkę oraz czyści jego tabele. Wydane już kupony rabatowe pozostają ważne po stronie klientów.