Kupon urodzinowy – instrukcja obsługi modułu PrestaShop

1. Co robi moduł

Życzenia urodzinowe z małym prezentem to jeden z niewielu e-maili marketingowych, które klienci chętnie dostają. Moduł wysyła każdemu klientowi, który podał datę urodzenia, osobisty kod rabatowy na urodziny — np. 15% zniżki ważne 14 dni — e-mailem w jego języku, raz w roku. Kod to zwykły kupon PrestaShop, którego może użyć tylko ten klient; znajdzie go też w zakładce Kupony na swoim koncie.

Ty wybierasz rabat (procent, stała kwota albo darmowa dostawa), czas ważności, minimalny koszyk, ile dni przed urodzinami wysłać kod i kto go dostaje (wszyscy klienci, tylko zapisani do newslettera, tylko ci, którzy już zamawiali).

Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z motywami Classic i Hummingbird oraz w trybie multistore.

2. Instalacja

1. Pobierz moduł z Moje konto → Historia zamówień w addonspresta.com.
2. W panelu administracyjnym otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
3. Upuść plik ap_birthdaycoupon_v1.0.0.zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj na karcie modułu.

Moduł działa zaraz po instalacji: w dniu urodzin klienci dostają kod na 15% ważny 14 dni, wysyłany przy pierwszej wizycie dnia w Twoim sklepie. Zajrzyj do panelu Daty urodzenia i codzienne wysyłanie: jeśli PrestaShop jeszcze nie pyta o datę urodzenia, kliknij Włącz pole daty urodzenia.

3. Jak to działa

PrestaShop pyta klientów o datę urodzenia w formularzu rejestracji i na koncie, gdy włączona jest opcja Preferencje → Klienci → Pytanie o datę urodzenia. Raz dziennie moduł szuka klientów każdego sklepu, którzy mają dziś urodziny (albo będą je mieć za wybraną liczbę dni), i dla każdego tworzy kod — kupon w Katalog → Rabaty z opisem ap_birthdaycoupon <rok>, przypisany do klienta, jednorazowy, wyróżniony w koszyku — oraz wysyła e-mail z życzeniami.

• Raz w roku. Klient dostaje jeden kod na jedne urodziny, niezależnie od tego, ile razy uruchomi się wysyłanie.
• Klienci z kontem, aktywni, z poprawnym adresem e-mail. Goście nie są brani pod uwagę.
• 29 lutego. Osoby urodzone 29 lutego dostają kod 28 lutego w latach nieprzestępnych.
• Ważny od dnia urodzin przez wybraną liczbę dni, do końca ostatniego dnia. Kod wysłany kilka dni wcześniej działa od dnia wysłania.

Codzienne wysyłanie uruchamia się na jeden z trzech sposobów:

• Zadanie cron (zalecane): serwer raz dziennie, o wybranej godzinie, wywołuje adres widoczny w panelu.
• Pierwsza wizyta dnia: gdy nie działa cron, uruchamia je pierwszy odwiedzający danego dnia (domyślnie włączone).
• Wyślij dzisiejsze kody teraz w panelu.

Uruchomienie z crona albo przyciskiem wysyła najwyżej 200 kodów, a uruchomienie przy wizycie najwyżej 25; kolejne kontynuuje z resztą. Moduł nie łączy się z addonspresta.com ani z żadnym innym serwerem i nie zapisuje ciasteczek.

4. Funkcje i ustawienia

Otwórz Moduły → Menedżer modułów → Kupon urodzinowy → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu.

Daty urodzenia i codzienne wysyłanie

• Ostrzeżenie i przycisk Włącz pole daty urodzenia, gdy PrestaShop nie pyta o datę urodzenia w sklepie z bieżącego wyboru.
• Dla każdego sklepu: ilu klientów podało datę urodzenia i kiedy ostatnio zakończyło się wysyłanie.
• Zadanie cron z adresem. Nie udostępniaj tego adresu: zawiera token, a każdy, kto go zna, może uruchomić codzienne wysyłanie (nic innego nim nie zrobi).
• Wyślij dzisiejsze kody teraz — uruchamia wysyłanie dla sklepów wybranych w nagłówku. Klienci, którzy mają już tegoroczny kod, nie dostaną kolejnego.

Kody urodzinowe

• Wysyłaj kody urodzinowe — wyłącza moduł bez utraty ustawień; wysłane kody nadal działają.
• Wysyłaj kod … dni przed urodzinami — 0 oznacza w dniu urodzin, najwyżej 30 dni wcześniej.
• Tylko klienci zapisani do newslettera — e-mail urodzinowy z ofertą to marketing. W UE wysyłaj go tylko klientom, którzy się na to zgodzili, np. zapisując się do newslettera.
• Tylko klienci, którzy już zamawiali — klienci z co najmniej jednym opłaconym zamówieniem.
• Uruchamiaj przy pierwszej wizycie dnia — dla sklepów bez zadania cron. Jeśli masz cron, możesz to wyłączyć.

Rabat

