Opinie i Nagrody Pro – zaproszenia do opinii po zakupie i kupony za opinie w PrestaShop

Do czego służy moduł

• Więcej opinii o produktach. Zaproszenie trafia do klienta po ustawionym czasie od opłacenia lub realizacji zamówienia i obejmuje tylko te produkty z zamówienia, których klient jeszcze nie ocenił.
• Powód do kolejnego zakupu. Nagrodą za opinię jest kupon na następne zamówienie – z terminem ważności, minimalną wartością koszyka i przypomnieniem przed jego końcem.
• Przejrzyste opinie z programu nagród. Opinie powstałe w programie są oznaczone w treści, a ocena nie ma wpływu na nagrodę, więc klient może wystawić zarówno pozytywną, jak i negatywną ocenę.
• Kontrola i wyniki w jednym miejscu. Lista zebranych opinii ze stanem moderacji i kuponem oraz pulpit statystyk pokazujący drogę od zaproszenia do zamówienia z kuponem.

Najważniejsze ustawienia domyślne nowej kampanii

• Zaproszenie 14 dni po wejściu zamówienia w jeden z zaznaczonych statusów (domyślnie: płatność zaakceptowana, płatność zdalna zaakceptowana, przygotowanie w toku, wysłane, dostarczone).
• Jedno przypomnienie po 7 dniach i link ważny 30 dni.
• Nagroda: rabat 10% w trybie „jeden kupon za zamówienie”, wydawany po moderacji, ważny 30 dni, z przypomnieniem 3 dni przed końcem ważności.
• Limity: 1 nagroda na klienta i 100 nagród na kampanię.
• Wszystkie terminy można zmienić w zakresie do 365 dni, a limity – do 10 000 nagród na klienta i 1 000 000 na kampanię.

Kampanie zaproszeń do opinii

Które zamówienia i produkty obejmuje kampania

• Produkty i kategorie. Produkty wybiera się wyszukiwarką (nazwa lub ID), kategorie z listy; produkt kwalifikuje się, gdy jest na liście produktów albo należy do wybranej kategorii. Pusta lista oznacza cały katalog.
• Wykluczenia produktów mają pierwszeństwo przed listą produktów i kategorii.
• Statusy zamówienia. Zaproszenie dostaje zamówienie ważne, którego bieżący status jest zaznaczony w kampanii w dniu upływu opóźnienia. Opóźnienie liczy się od ostatniego wejścia zamówienia w zaznaczony status.
• Okres obowiązywania kampanii (od–do), jej aktywność i priorytet.
• Priorytet kampanii. Gdy kampanie się nakładają, zamówienie przypada pierwszej pasującej kampanii z wolnymi limitami według priorytetu – także wtedy, gdy jej opóźnienie jeszcze trwa.
• Produkty już ocenione są pomijane. Zaproszenie nie obejmuje produktów, które klient ocenił wcześniej w module opinii, ani produktów, za które otrzymał już nagrodę.
• Goście bez zgody na wiadomości nie dostają zaproszeń i nie zajmują miejsca w limitach, ponieważ nie mają konta, w którym mogliby je zobaczyć.

Treść wiadomości

• Nazwa nagrody i treść wiadomości osobno dla każdego języka sklepu (do 150 i do 3000 znaków, zwykły tekst bez HTML).
• Warunki nagrody (wartość, minimalny koszyk, ważność, łączenie z innymi kuponami) są dołączane do wiadomości i strony opinii automatycznie, w języku klienta.

Kupony za opinie

Rodzaje nagród

• Rabat procentowy – na cały koszyk albo na listę wybranych produktów.
• Rabat kwotowy w wybranej walucie – na cały koszyk albo na jeden wybrany produkt.
• Darmowa dostawa – jako samodzielna nagroda albo jako dodatek do innej nagrody.
• Produkt w prezencie, także w wybranej kombinacji. Prezent musi być aktywny, dostępny do zamówienia i dostępny w magazynie (albo z dozwolonym zamawianiem przy braku); inaczej wydanie kuponu jest ponawiane.
• Minimalna wartość koszyka (brutto, bez dostawy) i ważność kuponu w dniach.

Za co i kiedy klient dostaje kupon

