PS PrestaShop Początkujący

Kupon urodzinowy: dokumentacja modułu PrestaShop

Instalacja modułu, konfiguracja kampanii urodzinowych, planowanie codziennej wysyłki i odczyt wygenerowanego obrotu.

Zaktualizowano Wersja modułu 2.0.2

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

  1. W Moduły > Menedżer modułów kliknij Załaduj moduł i wyślij plik ZIP.
  2. Moduł tworzy dwie tabele, rejestruje swoje hooki, generuje token zadania cron i kopiuje szablony e-maili dla każdego zainstalowanego języka.
  3. 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.

Kreator konfiguracji: wybór okazji i ofert, automatyzacja, test i aktywacja
Kreator konfiguracji: wybór okazji i ofert, automatyzacja, test i aktywacja

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.

E-mail

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.

Kampania urodzinowa: oferta, grupy docelowe, teksty w 8 językach i podgląd prawdziwego e-maila
Kampania urodzinowa: oferta, grupy docelowe, teksty w 8 językach i podgląd prawdziwego e-maila

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.

Kalendarz ważnych dat: urodziny i rocznice według dni, klienci dnia i status kodów
Kalendarz ważnych dat: urodziny i rocznice według dni, klienci dnia i status kodów

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.

Symulacja wybranego dnia i zadanie cron: adres URL, ostatnie uruchomienie i strefa czasowa sklepu
Symulacja wybranego dnia i zadanie cron: adres URL, ostatnie uruchomienie i strefa czasowa sklepu

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.

Potwierdzenie zamówienia: opcjonalna prośba o datę urodzenia, zapisywana bez opuszczania strony
Potwierdzenie zamówienia: opcjonalna prośba o datę urodzenia, zapisywana bez opuszczania strony

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.

Zasady wysyłki, wstrzymanie wysyłki i przypomnienie przed wygaśnięciem z podglądem e-maila
Zasady wysyłki, wstrzymanie wysyłki i przypomnienie przed wygaśnięciem z podglądem e-maila

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.

Otrzymany e-mail urodzinowy: osobisty kod, rabat, data ważności, przycisk zastosowania jednym kliknięciem i rezygnacja
Otrzymany e-mail urodzinowy: osobisty kod, rabat, data ważności, przycisk zastosowania jednym kliknięciem i rezygnacja

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.

Strefa klienta: link „Moje prezenty i ważne daty” w menu konta
Strefa klienta: link „Moje prezenty i ważne daty” w menu konta
Strona klienta: odliczanie do najbliższej daty, aktywny kod do skopiowania lub użycia, data urodzenia i preferencje
Strona klienta: odliczanie do najbliższej daty, aktywny kod do skopiowania lub użycia, data urodzenia i preferencje
Strona „Moje prezenty i ważne daty” na telefonie
Strona „Moje prezenty i ważne daty” na telefonie

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.

Panel: najbliższe 7 dni, wygenerowany przychód, współczynnik konwersji i wykres 12 miesięcy
Panel: najbliższe 7 dni, wygenerowany przychód, współczynnik konwersji i wykres 12 miesięcy
Wysłane kody: status aktywny, użyty lub wygasły, przypomnienie, powiązane zamówienie i eksport CSV
Wysłane kody: status aktywny, użyty lub wygasły, przypomnienie, powiązane zamówienie i eksport CSV
Karta klienta w panelu: wysłane kody na ważne daty, status i link do wszystkich kodów
Karta klienta w panelu: wysłane kody na ważne daty, status i link do wszystkich 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”.

Rezygnacja z e-maili z prezentami jednym kliknięciem, bez logowania, z potwierdzeniem
Rezygnacja z e-maili z prezentami jednym kliknięciem, bez logowania, z potwierdzeniem

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.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia