Wszystko, co warto wiedzieć, zanim zainstalujesz.
Szczegółowe spojrzenie na to, jak działa Prezent gratis po przekroczeniu progu koszyka: PrestaShop 8 i 9, dlaczego zbudowaliśmy go w ten sposób i jaka myśl stoi za powyższymi funkcjami.
Najbardziej mierzalna dźwignia średniego koszyka
W sklepie e-commerce obrót budują dwie zmienne: liczba zamówień i średni koszyk. Koszt pozyskania nowego zamówienia stał się bardzo wysoki (reklama, SEO, retargeting). Odwrotnie, podniesienie koszyka klienta, który już jest bliski zakupu, kosztuje niemal nic: to upsell na ruchu już opłaconym. Prezent od progu koszyka to jedna z najskuteczniejszych mechanik w tym obszarze: klient dobrowolnie dorzuca kilka złotych, aby nie przegapić oferty. Pod warunkiem, że mechanika jest widoczna, wyliczona co do grosza i natychmiastowa. Dokładnie to robi dffreegift.
Blok postępu: mechanika psychologiczna co do grosza
Na stronie koszyka moduł stale wyświetla dedykowany baner ze zdjęciem produktu gratis, jego nazwą i komunikatem, który podaje pozostały dystans co do grosza: Dodaj 12,40 zł, aby otrzymać prezent. Kolorowy pasek postępu przechodzi stopniowo z szaropomarańczowego na zielony w miarę zbliżania się do progu. Po przekroczeniu baner robi się zielony z komunikatem Prezent dodany do koszyka, a animacja pulsowania wizualnie potwierdza sukces. Ta dramaturgia w czasie rzeczywistym zamienia zwykłą promocję warunkową w dźwignię zachowań: klient widzi wypełniający się wskaźnik, w myślach liczy potrzebny wysiłek i decyduje się.
Pod maską: natywny mechanizm PrestaShop, czysto
Ogromna większość modułów prezentowych na rynku manipuluje cenami produktów bezpośrednio przez hook actionProductPriceCalculation, tworzy linie koszyka z ceną wymuszoną na zero albo wstrzykuje tymczasowe SpecificPrice. Takie podejście później psuje zgodność z innymi modułami promocyjnymi, generuje niespójności w eksportach księgowych i utrudnia debugowanie. dffreegift robi odwrotnie: przy instalacji tworzy klasyczną regułę CartRule (widoczną w Katalog, Rabaty, Reguły koszyka) z kodem DFFREEGIFT i gift_product ustawionym na zero. Przy każdym zapisie koszyka moduł synchronizuje gift_product i gift_product_attribute z Twoją konfiguracją, a następnie dołącza albo odłącza regułę od koszyka natywnymi metodami Cart addCartRule i Cart removeCartRule. Resztę przejmuje PrestaShop: wstawienie linii prezentu (gift = 1, price = 0), wyświetlenie koszyka, sumy, konwersję na zamówienie, zapis historyczny. Żadnego bezpośredniego wywołania na cenach, żadnej inwazyjnej ingerencji, stąd natywna zgodność z Twoimi pozostałymi mechanizmami promocyjnymi.
Trzy wyzwalacze synchronizacji plus automatyczna naprawa
Główna logika wykonuje się na hooku actionCartSave, który PrestaShop wywołuje przy każdym zapisie koszyka, czyli przy każdym dodaniu, zmianie albo usunięciu produktu, ale też przy logowaniu klienta (scalanie koszyka) i przy niektórych akcjach w back office. Statyczna flaga antyrekurencyjna zapobiega temu, aby modyfikacja koszyka przez moduł nie wyzwalała hooka w pętli. Równolegle hook actionObjectCartRuleDeleteBefore obserwuje ręczne usunięcie naszej reguły z back office: jeśli administrator usunie regułę przez nieuwagę, konfiguracja jest resetowana, a kolejna synchronizacja odtworzy czystą regułę. Wreszcie przy każdym zapisie konfiguracji z ekranu Konfiguruj moduł ponownie synchronizuje gift_product i gift_product_attribute na istniejącej regule, więc nigdy nie musisz ręcznie dotykać reguły w sekcji Rabaty.
Konfiguracja: próg, podatek, wysyłka, stan, grupy
Ekran Moduły, DataFirefly Free Gift, Konfiguruj gromadzi wszystko. Główny przełącznik włączający i wyłączający całość. ID produktu gratis (wpisywane ręcznie, z nazwą wyświetlaną w pomocy po zapisie). Lista rozwijana wariantów produktu (wypełnia się po wcześniejszym zapisaniu ID produktu, moduł odczytuje wtedy dostępne kombinacje). Kwota progu z dwoma powiązanymi przełącznikami: przeliczanie brutto (inaczej netto) i uwzględnianie kosztów wysyłki (inaczej tylko produkty). Przełącznik weryfikacji stanu magazynowego prezentu, który wstrzymuje auto-dodawanie przy braku (z poszanowaniem strategii out of stock skonfigurowanej globalnie w PrestaShop). Siatka pól wyboru do ograniczenia oferty do wybranych grup klientów: przy braku zaznaczeń wszyscy klienci są uprawnieni, łącznie z niezalogowanymi gośćmi. Dwa niezależne przełączniki wyświetlania komunikatu postępu i paska postępu.
Typowe zastosowania
Sklep kosmetyczny z komfortową marżą: próbka perfum gratis powyżej 180 zł brutto, aby podnieść koszyki z przedziału 120 do 150 zł. Moda i akcesoria: kosmetyczka gratis od 350 zł brutto liczone bez kosztów wysyłki, aby zbudować lojalność przy pierwszych zakupach. Wyposażenie B2B: brelok albo pendrive powyżej 900 zł netto, ograniczone do grupy Profesjonaliści. Marketplace spożywczy: darmowy produkt do degustacji od 220 zł brutto z kosztami wysyłki, aby zamortyzować koszt darmowej dostawy i doprowadzić ją do rentowności. We wszystkich tych przypadkach mechanika jest identyczna: czytelny próg, pożądany prezent, widoczny postęp, automatyczne dodanie. dffreegift obsługuje to bez ręcznej interwencji.
Zgodność z PrestaShop 8 i 9: przetestowana, nie obiecana
Moduł korzysta wyłącznie ze stabilnych API działających w obu wersjach: Module, Hook, Configuration, CartRule, Cart, HelperForm, Smarty. Żadnego użycia zakładek produktu Symfony z PrestaShop 9 (które wprowadziły niezgodności w wielu modułach zewnętrznych), żadnej ingerencji w jednostronicowy checkout, żadnej zależności od klas przestarzałych w PS 9. Ekran administracyjny używa HelperForm, komponentu stabilnego i identycznego w PS 8 i PS 9. Po stronie frontu hook displayShoppingCart jest obecny i działa w obu wersjach, a helper getCurrentLocale (używany do formatowania cen) jest dostępny od PrestaShop 1.7.6. Instalujesz moduł dziś na PS 8, migrujesz na PS 9 kiedy chcesz: żadna interwencja przy module nie jest potrzebna.
Multistore, wielojęzyczność, czytelny kod
Moduł działa z konfiguracją multistore PrestaShop w kontekście domyślnego sklepu. Komunikaty na froncie są tłumaczalne przez standardowy mechanizm PrestaShop (Modules.Dffreegift.Shop dla frontu, Modules.Dffreegift.Admin dla back office), z gotowymi FR, EN, ES i DE. Kod źródłowy jest dostarczany jawnie (niezaszyfrowany PHP zgodny ze standardowymi konwencjami PrestaShop), z komentarzami po francusku na początku każdej ważnej metody. Główna logika mieści się w pliku dffreegift.php liczącym mniej niż 700 linii, czytelnym i możliwym do przeanalizowania w niespełna godzinę. Możesz go modyfikować, rozszerzać własnymi hookami albo sforkować pod konkretną potrzebę biznesową.
SpokoPrzetłumaczone automatycznie