• Tryb zamówienia: jeden kupon za pierwszą kwalifikującą się opinię z zamówienia.
• Tryb produktu: osobny kupon za opinię o każdym produkcie objętym kampanią; kilka sztuk tego samego produktu nie zwielokrotnia nagrody.
• Po moderacji albo po przesłaniu. Domyślnie kupon powstaje dopiero po zatwierdzeniu opinii w module opinii; można też wydawać go od razu po przesłaniu opinii.
• Ocena gwiazdkowa nie wpływa na nagrodę.
• Jedna nagroda za produkt i kupującego w sklepie – także między kampaniami i kolejnymi zamówieniami. Kupującego rozpoznaje się po skrócie HMAC adresu e-mail.
• Obietnica bez zmian. Warunki nagrody i miejsce w limicie są rezerwowane w chwili utworzenia zaproszenia; późniejsza edycja kampanii nie zmienia złożonej klientowi obietnicy.

Kupon jako reguła koszyka PrestaShop

• Natywna reguła koszyka z kodem, przypisana do klienta, jednorazowa i bez częściowego wykorzystania.
• Łączenie z innymi kuponami ustawia się w kampanii; domyślnie kupon za opinię nie łączy się z innymi. W PrestaShop 9 zakaz sprawdza walidacja koszyka, a w PrestaShop 1.7 i 8 moduł utrzymuje natywne relacje między regułami koszyka (do 100 reguł i 2000 par). Gdy aktywnych kuponów sklepu jest więcej, kupon za opinię nadal zostaje wydany, a panel ostrzega, że zakaz łączenia nie jest wtedy egzekwowany.
• Ponawianie wydania. Nieudane wydanie kuponu (np. brak prezentu w magazynie) jest ponawiane z rosnącym odstępem – od 1 godziny do doby, najwyżej 10 razy; później przycisk „Ponów” na liście nagród.
• Zwrot i anulowanie. Pełny zwrot danego produktu albo anulowanie zamówienia blokuje niewykorzystany kupon. Jeśli kupon wykorzystano wcześniej, lista nagród pokazuje stan „Kupon wykorzystano przed zwrotem”. Zwykła zmiana statusu na kolejny etap realizacji nie cofa nagrody.

Opinie i moderacja

• Współpraca z IQIT Reviews albo Product Comments. W każdym sklepie wybiera się jeden z tych modułów; opinia zostaje zapisana w nim, a moduł opinii ją publikuje i moderuje. Zmiana modułu opinii jest blokowana, dopóki są niezakończone zaproszenia lub nagrody.
• Formularz opinii: ocena od 1 do 5 gwiazdek, tytuł (od 3 do 64 znaków) i treść (od 20 do 5000 znaków); przy Product Comments także oceny kryteriów zdefiniowanych w tym module. Opinia jest publikowana z imieniem klienta.
• Oznaczenie opinii. Do treści każdej opinii dodanej przez moduł dopisywany jest tekst: „Opinia po potwierdzonym zakupie, dodana w ramach programu nagród. Nagroda nie zależy od oceny.” Oznaczenie jest częścią treści opinii, więc nie zależy od motywu sklepu ani JavaScript.
• Decyzja moderatora wykrywana automatycznie. Każde uruchomienie CRON sprawdza, które opinie zostały zatwierdzone lub usunięte, i wydaje albo anuluje nagrodę. Opinia, której nikt nie zatwierdzi do 60 dni po terminie zaproszenia, zwalnia rezerwację nagrody.
• Zakładka „Opinie” w panelu: ocena, tytuł i treść, produkt z linkiem do edycji i do karty w sklepie, klient i zamówienie, stan moderacji (opublikowana, czeka na moderację, usunięta, system opinii niedostępny), przycisk „Moderuj” prowadzący do opinii w module opinii oraz kupon za opinię.
• Eksport opinii do CSV z bieżącymi filtrami i sortowaniem – do 50 000 opinii w jednym pliku; wymaga uprawnienia do konfiguracji modułu, ponieważ plik zawiera adresy e-mail klientów.

Strony i wiadomości dla klienta

Wiadomości e-mail

• Cztery rodzaje wiadomości: zaproszenie do opinii, jedno przypomnienie, wiadomość z kuponem i jedno przypomnienie przed końcem ważności kuponu. Szablony HTML i tekstowe po polsku i angielsku.
• Wysyłka przez konfigurację poczty PrestaShop, z limitem wiadomości na jedno uruchomienie CRON (od 1 do 50, domyślnie 20). Nieudana wysyłka jest ponawiana z rosnącym odstępem, najwyżej 5 razy; administrator może ją ponowić z listy.
• Język wiadomości to język klienta, gdy moduł ma dla niego szablon; w pozostałych przypadkach angielski albo polski według języków aktywnych w sklepie.
• Rezygnacja jednym kliknięciem. Każda wiadomość ma link rezygnacji z zaproszeń i przypomnień; rezygnacja działa także po zmianie adresu e-mail. Wiadomość z kuponem, który już przysługuje klientowi, pozostaje wiadomością transakcyjną.

