Kupon urodzinowy: dokumentacja modułu PrestaShop
Instalacja modułu, konfiguracja kampanii urodzinowych, planowanie codziennej wysyłki i odczyt wygenerowanego obrotu.
Wprowadzenie
Moduł automatycznie wysyła klientom osobisty kod rabatowy przy trzech okazjach: w urodziny, w rocznicę pierwszego ważnego zamówienia i w rocznicę założenia konta. Każdy kod jest natywną regułą koszyka PrestaShop, zarezerwowaną dla klienta i do jednorazowego użytku. Następnie moduł mierzy obrót zamówień złożonych z tymi kodami.
Zgodność: PrestaShop 1.7.8 do 9.x (PHP 7.4 do 8.5), motywy Classic i Hummingbird, multistore, 8 języków (angielski, francuski, hiszpański, niemiecki, włoski, niderlandzki, polski, portugalski).
Nowość w wersji 2.0.2: treść e-maili formatowana edytorem PrestaShop lub pisana bezpośrednio w HTML.
Nowość w wersji 2.0.1: wybór produktów objętych każdą kampanią (cały katalog, tylko wybrane produkty i kategorie albo wszystko oprócz wybranych), podany klientowi w e-mailu.
Nowości w wersji 2.0.0: kreator konfiguracji, kalendarz ważnych dat, prawdziwy podgląd e-maili (komputer i telefon), symulacja dowolnego dnia, wstrzymanie wysyłki, wybór adresu dla e-maili testowych, link rezygnacji bez logowania w każdym e-mailu, usunięcie daty urodzenia przez klienta, daty zapisane słownie w języku klienta, obsługa PrestaShop 1.7.8 i Hummingbird. Wersja 2.0.0 poprawia też zapisywanie ustawień w panelu i filtry w PrestaShop 9.
Instalacja
- W Moduły > Menedżer modułów kliknij Załaduj moduł i wyślij plik ZIP.
- Moduł tworzy dwie tabele, rejestruje swoje hooki, generuje token zadania cron i kopiuje szablony e-maili dla każdego zainstalowanego języka.
- W menu Klienci pojawia się nowa zakładka Urodziny i ważne daty. Prowadzi do niej także przycisk Konfiguruj modułu.
Aby przejść z wersji 1.x na 2.0.2, wystarczy wysłać nowy plik ZIP. Kampanie, teksty, historia kodów i statystyki zostają zachowane; sklep, który nigdy nie zapisał kampanii, zachowuje włączone kampanie urodzinową i rocznicy pierwszego zamówienia, tak jak w 1.x.
Kreator konfiguracji
Po nowej instalacji żadna kampania nie jest aktywna: klienci nic nie otrzymają, dopóki nie klikniesz Aktywuj moje kampanie. Panel wyświetla kreator w trzech krokach: wybór okazji i rabatu, wybór automatyzacji (zadanie cron i zapasowe uruchamianie przy wizytach, prośba o datę urodzenia po zamówieniu), a następnie podanie adresu e-maili testowych i aktywacja. Link Pomiń, skonfiguruję samodzielnie prowadzi bezpośrednio do zakładki Kampanie.

