PS PrestaShop PrestaShop Średnio zaawansowany

Zapisane Wyszukiwania i Alerty o Nowych Produktach: dokumentacja

Instalacja, konfiguracja i harmonogram modułu dfsavedsearch: zapisane wyszukiwania, alerty e-mail o nowych produktach, cron i zgodność z RODO.

Zaktualizowano Wersja modułu 1.0.0

Prezentacja

Moduł Zapisane Wyszukiwania i Alerty (dfsavedsearch) pozwala Twoim klientom zapisać kombinację kryteriów wyszukiwania (słowa kluczowe, kategoria, producent, przedział cenowy, dostępność) i otrzymać automatyczny e-mail, gdy tylko w sklepie pojawi się nowy pasujący produkt.

Każde zapisane wyszukiwanie staje się kanałem ponownego zaangażowania: klient wraca sam z siebie w dniu, w którym publikujesz produkt, który go interesuje. Dziennik antyduplikatowy gwarantuje, że otrzyma alert wyłącznie o produktach opublikowanych po zapisaniu wyszukiwania i nigdy dwa razy o tym samym produkcie.

W skrócie: zapisanie wyszukiwania jednym kliknięciem ze strony wyników, alert e-mail z jawną zgodą, dzienne lub tygodniowe zestawienie wysyłane przez zadanie cron hostowane lokalnie, natywna zgodność z RODO.

Instalacja

  1. W panelu administracyjnym otwórz Moduły > Menedżer modułów i kliknij Wgraj moduł.
  2. Wskaż archiwum dfsavedsearch.zip i zatwierdź.
  3. Podczas instalacji moduł tworzy swoje dwie tabele SQL, zakładkę administracyjną i konfigurację domyślną. Token crona (32 znaki) generowany jest automatycznie.
  4. Moduł działa od razu. Nie wymaga żadnych zależności zewnętrznych (ani Composera, ani frameworka).

Moduł jest zgodny z PrestaShop od 8.0 do 9.x, w trybie pojedynczego sklepu i multistore, oraz z pięcioma językami katalogu (FR, EN, ES, DE, IT).

Konfiguracja (panel administracyjny)

Przejdź na stronę konfiguracji modułu (Moduły > Menedżer modułów > dfsavedsearch > Konfiguruj). Dostępne ustawienia:

  • Włącz moduł: uruchamia lub zawiesza wyświetlanie przycisku i wysyłkę alertów.
  • Produkty na zestawienie: maksymalna liczba produktów wypisanych w jednym e-mailu z alertem (domyślnie 12).
  • Wyszukiwania na klienta: maksymalna liczba wyszukiwań, jakie klient może zapisać (domyślnie 20).
  • Domyślna częstotliwość: dzienna lub tygodniowa, stosowana do nowych wyszukiwań.
  • Token crona: wyświetlany jawnie, z przyciskiem ponownego wygenerowania. Pełny adres URL crona oraz data ostatniego przebiegu widoczne są w dedykowanym panelu.

Wartości zapisywane są w zmiennych konfiguracyjnych DFSAVEDSEARCH_ENABLED, DFSAVEDSEARCH_MAX_PRODUCTS, DFSAVEDSEARCH_MAX_PER_CUST, DFSAVEDSEARCH_DEFAULT_FREQ, DFSAVEDSEARCH_CRON_TOKEN i DFSAVEDSEARCH_LAST_CRON.

Obsługa po stronie klienta

Na stronie wyników wyszukiwania automatycznie wstrzykiwany jest przycisk „Zapisz to wyszukiwanie”. Po jego kliknięciu klient otwiera okno, w którym może:

  • nazwać swoje wyszukiwanie;
  • doprecyzować lub skorygować kryteria: słowa kluczowe, kategoria (wraz z podkategoriami), producent, cena minimalna i maksymalna, tylko produkty dostępne w magazynie;
  • włączyć, jeśli chce, alert e-mail i wybrać jego częstotliwość.

Alert e-mail opiera się na jawnej zgodzie, domyślnie odznaczonej, z czytelną treścią zgody. Niezalogowany odwiedzający proszony jest o zalogowanie się przed zapisaniem wyszukiwania.

Sekcja „Moje wyszukiwania”

W koncie klienta dodawana jest pozycja „Moje wyszukiwania”. Klient znajduje tam wszystkie zapisane wyszukiwania i może dla każdego z nich:

  • włączyć lub wyłączyć alert e-mail;
  • zmienić częstotliwość (dzienna / tygodniowa);
  • usunąć wyszukiwanie.

Kryteria każdego wyszukiwania podsumowane są w postaci czytelnych plakietek (kategoria, producent, przedział cenowy itd.).

Harmonogram crona (wysyłka alertów)

Wysyłką e-maili steruje zadanie cron zabezpieczone tokenem. Skonfiguruj harmonogram zadań swojego serwera (albo zewnętrzną usługę cron), aby wywoływał następujący adres:

https://twoj-sklep.com/index.php?fc=module&module=dfsavedsearch&controller=cron&token=TWOJ_TOKEN

Zastąp TWOJ_TOKEN tokenem wyświetlonym w konfiguracji modułu.

Zalecana częstotliwość: wywołuj adres co godzinę. Moduł respektuje następnie częstotliwość właściwą dla każdego wyszukiwania (dzienną lub tygodniową): data ostatniej wysyłki aktualizowana jest tylko wtedy, gdy e-mail rzeczywiście został wysłany.

Przetwarzanie odbywa się partiami (200 wyszukiwań na przebieg), aby pozostać lekkim. Wynik crona podaje liczbę przetworzonych wyszukiwań, wysłanych e-maili oraz ewentualnych błędów, zapisywanych w dziennikach PrestaShop.

Zachowaj poufność tokenu crona. W razie wycieku wygeneruj go ponownie jednym kliknięciem z poziomu konfiguracji: stary adres przestanie wtedy działać.

Zgodność z RODO

  • Jawna zgoda: alert e-mail nigdy nie włącza się bez świadomego działania klienta (pole domyślnie odznaczone).
  • Wypisanie jednym kliknięciem: każdy e-mail zawiera podpisany odnośnik rezygnacji, który wyłącza alert bez logowania.
  • Eksport i usuwanie: moduł integruje się z hookami RODO PrestaShop (psgdpr) na potrzeby eksportu i usuwania danych osobowych.
  • Automatyczne czyszczenie: przy usunięciu konta klienta kasowane są wszystkie jego zapisane wyszukiwania.

Zgodność i konwencje techniczne

  • PrestaShop od 8.0 do 9.x, multistore, 5 języków.
  • Wykorzystywane hooki: displayCustomerAccount, actionFrontControllerSetMedia, displayFooter, actionObjectCustomerDeleteAfter, actionDeleteGDPRCustomer, actionExportGDPRData.
  • Zakładka administracyjna AdminDfSavedSearch w menu Klienci.
  • Żadnych zależności: ręczny autoloader PSR-4, czysty JavaScript, brak usług zewnętrznych.

Rozwiązywanie problemów

  • Żaden e-mail nie jest wysyłany: sprawdź, czy cron jest rzeczywiście wywoływany (data ostatniego przebiegu w konfiguracji), czy moduł jest włączony i czy konfiguracja poczty w PrestaShop działa poprawnie.
  • Przycisk się nie pojawia: wyświetla się wyłącznie na stronie wyników wyszukiwania. Sprawdź, czy moduł jest włączony, i wyczyść cache PrestaShop.
  • Klient nie otrzymuje alertu: upewnij się, że alert jest aktywny dla danego wyszukiwania i że nowe pasujące produkty rzeczywiście zostały opublikowane po jego zapisaniu.
Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia