1. Co robi moduł
Program poleceń zamienia klientów Twojego sklepu PrestaShop w jego ambasadorów. Każdy klient dostaje w Moim koncie osobisty link polecający. Znajomy, który otworzy link i założy konto albo złoży zamówienie jako gość, na stałe zostaje jego poleconym, a każde zamówienie tego znajomego daje klientowi punkty: prowizję, którą ustalasz jako procent wartości zamówienia. Punkty stają się dostępne, gdy zamówienie otrzyma wybrany przez Ciebie status i minie okres na zwrot, a klient w dowolnej chwili wymienia je na osobisty kod rabatowy.
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
- Pobierz plik
ap_referral_v1.0.0.zipz Moje konto → Historia zamówień w addonspresta.com. - W panelu administracyjnym otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik zip i poczekaj na potwierdzenie.
- Kliknij Konfiguruj, sprawdź prowizję, kurs, statusy zamówień i opis programu, a następnie zapisz.
Zaraz po instalacji program działa z prowizją 5%, kursem 10 punktów za 1 jednostkę waluty domyślnej, przyznawaniem punktów przy statusie Dostarczone i okresem oczekiwania 30 dni.
3. Jak to działa
Link. W Moje konto → Program poleceń klient znajduje link, na przykład https://twojsklep.pl/?ref=K7P2QX9M,
z przyciskiem Kopiuj. Działa każda strona sklepu z jego kodem. Na karcie produktu przycisk Kopiuj mój link
polecający kopiuje link do tego produktu z kodem klienta; samego linku tam nie widać.
Polecony znajomy. Gdy odwiedzający otworzy link, moduł zapamiętuje kod we własnym ciasteczku przez ustawioną liczbę
dni (domyślnie 30); późniejszy link innego klienta go zastępuje. Gdy odwiedzający założy potem konto albo złoży
zamówienie jako gość, zostaje poleconym właściciela linku. Dzieje się to tylko raz i tylko dla nowych klientów: nie może
istnieć wcześniejsze zamówienie z tym samym adresem e-mail i nikt nie może polecić samego siebie,
także inną postacią własnego adresu (imie+sklep@…, kropki w adresie Gmail). W multistore znajomy musi się zarejestrować
w sklepie, który współdzieli klientów ze sklepem polecającego.
Punkty z zamówienia. Każde zamówienie poleconego trafia do polecającego jako oczekujące z liczbą punktów
wartość zamówienia × prowizja × kurs, zaokrągloną w dół. Wartość obejmuje podatek i dostawę, po rabatach; zamówienie
w innej walucie jest przeliczane na walutę domyślną. Przykład: prowizja 5%, kurs 10 — zamówienie za 200 daje 10 prowizji,
czyli 100 punktów o wartości 10 rabatu.
Zatwierdzenie. Gdy zamówienie otrzyma jeden ze statusów przyznających punkty (domyślnie Dostarczone), punkty zostają zatwierdzone i przeliczone według aktualnego stanu zamówienia. Stają się dostępne po okresie oczekiwania liczonym od daty zamówienia. Status anulujący punkty (domyślnie Anulowane, Zwróconych pieniędzy, Błąd płatności) anuluje je, dopóki czekają; po okresie oczekiwania zatwierdzone punkty są ostateczne, więc saldo nigdy nie spada poniżej zera. Nie trzeba żadnego zadania cron: saldo jest liczone przy każdym wyświetleniu.
Kod rabatowy. Gdy klient ma co najmniej minimalną liczbę dostępnych punktów, klika Wygeneruj mój kod
rabatowy; wcześniej strona pokazuje wartość kodu i datę końca ważności. Wszystkie dostępne punkty zamieniają się w jeden kod o wartości punkty ÷ kurs w walucie
domyślnej, z podatkiem, ważny przez ustawioną liczbę dni. Kod działa tylko dla tego klienta, jeden raz, w Twoim sklepie; jeśli zamówienie jest mniejsze od
kodu, PrestaShop wydaje resztę jako nowy kod. Kod widać na stronie programu i jest proponowany w koszyku.
Moduł nie łączy się z addonspresta.com ani z żadnym innym serwerem. Polecający nie widzi nazwisk ani zamówień znajomych, tylko daty i punkty.
4. Funkcje i ustawienia
Ustawienia (Moduły → Menedżer modułów → Konfiguruj)
Strona zaczyna się od pola Pomoc: ta instrukcja, strona modułu, kontakt i wersja.
Program poleceń
- Włącz program poleceń — po wyłączeniu klienci nie widzą programu, a nowe zamówienia nie dają punktów; polecenia i punkty zostają.
- Opis programu — w każdym języku, z edytorem tekstu; wyświetla się na górze strony programu. Przy instalacji wpisuje się tekst startowy; opisz w nim własne zasady.
- Pamiętaj link polecający przez — od 1 do 365 dni.
Punkty
- Prowizja — procent wartości zamówienia, od 0,01 do 100.
- Punkty za 1 jednostkę waluty domyślnej — od 1 do 10 000. Ten sam kurs zamienia prowizję na punkty i punkty na rabat.
- Statusy przyznające punkty — co najmniej jeden.
- Statusy anulujące punkty — ten sam status nie może jednocześnie przyznawać i anulować.
- Okres oczekiwania — od 0 do 365 dni od daty zamówienia (domyślnie 30). Musi obejmować czas dostawy i okres na zwrot (w UE 14 dni od dostawy): poniżej 30 dni pojawia się ostrzeżenie.
- Naliczaj zamówienia poleconego przez — miesiące od polecenia, 0 bez limitu.
Kody rabatowe i wyświetlanie
- Minimum punktów na kod rabatowy — 0 pozwala wymienić każde dodatnie saldo.
- Ważność kodu rabatowego — od 1 do 3650 dni od wygenerowania kodu (domyślnie 365); klient jej nie wybiera.
- Pokazuj punkty na karcie produktu — „Poleć ten produkt: … otrzymasz około N pkt”.
- Pokazuj przycisk linku polecającego na karcie produktu — przycisk Kopiuj mój link polecający dla zalogowanych klientów; sam link nie jest wyświetlany. Niezalogowani odwiedzający widzą link do programu.
- Pokazuj punkty w koszyku — ile punktów dałoby zamówienie takie jak ten koszyk; liczba zmienia się razem z ilością produktów.
Strona programu poleceń
Klient widzi swój link, liczbę poleconych znajomych, dostępne i oczekujące punkty z ich wartością, formularz odbioru kodu rabatowego, swoje kody (wykorzystane, wygasłe lub aktywne) oraz zamówienia znajomych ze statusem punktów.
Strona klienta
Klienci → Klienci → Zobacz pokazuje kartę Program poleceń: kod klienta, kto go polecił, kogo on polecił (z linkami do ich stron) oraz dostępne, oczekujące i wymienione punkty w każdym sklepie. Pracownicy widzą ją u klientów sklepów, którymi zarządzają, z uprawnieniem Wyświetl do modułu (Zaawansowane → Zespół → Uprawnienia).
5. Multistore
Ustawienia zapisują się dla każdego sklepu osobno: przed zapisaniem wybierz sklep w nagłówku panelu. Każdy sklep może mieć własną prowizję, statusy, teksty i limity albo mieć program wyłączony. Punkty należą do sklepu, w którym znajomy złożył zamówienie, strona programu pokazuje saldo bieżącego sklepu, a kody rabatowe działają tylko w tym sklepie. Klient ma jeden kod polecający i jednego polecającego we wszystkich sklepach; znajomego można polecić tylko w sklepie, który współdzieli klientów ze sklepem polecającego. Karta na stronie klienta pokazuje tylko klientów sklepów, którymi zarządzasz. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Menedżer modułów → Program poleceń → Odinstaluj usuwa polecenia, punkty i ustawienia. Wydane już kody rabatowe pozostają ważne w Katalog → Rabaty. Aby wstrzymać program bez utraty danych, wyłącz Włącz program poleceń albo użyj opcji Wyłącz.
7. Najczęstsze pytania i problemy
Znajomy zarejestrował się z linku, ale nie jest poleconym. Musi otworzyć link przed założeniem konta, w tej samej przeglądarce i w ustawionej liczbie dni. Adres, z którego już zamawiano w sklepie, albo adres samego polecającego nie jest nowym klientem.
Punkty cały czas czekają. Czekają na jeden ze statusów przyznających punkty, a potem na koniec okresu oczekiwania. Strona programu pokazuje datę, od której będą dostępne.
Zamówienie zostało zwrócone, gdy punkty były już dostępne. Po okresie oczekiwania punkty są ostateczne. Ustaw okres oczekiwania dłuższy niż czas dostawy i okres na zwrot razem. Zwrot z fakturą korygującą przed końcem okresu oczekiwania zmniejsza punkty zamówienia. Zwrot wyłącznie w postaci bonu, bez faktury korygującej, ich nie zmienia.
Czy klient może polecić swoje drugie konto? Zamówienia wysłane lub zafakturowane na jeden z adresów polecającego albo z jego numerem telefonu nie dają punktów, a inna postać tego samego adresu e-mail nie jest przyjmowana. Z innym e-mailem, adresem i telefonem nadal jest to możliwe; strona klienta pokazuje, kto kogo polecił, więc łatwo to zauważyć.
Czy muszę informować o ciasteczku? Tak: moduł zapisuje własne ciasteczko po wejściu z linku polecającego. Dopisz je do polityki cookies.
W Moim koncie nie ma linku Program poleceń. Sprawdź, czy program jest włączony w tym sklepie i czy motyw wyświetla hook displayCustomerAccount.
8. Aktualizacje i wsparcie
Aktualizacje są bezpłatne dożywotnio: pobieraj nowe wersje z Moje konto → Historia zamówień w addonspresta.com i wgrywaj je jak nowy moduł. Ustawienia, polecenia i punkty zostają zachowane.
Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo skorzystaj z formularza kontaktowego w 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.
Kod modułu przechodzi nasz audyt bezpieczeństwa wspomagany przez AI.