• Rodzaj rabatu — Procent od produktów, Stała kwota albo Darmowa dostawa.
• Wartość rabatu — procent od 0,01 do 100 albo kwota brutto w walucie domyślnej; nie dotyczy darmowej dostawy.
• Ważny przez — od 1 do 365 dni, liczonych od dnia urodzin.
• Minimalna wartość koszyka, żeby użyć kodu — brutto; 0 oznacza brak minimum.
• Bez produktów już przecenionych — rabat pomija produkty z ceną specjalną albo regułą cenową katalogu.
• Można łączyć z innymi kuponami — po wyłączeniu kodu nie da się użyć razem z innym kuponem.
• Nazwa kuponu — w każdym języku, widoczna w koszyku i w zakładce Kupony. Domyślnie „Wszystkiego najlepszego!”.
• Przedrostek kodu — do 10 liter, cyfr lub łączników przed 8 losowymi znakami, np. BDAY-7KQ2M9XA.

Zmiany dotyczą kodów wysłanych później. Wysłany już kod zmienisz w Katalog → Rabaty.

Wydane kody

Ostatnie 50 kodów sklepów wybranych w nagłówku: data, klient, dzień urodzin (dzień i miesiąc), kod, rabat, data ważności, status — Niewykorzystany, Wykorzystany, Wygasł albo Usunięty — i to, czy e-mail został wysłany.

5. Multistore

Ustawienia zapisują się dla sklepu albo grupy sklepów wybranej w nagłówku panelu. Wybierz Wszystkie sklepy, żeby wszędzie obowiązywały te same zasady, albo jeden sklep, żeby dać mu własny rabat i teksty. Każdy klient dostaje kod sklepu, w którym się zarejestrował, ważny tylko w tym sklepie. Adres crona uruchamia wszystkie sklepy. W kontekście wszystkich sklepów lub grupy zapisać ustawienia albo włączyć pole daty urodzenia może tylko pracownik, który zarządza każdym sklepem z tego kontekstu. Jedna licencja obejmuje wszystkie sklepy instalacji.

6. Odinstalowanie

Menedżer modułów → Kupon urodzinowy → Odinstaluj usuwa ustawienia modułu i jego listę wydanych kodów. Same kody zostają w Katalog → Rabaty i działają do końca ważności. Pole daty urodzenia w PrestaShop zostaje bez zmian. Żeby zachować ustawienia, użyj Wyłącz. Usuń też zadanie cron z serwera.

7. Najczęstsze pytania i problemy

Dziś nie wyszedł żaden kod. Sprawdź w panelu Daty urodzenia i codzienne wysyłanie, czy pole daty urodzenia jest włączone, czy klienci mają datę urodzenia i kiedy ostatnio zakończyło się wysyłanie. Klient musi mieć konto, być aktywny i spełniać opcje (newsletter, wcześniejsze zamówienia). Bez crona wysyłanie startuje przy pierwszej wizycie dnia; przycisk Wyślij dzisiejsze kody teraz uruchamia je od razu.

Klient nie dostał e-maila. Sprawdź ustawienia poczty w Zaawansowane → Adres e-mail (wyślij tam e-mail testowy). Panel Wydane kody pokazuje, czy e-mail został wysłany. Kod jest też w zakładce Kupony na koncie klienta.

Jak ustawić zadanie cron? W panelu hostingu dodaj zadanie, które raz dziennie wywołuje adres z panelu modułu, np. curl -fsS "https://twoj-sklep.pl/module/ap_birthdaycoupon/cron?token=…" o 8:00. Potem możesz wyłączyć Uruchamiaj przy pierwszej wizycie dnia.

Koszyk odrzuca kod. Klient musi być zalogowany na konto, do którego należy kod, koszyk musi osiągnąć minimalną wartość, a kod nie może być przeterminowany ani wykorzystany. Przy opcji Bez produktów już przecenionych koszyk z samymi przecenionymi produktami nie dostanie rabatu; bez opcji Można łączyć z innymi kuponami najpierw usuń inny kupon.

Czy ktoś może zakładać kolejne konta, żeby zbierać kody? Każde konto dostaje najwyżej jeden kod w roku, ale nowe konto z urodzinami jutro też go dostanie. Jeśli to ryzyko dla Twojego sklepu, włącz Tylko klienci, którzy już zamawiali.

Czy mogę zmienić e-mail? Skopiuj z modułu mails/<język>/ap_birthdaycoupon.html i .txt do themes/<twój-motyw>/modules/ap_birthdaycoupon/mails/<język>/ i zmień kopie.

W polskim albo francuskim sklepie zostaje angielski tekst. Uzupełnij nazwę kuponu w tym języku w konfiguracji modułu. Pozostałe teksty przetłumaczysz w Międzynarodowy → Tłumaczenia → Tłumaczenia zainstalowanych modułów.

8. Aktualizacje i wsparcie

Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz tak samo jak nowy moduł. Ustawienia zostają zachowane.

Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy na addonspresta.com (od poniedziałku do piątku, 10:00–16:00; odpowiadamy zwykle w ciągu 2 dni roboczych). Podaj wersję PrestaShop, wersję modułu i kroki, które prowadzą do problemu.

Wróć do: Instrukcje modułów