Następnie panel wyświetla listę „Pierwsze kroki”, dopóki nie zostaną wykonane cztery podstawowe kroki: włączenie kampanii, wysłanie do siebie testowego e-maila, zaplanowanie codziennego zadania i zbieranie dat urodzenia.
Konfiguracja kampanii
Zakładka Kampanie zawiera jedną kartę na okazję. Włącz ją przełącznikiem w prawym górnym rogu: pojawią się ustawienia i podgląd e-maila.
Oferta
- Rodzaj rabatu: procent, stała kwota (w walucie domyślnej) lub darmowa dostawa.
- Wartość oraz Dodatkowo darmowa dostawa do procentu lub kwoty.
- Minimalna wartość zamówienia (z VAT): 0 oznacza brak minimum.
- Ważność po dacie: liczba dni ważności kodu od daty okazji.
- Wyślij z wyprzedzeniem: liczba dni przed datą. 0 wysyła w dniu okazji.
- Wzrost za każdy kolejny rok i Wartość maksymalna (rocznica zamówienia i konta): na przykład 10 % w pierwszym roku, +2 co roku, maksymalnie 20 %.
- Wyklucz produkty już przecenione i Można łączyć z innymi kuponami.
Produkty objęte kodem
Domyślnie kod obowiązuje na Cały katalog. Wybierz Tylko wybrane produkty lub Wszystko oprócz wybranych produktów, a następnie dodaj kategorie (z podkategoriami) i produkty, wyszukując je po nazwie, indeksie lub ID. Liczba objętych produktów jest wyświetlana pod wyborem, a e-mail informuje klienta, na jakie produkty kod jest ważny.
- Procent: rabat dotyczy tylko objętych produktów; pozostałe produkty w koszyku zachowują swoją cenę.
- Stała kwota lub darmowa dostawa: kod jest akceptowany, gdy koszyk zawiera co najmniej jeden objęty produkt.
- Przy opcji Wszystko oprócz wybranych produktów albo przy jednoczesnym wyborze kategorii i produktów lista produktów jest ustalana w chwili wysłania kodu: produkt dodany później do katalogu nie jest objęty już wysłanymi kodami.
W PrestaShop 1.7 procent od wybranych produktów jest liczony od ceny przed rabatami samego produktu. Zaznacz Wyklucz produkty już przecenione, aby przeceniony produkt nie otrzymał obu rabatów.
Kto go otrzymuje
- Minimalna liczba ważnych zamówień: 0 przy urodzinach obejmuje klientów, którzy nigdy nie zamawiali.
- Prefiks kodu: na przykład BDAY daje kody w rodzaju BDAY-7KQ2M9.
- Grupy klientów: brak zaznaczenia oznacza wszystkie grupy.
Temat, nagłówek i treść edytujesz dla każdego języka w zakładkach językowych. Podgląd po prawej pokazuje prawdziwy szablon e-maila, tak jak otrzyma go klient, z rzeczywistym rabatem; aktualizuje się podczas pisania i przełącza na szerokość telefonu ikoną telefonu. Przyciski znaczników wstawiają znacznik w miejscu kursora. Dostępne znaczniki: {firstname}, {lastname}, {discount}, {code}, {expiry_date}, {min_amount}, {years} (poza urodzinami) i {shop_name}. Puste pole używa domyślnego tekstu języka.
Przycisk Zapisz i wyślij test wysyła e-mail, w języku pracownika, na adres podany w polu E-maile testowe są wysyłane na adres u góry zakładki (domyślnie adres zalogowanego pracownika).
Treść tworzy się w edytorze PrestaShop: pogrubienie, kolory, listy, linki, tabele, nagłówki i obrazy z menedżera plików. Przycisk <> pozwala pisać lub wklejać HTML. Przy zapisie moduł usuwa to, co w e-mailu stanowi zagrożenie (skrypty, formularze, osadzone ramki, linki javascript:), zamienia linki i obrazy na adresy bezwzględne i tworzy wersję tekstową e-maila. Znaczniki wstawiają się w miejscu kursora i działają także w HTML. Wiadomość zapisana przed wersją 2.0.2 pozostaje zwykłym tekstem i jest wysyłana jak wcześniej.

Kalendarz ważnych dat
Zakładka Kalendarz pokazuje miesiąc i dla każdego dnia liczbę klientów obchodzących urodziny, rocznicę pierwszego zamówienia lub rocznicę konta. Stosuje te same filtry co wysyłka: grupy, minimalną liczbę zamówień, gości, subskrybentów newslettera i klientów, którzy zrezygnowali. Kliknij dzień, aby zobaczyć listę klientów z ich ofertą i statusem kodu: zaplanowano (z datą wysyłki przy wysyłce z wyprzedzeniem), kod wysłany, użyty lub nie wysłano. Przycisk Symuluj uruchamia symulację tego dnia. Okres oczekiwania po zmianie daty urodzenia jest sprawdzany w dniu wysyłki.

Planowanie codziennej wysyłki
W Automatyzacja i ustawienia skopiuj adres URL zadania cron i wywołuj go raz dziennie, najlepiej wcześnie rano. Przykładowa linia cron:
0 7 * * * curl -s "https://twoj-sklep.pl/module/dfkeydates/cron?token=TWOJ_TOKEN" >/dev/null
Każde uruchomienie tworzy kody na dany dzień, wysyła e-maile i przypomnienia, łączy użyte kody z zamówieniami i usuwa wygasłe, nieużyte kody.
- Nadrabianie pominiętych dni (domyślnie 2): jeśli zadanie się nie uruchomiło, przetwarzane są daty z poprzednich dni.
- Maksymalna liczba kodów na uruchomienie (domyślnie 200): reszta zostanie wysłana przy następnym uruchomieniu.
- Uruchamiaj także podczas wizyt: bez crona moduł uruchamia się przy wizytach w sklepie, najwyżej raz na godzinę, po wysłaniu strony. Zatrzymuje się, gdy tylko w ciągu ostatnich 26 godzin zostanie wywołany prawdziwy cron.
Na tej samej stronie przycisk Symuluj pokazuje kody, które zostałyby wysłane w dniu wybranym w polu Dzień do symulacji, niczego nie tworząc ani nie wysyłając. Przyciski Uruchom teraz, Ponownie zsynchronizuj użyte kody i Nowy token uzupełniają kartę, która pokazuje też, czy zadanie cron zostało wykryte, oraz strefę czasową sklepu: daty są liczone według strefy ustawionej w Międzynarodowy > Lokalizacja, a nie serwera.
Wstrzymaj wysyłkę do zatrzymuje wysyłkę na czas zamknięcia sklepu lub urlopu. Komunikat przypomina o tym na każdej zakładce. Daty pominięte w czasie pauzy są nadrabiane w ramach limitu nadrabiania.
Każdy klient otrzymuje najwyżej jeden kod na okazję i rok. Zadanie możesz więc uruchamiać wielokrotnie bez ryzyka duplikatów.

Ochrona przed nadużyciami i zbieranie dat urodzenia
Okres oczekiwania po rejestracji lub zmianie daty urodzin (domyślnie 30 dni) blokuje kod urodzinowy dla konta zbyt nowego lub takiego, w którym data została właśnie wpisana albo zmieniona w sklepie. Zmiany wprowadzone przez pracownika w panelu administracyjnym nie uruchamiają tego okresu.
Daty urodzenia pochodzą z natywnego pola konta klienta (Klienci > Ustawienia > Data urodzenia). Jeśli to pole jest wyłączone, moduł zbiera je sam:
- na stronie potwierdzenia zamówienia, gdy data jest nieznana (opcja Pytaj o datę urodzenia na stronie potwierdzenia zamówienia, jeśli jest nieznana);
- na stronie Moje prezenty i ważne daty w koncie klienta.
Panel pokazuje odsetek kont ze znaną datą. Na stronie potwierdzenia zamówienia data jest zapisywana bez opuszczania strony; prośba informuje, że podanie daty jest opcjonalne i służy wyłącznie do prezentu urodzinowego. Nie jest wyświetlana klientowi, który zrezygnował z tych e-maili.

Przypomnienie przed wygaśnięciem
Włącz przypomnienie i wybierz, ile dni przed wygaśnięciem ma zostać wysłane. Wychodzi tylko wtedy, gdy kod nie został użyty. Teksty przypomnienia i tekst przycisku wszystkich e-maili ustawia się dla każdego języka. Przycisk Wyślij testowe przypomnienie zapisuje ustawienia i wysyła Ci przykład.

Kod jednym kliknięciem
Przycisk w każdym e-mailu prowadzi do podpisanego linku przypisanego do kodu. Moduł zapamiętuje kod i dodaje go do koszyka, gdy tylko klient się zaloguje i ma produkty w koszyku. Jeśli klient nie jest zalogowany, trafia na stronę logowania. Jeśli minimalna wartość zamówienia nie została osiągnięta, kod czeka i zostaje zastosowany, gdy tylko to nastąpi. Kod wygasły, już użyty lub przeznaczony dla innego klienta jest odrzucany z komunikatem.
Daty w e-mailach są zapisane słownie w języku klienta (na przykład „4 grudnia 2026”). Każdy e-mail zawiera link Zarządzaj ofertami na ważne daty oraz link Nie chcę otrzymywać tych e-maili z prezentami, działający bez logowania.

Strona klienta „Moje prezenty i ważne daty”
Dostępna z poziomu Moje konto, pokazuje aktywne kody z przyciskiem kopiowania i przyciskiem Użyj w koszyku, najbliższe ważne daty klienta z odliczaniem, formularz daty urodzenia z linkiem Usuń moją datę urodzenia, poprzednie prezenty i przełącznik otrzymywania tych e-maili. Kod, który wygasa za mniej niż 3 dni, jest wyróżniony. Strona dostosowuje się do motywów Classic i Hummingbird oraz do telefonów. Można ją ukryć w ustawieniach; link pojawia się w Moje konto tylko wtedy, gdy aktywna jest co najmniej jedna kampania.



Statystyki i śledzenie obrotu
Zakładka Pulpit pokazuje dla wybranego okresu:
- wygenerowany obrót netto i brutto, liczony na ważnych zamówieniach, w których użyto kodu, przeliczony na walutę domyślną;
- kody wysłane i użyte, współczynnik konwersji i średnią wartość koszyka;
- udzielony rabat i zwrot (obrót podzielony przez rabat);
- zamówienia bez kodu złożone w okresie ważności kodu;
- wykres z 12 miesięcy, wyniki według okazji, wysyłki z najbliższych 30 dni i ostatnie zamówienia z kodem.
Obrót jest przypisywany do okresu wysłania kodu. Zakładka Wysłane kody zawiera wszystkie kody z wyszukiwarką, filtrami według okazji, statusu i daty, ponowną wysyłką e-maila dla aktywnego kodu i eksportem CSV. Karta klienta w panelu administracyjnym również pokazuje kody wysłane do tego klienta.
Panel pokazuje także najbliższe 7 dni: każdy dzień podaje liczbę klientów według okazji i prowadzi do kalendarza. W zakładce Wysłane kody szybkie filtry według statusu (aktywny, użyty, wygasły) pokazują liczbę kodów.



Czyszczenie wygasłych kodów
Ustawienie Usuwaj wygasłe, nieużyte kody po (domyślnie 30 dni) usuwa odpowiadające im reguły koszyka, aby lista Katalog > Rabaty pozostała czytelna. Historia i statystyki modułu są zachowywane. Ustaw 0, aby nigdy nie usuwać.
RODO
Moduł rejestruje się w oficjalnym module RODO PrestaShop. Eksport danych klienta obejmuje jego kody i preferencje, a usunięcie kasuje historię modułu dla tego klienta. Każdy klient może zrezygnować z tych e-maili w swoim koncie lub, bez logowania, za pomocą linku w każdym e-mailu: link otwiera stronę potwierdzenia, dzięki czemu oprogramowanie otwierające linki w e-mailach nikogo nie wypisuje. Klient może też usunąć swoją datę urodzenia na stronie „Moje prezenty i ważne daty”.

Multistore
Kampanie i ustawienia są osobne dla każdego sklepu. Wybierz sklep w menu multistore, aby je edytować. Utworzone kody są ograniczone do danego sklepu.
Najczęstsze pytania i rozwiązywanie problemów
Nie jest wysyłany żaden kod
Sprawdź, czy włączona jest co najmniej jedna kampania i czy wysyłka nie jest wstrzymana, a następnie otwórz Kalendarz lub użyj Symuluj. Jeśli lista jest pusta, żaden klient nie spełnia dziś kryteriów: nieznana data, trwający okres oczekiwania, grupa niewybrana, za mało zamówień lub klient, który zrezygnował.
E-maile nie docierają
Wyślij testowy e-mail z kampanii. Jeśli nie dociera, sprawdź konfigurację poczty PrestaShop w Zaawansowane > E-mail. Kod, którego e-mail się nie powiódł, jest oznaczony na liście kodów i można go wysłać ponownie.
Zamówienia brakuje w statystykach
Liczone są tylko ważne zamówienia. Jeśli zamówienie utworzył w panelu administracyjnym pracownik bez uprawnień do modułu, kliknij Ponownie zsynchronizuj użyte kody; codzienne zadanie robi to również automatycznie.