System rabatów lojalnościowych: konfiguracja i pomoc
Szybki start
- Zainstaluj ZIP w sekcji Moduły > "Module Manager", kliknij "Configure" i wybierz jeden sklep.
- Na stronie Poziomy otwórz Ustawienia i sprawdź ustawienie Źródło rabatu, uwzględniane zamówienia, ustawienie Okres oceny oraz reguły zmiany poziomu.
- Dodaj poziomy, uzupełniając pola Nazwa poziomu, Kolor, Ikona i Aktywny, a następnie ustaw je od najniższej do najwyższej rangi.
- Dodaj elementy w sekcjach Reguły kwalifikacji i Korzyści, w tym kwotę, zasadę łączenia z promocjami i wybór produktów dla każdego elementu Rabat.
- Użyj funkcji Podgląd ceny i Przebuduj ceny; poczekaj na komunikat Ceny gotowe.
- Otwórz stronę Klienci i uruchom funkcję Rozpocznij przeliczanie bez powiadomień, kontynuując do zakończenia.
- Zaplanuj wywoływanie URL z Ustawienia > Konfiguracja > Zadania cykliczne co minutę, chyba że harmonogramem zarządza pakiet modułów.
- Zaloguj się jako klient testowy i sprawdź poziom, postęp w koncie, ceny produktów, koszyk i ewentualne korzyści dotyczące dostawy.
Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.
Instrukcja konfiguracji
Instalacja i wybór sklepu
Prześlij ZIP w sekcji Moduły > "Module Manager" > "Upload a module". Zainstaluj moduł i kliknij "Configure", aby otworzyć stronę Konfiguracja poziomów.
Otwórz menu Rabaty lojalnościowe, aby przejść do stron Poziomy, Klienci, Panel i Ustawienia > Konfiguracja. Przed edycją wybierz jeden sklep. Strona poziomów wymaga od pracownika uprawnień do przeglądania, aby odczytać dane, do edycji, aby wprowadzać zmiany, i do usuwania, aby usuwać wpisy. Odśwież stronę, jeśli jej token bezpieczeństwa wygaśnie.
Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.
Moduł wykorzystuje program lojalnościowy B2C dla każdego sklepu. Kwalifikację konfiguruje się za pomocą reguł. Nie uzupełniasz pojedynczego pola Minimalne wydatki ani nie łączysz ręcznie każdego poziomu z istniejącą grupą klientów.
Konfiguracja ustawień programu
Na stronie Poziomy kliknij Ustawienia. To okno zawiera ustawienia kwalifikacji, cen, powiadomień i dostawy. Oddzielna strona Ustawienia > Konfiguracja zawiera integracje i URL konserwacji.
Wybór źródła rabatu
Źródło rabatu ma domyślnie wartość Korzyści poziomu z modułu. Ta opcja wykorzystuje korzyści rabatowe z ustawieniami kwoty, podatku, zasady łączenia z promocjami i wyboru produktów.
Wybierz Rabat grupy PrestaShop, jeśli potrzebujesz natywnego działania rabatów grupowych. Tryb grupowy wykorzystuje pierwszy aktywny rabat, jeśli jest procentowy; powiązane grupy zachowują własny rabat. Moduł tworzy grupy poziomów lub zarządza nimi zależnie od potrzeb. Nie zakładaj, że wyświetlany procent ma wyłącznie charakter informacyjny.
Po sprawdzeniu zmian użyj funkcji Przebuduj ceny i poczekaj na komunikat Ceny gotowe. Zależnie od wersji PrestaShop mechanizm cen modułu korzysta z natywnych hooków cenowych lub skompilowanych cen specyficznych. Przed wykorzystaniem wyniku sprawdź zgłoszone ustalenia dotyczące zgodności i ewentualny raport Ceny pierwotnych grup klientów.
Określenie, co zalicza się do obrotu
| Ustawienie | Wartość domyślna | Jak skonfigurować |
|---|---|---|
| Uwzględniane statusy zamówień | Puste | Pusta wartość uwzględnia każde prawidłowe zamówienie. Wybierz statusy, aby ograniczyć uwzględnianą historię. |
| Odejmuj zwroty | Tak | Odejmuje zwrócone kwoty od obrotu. Wyłącz tylko wtedy, gdy program celowo uwzględnia wydatki, które zwrócono. |
| Uwzględniaj podatek | Tak | Uwzględnia wydatki z podatkiem. |
| Uwzględniaj dostawę | Nie | Po włączeniu dodaje koszty dostawy do podstawy wydatków. |
Zapisane wskaźniki używają domyślnej waluty sklepu. Nie porównuj progu z nieprzeliczoną sumą w innej walucie.
Wybór okresu oceny
| Ustawienie | Wartość domyślna | Jak skonfigurować |
|---|---|---|
| Okres oceny | Od początku | Wybierz Od początku, Ostatnie dni, Ostatnie miesiące lub Rok kalendarzowy. |
| Liczba dni ruchomego okresu | 365 | Używane dla opcji Ostatnie dni. |
| Liczba miesięcy ruchomego okresu | 12 | Używane dla opcji Ostatnie miesiące. |
| Minimalna liczba miesięcy do obliczania średnich | 3 | Minimalny dzielnik przy obliczaniu średniego miesięcznego obrotu i liczby zamówień. |
Użyj okresu zgodnego z zasadami kwalifikacji. Okres ruchomy może spowodować spadek poziomu klienta, gdy starsze zamówienia przestaną się w nim mieścić.
Kontrola zmian poziomu
| Ustawienie | Wartość domyślna | Jak skonfigurować |
|---|---|---|
| Częstotliwość oceny | Przy zamówieniu | Wybierz Przy zamówieniu, Codziennie lub Co tydzień. Zaplanowane zadania wymagają wywołań konserwacji. |
| Natychmiastowy awans | Tak | Pozwala zamówieniu natychmiast uruchomić awans na wyższy poziom. |
| Poziom początkowy | Brak poziomu początkowego | Wybierz poziom zastępczy, gdy żadna reguła kwalifikacji nie jest spełniona. |
| Miesiące ochrony | 0 | Zachowuje nowo zdobyty poziom przez skonfigurowany okres. Zero oznacza brak ochrony. |
| Dni okresu karencji | 0 | Daje czas na ponowną kwalifikację przed obniżeniem poziomu. Zero oznacza brak dodatkowego czasu. |
| Automatyczne obniżenie poziomu | Tak | Pozwala przejść na niższy poziom po utracie kwalifikacji. |
Kolejność poziomów określa rangę. Późniejszy poziom z uporządkowanej listy, którego warunki są spełnione, jest wyższym kandydatem. Ustaw poziomy od najniższego do najwyższego.
Konfiguracja powiadomień i wyświetlania
| Ustawienie | Wartość domyślna | Jak skonfigurować |
|---|---|---|
| Powiadom o awansie | Tak | Wysyła powiadomienie o zmianie poziomu dla kwalifikujących się zdarzeń, które nie są ciche. |
| Powiadom o obniżeniu poziomu | Nie | Włącz, jeśli klienci mają otrzymywać powiadomienia o obniżeniu poziomu. |
| Powiadom przed obniżeniem poziomu | Nie | Włącza ostrzeżenia przed końcem okresu karencji. |
| Dni wyprzedzenia ostrzeżenia | 7 | Wyprzedzenie ostrzeżenia, gdy ostrzeżenia są włączone. |
| Pokaż postępy | Tak | Wyświetla informacje lojalnościowe w koncie zalogowanego klienta. |
Konfiguracja dostawy
Pole "Carriers priced by loyalty" jest początkowo puste. Wybierz odpowiednich natywnych przewoźników, jeśli korzystasz z korzyści darmowej lub tańszej dostawy. W wersjach korzystających z tej integracji moduł staje się modułem wyceny dla przejętych przewoźników. Nie można przejąć przewoźników obsługiwanych już przez inny moduł przewoźnika. Zwolnienie przewoźnika przywraca jego zapisane pierwotne ustawienia.
Po zapisaniu przeczytaj wynik przejęcia. Niektóre wersje rdzenia udostępniają hook dostawy bezpośrednio; interfejs dostosowuje się do tej możliwości. Nie zakładaj, że korzyść dotycząca dostawy dotyczy niewybranego lub nieobsługiwanego przewoźnika.
Tworzenie poziomów i reguł kwalifikacji
Kliknij Dodaj poziom. Wprowadź wielojęzyczną wartość pola Nazwa poziomu. Nazwa w domyślnym języku sklepu jest wymagana. Pole Kolor ma domyślnie wartość #6c757d, pole Ikona jest początkowo puste, a opcja Aktywny jest początkowo włączona. Zapisz poziom, a następnie ustaw go w odpowiednim miejscu hierarchii.
W sekcji Reguły kwalifikacji kliknij Dodaj regułę. Ustaw pola Typ reguły, Operator i Wartość. Reguły w obrębie jednego elementu Grupa reguł używają AND. Przycisk Dodaj grupę LUB tworzy kolejną alternatywną grupę.
Typy reguł B2C obejmują Łączny obrót, Średni miesięczny obrót, Łączna liczba zamówień, Średnia wartość zamówienia, Częstotliwość zamówień, Wiek konta, Wskaźnik zwrotów, Opóźnione płatności, Kolejne miesiące z zamówieniami, Dni od ostatniego zamówienia, Zakupione kategorie i Zakupione produkty. Niektóre dane zależą od dostępnych informacji lub integracji. Nie wolno zakładać, że niedostępny wskaźnik spełnia regułę.
Dla wskaźników pieniężnych używaj domyślnej waluty sklepu. Częstotliwość zamówień oznacza liczbę zamówień miesięcznie. Wiek konta i czas nieaktywności podaje się w dniach. Reguły list kategorii i produktów przyjmują dodatnie identyfikatory oddzielone przecinkami z operatorem Zawiera wszystkie.
Dla poziomu Gold opartego na wydatkach utwórz:
Tier Name: Gold
Qualification Rules:
Rule Type: Total turnover
Operator: At least
Value: 500
Zastępuje to dawne pole z pojedynczym progiem. Możesz zamiast tego kwalifikować według liczby zamówień lub połączyć kilka wymagań.
Konfiguracja korzyści poziomu
W sekcji Korzyści kliknij Dodaj korzyść. Wybierz wartość pola Typ korzyści i uzupełnij wymagane wartości. Pole Niestandardowa etykieta jest opcjonalne i wielojęzyczne. Korzyść nie istnieje, dopóki jej nie zapiszesz.
| Typ korzyści | Pola do skonfigurowania | Znaczenie w działaniu |
|---|---|---|
| Rabat | Rodzaj rabatu, Kwota, Sposób uwzględniania podatku, Waluta dla stałej kwoty, Zasada łączenia z promocjami, Wybór produktów | Stosuje rabat procentowy lub kwotowy przy użyciu wybranego źródła cen. |
| Darmowa dostawa | "Minimum shipment amount (0 = no minimum)", Sposób uwzględniania podatku, Waluta, Wybór produktów | Darmowa dostawa u obsługiwanych przewoźników, gdy fizyczna przesyłka spełnia warunki. |
| Tańsza dostawa | Procent, Wybór produktów | Obniża obsługiwane koszty dostawy. |
| Termin płatności | Dni | Publikuje skonfigurowaną korzyść; nie zakładaj, że tworzy to samodzielną bramkę płatniczą. |
| Limit kredytowy | Kwota, Współczynnik pokrycia (%), Dni na płatność | Zapisuje dane korzyści kredytowej dla integracji, które z nich korzystają. |
| Wydłużony termin zwrotu | Dni | Opisuje okres zwrotu dla poziomu. |
| Dedykowany opiekun | Opiekun | Przypisuje wybranego pracownika. |
| Wcześniejszy dostęp do wyprzedaży | Godziny | Zapisuje korzyść wcześniejszego dostępu. |
| Produkty ekskluzywne | Wybór produktów | Zapisuje odpowiedni zakres produktów. |
| Rabaty ilościowe | Procent, Okres | Zapisuje warunki rabatów okresowych: Miesięcznie, Kwartalnie lub Rocznie. |
| Darmowe próbki | Próbki miesięcznie | Zapisuje miesięczny limit. |
| Priorytetowa obsługa, Priorytetowa realizacja, Darmowe zwroty | Aktywna korzyść i opcjonalna etykieta | Rejestruje wskazane uprawnienie. |
Samodzielny moduł automatycznie stosuje naliczanie rabatów i obsługiwane obniżki kosztów dostawy. Pozostałe typy korzyści są zapisywane z poziomem, ale moduł ich nie realizuje: realizacja, zwroty, kontrola dostępu, wypłata rabatów okresowych i warunki płatności wymagają własnego procesu lub innej integracji. Przygotuj je, zanim obiecasz klientom takie korzyści.
Dla rabatów formularz nowej korzyści ma początkowo pole Rodzaj rabatu ustawione na Procent, pole Sposób uwzględniania podatku na Bez podatku i pole Zasada łączenia z promocjami na Zastosuj korzystniejszą cenę. Wprowadź kwotę wprost. Stałe kwoty wymagają waluty. Pozostałe zasady łączenia z promocjami to Tylko produkty bez promocji i Łącz z promocjami.
Wybór produktów oferuje Wszystkie produkty lub Wybrane produkty. Przed zapisaniem sprawdź selektor. W przypadku korzyści dotyczących dostawy każdy fizyczny produkt w przesyłce musi należeć do kwalifikującego się wyboru. Progi uwzględniają towary fizyczne po rabatach produktowych, a przed rabatami koszyka.
Dla przykładu Gold dodaj korzyść typu Rabat z opcją Procent i wartością 10 w polu Kwota. W trybie cen modułu jest to działająca definicja rabatu. Nie odtwarzaj jej osobno jako natywnego rabatu grupowego, chyba że świadomie wybrano to źródło.
Podgląd i publikacja cen
Użyj funkcji Podgląd ceny dla poziomu, aby przetestować produkt, kombinację i ilość. Podgląd referencyjny używa domyślnej waluty i kraju sklepu. Pokazuje ceny jednostkowe bez ekopodatku i opłat za personalizację produktu. Ilość wybiera odpowiedni próg cenowy.
Sprawdź natywną promocję, zwycięzcę według zasady, cenę końcową, skompilowany wiersz i ustalenia dotyczące zgodności. Zapisane definicje i skompilowane ceny mogą się różnić do zakończenia przebudowy. Użyj funkcji Przebuduj ceny i poczekaj na komunikat Ceny gotowe, zanim sprawdzisz sklep.
Użyj funkcji "Shipping preview" dla poziomu z korzyścią dotyczącą dostawy. Podaj produkty i ilości albo istniejący koszyk i jego ustawienia dostawy. Sprawdź przewoźnika, zawartość przesyłki, natywny koszt przewozu, oszczędność, koszt do zapłaty, próg i brakującą kwotę. Podgląd może być niedostępny, gdy wymagałby wywołania innego modułu przewoźnika.
Przeliczenie klientów i harmonogram konserwacji
Otwórz stronę Klienci. Użyj funkcji Rozpocznij przeliczanie bez powiadomień, aby ocenić istniejących klientów bez wysyłania początkowych wiadomości o zmianie poziomu. Używaj przycisku Kontynuuj przeliczanie do zakończenia lub pozwól kontynuować zadaniu cron.
Do przetwarzania cen partiami użyj funkcji Rozpocznij uzgadnianie cen i Kontynuuj uzgadnianie cen. Sprawdź listę klientów i aktualną migawkę wybranego klienta. Lista obsługuje eksport i pokazuje zapisane informacje o ocenie. Panel szczegółów klienta zawiera bieżące informacje lojalnościowe i najnowszą historię.
Otwórz Ustawienia > Konfiguracja. W sekcji Zadania cykliczne skopiuj wygenerowany URL i wywołuj go co minutę. Zawiera identyfikator sklepu i prywatny token. Na przykład:
* * * * * curl -fsS "YOUR_EXACT_SCHEDULED_MAINTENANCE_URL" >/dev/null
Użyj faktycznie skopiowanego URL. Kontroler wymaga, aby jego id_shop odpowiadał sklepowi żądania, oraz prawidłowego tokena o długości 64 znaków. Konserwacja kontynuuje zaplanowane oceny, partie przeliczania, uzgadnianie cen i ponowienia powiadomień. Jeśli pakiet modułów jest aktywny, jego harmonogram zarządza tymi zadaniami, a samodzielny mechanizm uruchamiający może pominąć wykonanie.
Ta sama strona oferuje Włącz edrone i Identyfikator aplikacji edrone. Integracja jest wyłączona do momentu włączenia i wymaga niepustego identyfikatora aplikacji. Nie włączaj jej bez identyfikatora właściwego konta.
Sprawdzenie widoku klienta i powiadomień
Po przeliczeniu zaloguj się jako klient testowy. Otwórz stronę konta i porównaj bieżący poziom, podstawę kwalifikacji, następny poziom, niespełnione wymagania i korzyści z migawką w Back Office. Goście nie mają osobistego statusu lojalnościowego.
Sprawdź ceny na liście, na stronie produktu, w koszyku i w zakończonym zamówieniu testowym. Sprawdź zamówienie z promocją i zamówienie ze zwrotem w odniesieniu do uwzględnianych statusów i ustawień zwrotów. Obecny mechanizm ocenia historię zamówień i reguły przejścia; nie dodaje po prostu kwoty każdego zatwierdzonego zamówienia bez końca.
Szablon konta można dostosować pod adresem:
/themes/your-theme/modules/mprloyaltydiscountssystem/views/templates/hook/customer_account.tpl
Korzysta z aktualnego szablonu migawki lojalnościowej. Nadaj styl kontenerowi konta przez .mpr-loyalty-account, liście wskaźników przez .mpr-loyalty-details, a niespełnionym wymaganiom przez .mpr-loyalty-requirements. Starszy kod znacznika poziomu i procentowego paska postępu nie jest obecnym interfejsem szablonu.
Wysyłka e-maili dotyczących poziomów używa mails/en/loyalty_upgrade.html i loyalty_downgrade.html, z obsługą polskiego i angielskim językiem zastępczym dla innych języków w mechanizmie wysyłki. Obecne zmienne obejmują {firstname}, {lastname}, {notification}, {tier_name}, {base_tier_name}, {tier_benefits}, {total_turnover}, {window}, {basis}, {next_tier_name}, {shortfalls}, {account_url} i {shop_name}. Dawny przykład {tier_discount} nie jest aktualnym tokenem mechanizmu wysyłki.
Rozwiązywanie problemów i odinstalowanie
Jeśli nie można zapisać zmian, wybierz jeden sklep i sprawdź uprawnienia pracownika oraz ważność tokena. Jeśli klienci nie mają poziomu, sprawdź aktywne reguły, logikę grup, uwzględniane statusy, dostępne wskaźniki i okres oceny.
Jeśli ceny różnią się od definicji, sprawdź stan przebudowy i ustalenia dotyczące zgodności. Jeśli dostawa się nie zmienia, sprawdź przejęcie przewoźnika i kwalifikującą się zawartość przesyłki. Jeśli brakuje postępu, sprawdź opcję Pokaż postępy, stan zalogowania, hook konta i to, który moduł obecnie zarządza wykonywaniem programu lojalnościowego.
Użyj strony Ustawienia > Integralność do sprawdzenia infrastruktury modułu. Sprawdź JSON konserwacji i diagnostykę modułu pod kątem nieudanych partii lub dostarczania poczty. Nie powtarzaj udanego zapisu definicji tylko dlatego, że późniejsza przebudowa się nie powiodła; użyj funkcji Przebuduj ceny, aby ponowić próbę.
Aby zatrzymać moduł, wyłącz go lub odinstaluj przez "Module Manager". Czyszczenie podczas działania zwalnia należące do modułu wiersze cen i przypisania grup oraz odpowiednio przekazuje lub zwalnia przejętych przewoźników. Wspólne tabele lojalnościowe są zadeklarowane jako trwałe i pozostają zachowane. Podczas odinstalowania usuwane są samodzielne pozycje menu, konfiguracja modułu i preferencje administracyjne. Zachowaj kopię bazy danych, jeśli potrzebujesz pełnego eksportu historii.
Pytania
2
Czy Loyalty Discounts System spowolni mój sklep?
Czy w instalacji wielosklepowej wydatki lojalnościowe są liczone osobno dla każdego sklepu, czy łącznie?
Nie. Programy lojalnościowe i stan klienta są przypisane do sklepu, a zapytanie o historię zamówień uwzględnia tylko zamówienia z tego sklepu. Przelicz i sprawdź klienta osobno w każdym właściwym sklepie.
Znane problemy
14
Wzmocnienie zabezpieczeń
Przeliczanie mogło usuwać status klienta
Nieopłacone zamówienia mogły przyznawać poziom lojalnościowy
Bony i zwroty zniekształcały kwalifikowane wydatki
Ceny poziomów mogły być błędne, a rabaty nieaktywne
Przebudowa cen mogła zmieniać promocje sprzedawcy
Etykiety menu lojalnościowego były nieczytelne
Uprawnieni klienci mogli nie otrzymać swojego poziomu
Komunikaty administracyjne pozostawały po angielsku
Pojawiały się nieprawidłowe tłumaczenia
Połączone zasoby mogły psuć wygląd sklepu
Wybrane statusy zamówień lojalnościowych nie były zachowywane
Po instalacji brakowało wymaganych danych lojalnościowych
Filtry list w panelu administracyjnym działały nieprawidłowo
Zgłoszenia funkcji
12
Zaimplementowane
Rabaty lojalnościowe według progów wydatków
Poziomy lojalnościowe według wydatków
Aktualizacje modułu z zaplecza
Kontrola instalacji
Dodatkowe języki panelu administracyjnego
Rozbudowane zarządzanie poziomami
Lojalnościowe korzyści dostawy
Zasady łączenia z promocjami
Okres obliczania wydatków
Ochrona zdobytego poziomu
Bogatsze e-maile lojalnościowe
Tagi poziomów w edrone
Dziennik zmian
v1.1.102026-09-22
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedPersist loyalty order state settings
- FixedInstall loyalty tables through schema manager
- FixedReplace Tools::displayPrice with PriceFormatter compat wrapper
Starsze wersje
v1.0.02026-05-11
- Initialrelease: automatic customer group assignment based on cumulative spending thresholds
- InitialConfigurable tiers: set spending threshold and target customer group per level
- InitialCompatible with PrestaShop native customer group discounts for seamless pricing rules
- InitialAdmin overview showing each customer's current tier, total spend, and next threshold
v1.3.02026-04-20
- Addedadmin menu management via MenuInstaller for streamlined module setup
- Addedself-healing integrity checks for automatic diagnostics and repair
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
- Improvedsettings form organization with tabbed layout
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.2.02026-02-19
- Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
- Addedspending tier preview on the My Account page showing progress to next discount level
- Improvedcumulative spend recalculation: background job processes all customers nightly via cron
- Fixedcustomer group not reverting when a qualifying order was refunded
- Addedconfigurable spending currency for multi-currency stores with exchange rate normalisation
v1.1.02025-10-07
- Addedthreshold editor with unlimited tiers, each with its own discount percentage or fixed amount
- Improvedaudit log: records each group assignment change with trigger order reference
- Fixedtier upgrade not applying immediately when order status changed to 'Payment accepted'
- Addedemail notification template for customers promoted to a new loyalty tier
Demo
Przetestuj pełny moduł przed zakupem
Licencję kupisz później, a ustawienia zostaną.
- Twoje 30-dniowe demo Przetestuj go we własnym sklepie przez 30 dni od pierwszej instalacji.
- Gotowy sklep demo Poznaj gotowy sklep demo w przeglądarce.
- Bez rejestracji Bez konta, adresu e-mail ani domeny sklepu.
Pobierając, akceptujesz warunki dema i politykę prywatności.
Otwierając to demo, akceptujesz regulamin wersji demo oraz politykę prywatności.