Zgoda na wiadomości

• Źródło zgody do wyboru: zapis do newslettera albo zgoda na oferty partnerów (pole optin) w koncie klienta.
• Ustawienie „Brak” blokuje wiadomości promocyjne – zaproszenia są wtedy widoczne tylko w koncie klienta. Zgoda i dane klienta są sprawdzane ponownie tuż przed wysyłką.
• Program i wysyłka włączane osobno. Instalacja, aktualizacja ani ponowna instalacja nie uruchamiają wysyłki do klientów.

Strona opinii i konto klienta

• Opinia bez logowania. Link z wiadomości jest podpisany i przypisany do zaproszenia; przy pierwszym otwarciu klucz z adresu jest przenoszony do sesji i usuwany z adresu. Strony mają nagłówki noindex, no-store i no-referrer, a zapis opinii i rezygnacji wymaga tokenu formularza.
• Zakładka „Opinie i nagrody” w koncie klienta z listą zakupów objętych programem, stanem każdego produktu i przyciskiem „Zobacz produkty, opinie i kupony”, który otwiera stronę zaproszenia z formularzem opinii i przyznanymi kuponami. Kafelek działa w motywie classic, warehouse oraz Hummingbird 1 i 2.
• Zakup bez konta. Po zakupie gościnnym klient może jednym przyciskiem założyć konto na adres e-mail z zamówienia (hasło ustawia przez wiadomość PrestaShop wysłaną na ten adres) albo przypisać kupon do istniejącego konta z tym samym adresem.
• Kilka zaproszeń naraz. Sesja pamięta klucze pięciu ostatnio otwartych zaproszeń, więc klient może pracować w kilku kartach przeglądarki.

Pulpit statystyk

• Okres: 7, 30 lub 90 dni, 12 miesięcy, cały okres albo własny zakres dat.
• Liczniki zaproszeń, wysłanych wiadomości, opinii, odsetka odpowiedzi, wydanych kuponów i zamówień z kuponem – ze zmianą względem poprzedniego okresu tej samej długości.
• Wykres aktywności (wysłane zaproszenia, nowe opinie, zamówienia z kuponem) dziennie, tygodniowo lub miesięcznie, z tabelą danych.
• Lejek zaproszeń: utworzone → z opinią → nagrodzone kuponem → kupon użyty w zamówieniu.
• Średnia ocena z rozkładem gwiazdek, najczęściej oceniane produkty i tabela kampanii; gwiazdki i produkty prowadzą do przefiltrowanej listy opinii, a kampanie do ich edycji.
• Obrót i wartość rabatów zamówień z kuponem programu, osobno dla każdej waluty.

Panel administracyjny

• Menu Klienci → Opinie i nagrody oraz strona konfiguracji modułu z paskiem zakładek: kampanie, zaproszenia, opinie, nagrody, statystyki, wcześniejsze zakupy i ustawienia.
• Nagłówek ze stanem programu: przetwarzanie, wysyłka, moduł opinii, źródło zgody, aktywne kampanie, ostatnie uruchomienie CRON oraz osobno błędy zaproszeń i nagród – każda kontrolka prowadzi do miejsca, w którym można ją poprawić.
• Natywne listy PrestaShop z filtrem w każdej kolumnie, sortowaniem i stronicowaniem; filtry są zapamiętywane dla pracownika osobno dla każdej listy i sklepu, a nad listą widać, jakie filtry są aktywne.
• Wcześniejsze zakupy. Zamówienia sprzed instalacji można objąć programem: podgląd wybranego zakresu (do 1000 zamówień, ważny 30 minut) pokazuje liczbę kwalifikujących się zamówień, a zaproszenia powstają po uruchomieniu zadania.
• Uprawnienia PrestaShop. Pracownik z samym podglądem nie zmieni ustawień ani kampanii; token CRON i eksport opinii są dostępne tylko dla pracowników z uprawnieniem do konfiguracji modułu.

Zadanie CRON

• Uruchamianie co 5 minut. CRON kwalifikuje zamówienia, wysyła wiadomości, wydaje kupony i sprawdza zwroty oraz decyzje moderatora.
• Dwa sposoby wywołania: zwykły adres z tokenem (…/module/pdproductreviewspro/cron?pdpr_token=…) – do wklejenia w panelu hostingu, który wywołuje adres (np. ISPConfig, cPanel, usługi webcron) – albo gotowe polecenia curl i wget, które przesyłają token metodą POST, poza adresem.
• Osobny adres i token dla każdego sklepu. Równoczesne uruchomienia są blokowane, a przetwarzanie odbywa się porcjami w limicie czasu jednego wywołania.
• Zmiany zamówień obsługiwane od razu. Zmiana statusu, zwrot lub nowa opinia kierują zaproszenie do sprawdzenia w najbliższym uruchomieniu CRON.

Bezpieczeństwo, RODO i dane

• RODO. Moduł obsługuje eksport i usuwanie danych klienta przez standardowe mechanizmy PrestaShop (także po powiązaniu zakupu gościnnego z kontem) i wyłącza przy tym jego kupony programu.
• Wyłączenie modułu zawiesza niewykorzystane kupony bez łączenia, których warunki zależą od modułu; ponowne włączenie przywraca tylko kupony zawieszone w ten sposób. Kuponów wyłączonych ręcznie moduł nie włącza.
• Odinstalowanie zachowuje dane programu (kampanie, zaproszenia, nagrody i historię), aby ponowna instalacja nie nagradzała drugi raz tego samego produktu; program i wysyłka pozostają wtedy wyłączone.
• Wymagania bazy danych: tabele programu, opinii i kuponów muszą używać silnika InnoDB (transakcje); moduł sprawdza to przed zapisem.

Multistore, języki i integracje

• Multistore. Kampanie, ustawienia, moduł opinii, zgoda, token CRON i statystyki są osobne dla każdego sklepu. Sklep dodany później dostaje własne sekrety, a program startuje w nim wyłączony.
• Tłumaczenia polskie i angielskie w obu systemach tłumaczeń PrestaShop (słownik modułu i katalogi XLF). W językach bez tłumaczenia strony klienta pokazują teksty modułu po angielsku, dopóki nie zostaną przetłumaczone.
• Feed opinii Google. Moduł feedu opinii pdgoogleproductsreviewfeedpro od wersji 1.0.2 oznacza opinie z programu w pliku XML Google Product Reviews jako opinie po potwierdzonym zakupie (is_verified_purchase) i opinie z zachętą (is_incentivized_review). Feed jest osobnym modułem.

Zgodność i instalacja

• PrestaShop 1.7.0–9.x i PHP 7.0–8.5 (zadeklarowana zgodność). Instalacja, strony panelu, listy, eksport i deinstalacja są sprawdzane automatycznie na PrestaShop 1.7.2.4 (PHP 7.0), 1.7.8.10 (PHP 7.4), 8.0.0, 8.2.6 i 9.0.2, a pełne scenariusze od zamówienia do wykorzystania kuponu – na PrestaShop 9.1.5.
• Bez zewnętrznych bibliotek i bez Composera.
• Aktualizacja z każdej wcześniejszej wersji modułu przez Menedżer modułów; skrypty aktualizacji uzupełniają tabele, indeksy i hooki.

Ważne granice działania

• Moduł współpracuje wyłącznie z modułami opinii IQIT Reviews i Product Comments. Nie wyświetla opinii na karcie produktu ani nie ma własnej moderacji – wyświetlanie i moderacja należą do wybranego modułu opinii.
• Do działania wymagane jest zadanie CRON uruchamiane regularnie na serwerze lub w panelu hostingu.
• Zaproszenia e-mail wychodzą tylko do klientów z wybraną zgodą (newsletter albo oferty partnerów); pozostali widzą zaproszenia wyłącznie w koncie klienta.
• Zamówienia sprzed instalacji modułu nie są obejmowane automatycznie – służy do tego narzędzie „Wcześniejsze zakupy”.
• Potwierdzenie wysyłki oznacza przyjęcie wiadomości przez pocztę sklepu, a nie jej doręczenie do skrzynki odbiorcy.
• Statystyki przypisują zamówienia do użytego kuponu programu; nie mierzą przyrostu sprzedaży ani marży.
• W PrestaShop 1.7 i 8 zakaz łączenia kuponu za opinię z innymi kuponami jest egzekwowany do 100 aktywnych reguł koszyka i 2000 par; powyżej tego progu kupon nadal jest wydawany, ale może łączyć się z innymi.
• Treść opinii przechowuje moduł opinii i to on odpowiada za jej wyświetlanie oraz usuwanie. Zasady publikowania opinii w sklepie ustala sprzedawca.