# Zaawansowana Lista Życzeń — Udostępnianie, Alerty i Analityka — Kompletny przewodnik

> Prezentacja i wymagania wstępne Zaawansowana Lista Życzeń zamienia listę życzeń w prawdziwą dźwignię konwersji. Twoi klienci tworzą wiele nazwanych list, udostępniają je linkiem i otrzymują automatyczne alerty przy spadku ceny…

- Strona: <https://www.datafirefly.com/pl/documentation/dfwishlist/>
- Język: pl
- Zaktualizowano: 2026-08-12
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfwishlist/index.md), [en](https://www.datafirefly.com/en/documentation/dfwishlist/index.md), [es](https://www.datafirefly.com/es/documentation/dfwishlist/index.md), [de](https://www.datafirefly.com/de/documentation/dfwishlist/index.md), [it](https://www.datafirefly.com/it/documentation/dfwishlist/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfwishlist/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfwishlist/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Prezentacja i wymagania wstępne

Zaawansowana Lista Życzeń zamienia listę życzeń w prawdziwą dźwignię konwersji. Twoi klienci tworzą wiele nazwanych list, udostępniają je linkiem i otrzymują automatyczne alerty przy spadku ceny lub powrocie do magazynu. Po stronie sprzedawcy każda interakcja jest śledzona w dashboardzie analitycznym, a konfigurowalne przypomnienia e-mail sprowadzają klientów z powrotem do ich ulubionych produktów.

- Kompatybilny z PrestaShop 8.0 do 9.x, motywem Classic i motywami pochodnymi respektującymi natywne hooki.
- Multistore i wielojęzyczny (FR/EN/ES/DE/IT).
- Natywny JavaScript — żadnej dodatkowej zależności jQuery.
- Architektura zgodna z PrestaShop (ModuleAdminController, ObjectModel), bez zależności Composer.
- Zadanie CRON jest wymagane do wysyłki alertów i przypomnień.

Przycisk listy życzeń wyświetla się przez standardowe hooki karty produktu i list. Żadne nadpisywanie szablonu nie jest potrzebne na zgodnym motywie.

## Instalacja

Zainstaluj moduł jak każdy inny moduł PrestaShop:

1. Pobierz archiwum `dfwishlist.zip` ze swojego konta klienta.
2. W back-office przejdź do **Moduły > Menedżer modułów**.
3. Kliknij **Zainstaluj moduł** i upuść archiwum.
4. Po instalacji kliknij **Konfiguruj**.

Przy instalacji moduł tworzy swoje tabele (listy, produkty, udostępnienia, alerty, przypomnienia, statystyki, goście), rejestruje hooki, dodaje zakładkę **Wishlist** do menu i automatycznie generuje bezpieczny **token CRON**. Możesz zacząć konfigurację od razu.

## Ogólne ustawienia modułu

Strona konfiguracji zbiera wszystkie ustawienia, uporządkowane w sekcje. Główne ustawienia ogólne:

- **Włącz moduł**: aktywuje lub dezaktywuje wyświetlanie przycisku i funkcje po stronie sklepu.
- **Lista życzeń dla odwiedzających (gości)**: pozwala niezalogowanym odwiedzającym dodawać produkty. Lista jest przechowywana w cookie, potem scalana z kontem klienta przy logowaniu lub rejestracji.
- **Maksymalna liczba list na klienta**: limit nazwanych list, które klient może utworzyć (domyślnie 10).
- **Styl przycisku**: sama ikona (serce), ikona + tekst lub sam tekst.
- **Pozycja przycisku na karcie produktu**: po przycisku „Dodaj do koszyka”, przed nim lub w strefie informacji dodatkowych.
- **Wyświetlaj na listach produktów**: dodaje przycisk na stronach kategorii, wyszukiwania i nowości.

## Przycisk, panel klienta i adresy URL

Po aktywacji modułu przycisk listy życzeń (serce) pojawia się na kartach produktów i, jeśli opcja jest włączona, na listach produktów. Link **Moje listy życzeń** jest dodawany do panelu klienta („Moje konto”).

Moduł udostępnia czyste i czytelne adresy URL dla SEO:

```
/mes-listes-de-souhaits          → wszystkie listy klienta
/liste-de-souhaits/{token}       → konkretna lista
/wishlist-partagee/{token}       → lista udostępniona publicznie
```

Po instalacji wyczyść cache PrestaShop i przegeneruj trasy (wyłącz/włącz przyjazne URL w razie potrzeby), aby nowe adresy zostały uwzględnione.

## Wiele list i lista gościa

Każdy klient może utworzyć wiele nazwanych list („Boże Narodzenie”, „Ślub”, „Pomysły do biura”…) do zdefiniowanego przez Ciebie limitu i zarządzać w nich produktami z wariantami. Niezalogowani odwiedzający korzystają z listy przechowywanej w cookie: gdy tylko założą konto lub się zalogują, ich produkty są automatycznie scalane z panelem klienta, bez strat.

Gdy opcja **Usuń z listy życzeń po zakupie** jest włączona, kupiony produkt jest automatycznie usuwany z list klienta przy zatwierdzeniu zamówienia, aby listy pozostały aktualne.

## Udostępnianie listy

Gdy udostępnianie jest włączone, każda lista może być udostępniona przez unikalny publiczny URL zabezpieczony tokenem. Odbiorca przegląda listę bez potrzeby konta — idealne dla list prezentów urodzinowych czy ślubnych. Gotowy e-mail udostępniania jest dostarczany po francusku i angielsku.

Udostępniona lista jest dostępna tylko do odczytu przez swój token. Token jest losowy i nie do odgadnięcia; odwołanie udostępnienia czyni link nieaktywnym.

## Dowód społeczny (efekt FOMO)

Dowód społeczny wyświetla na karcie produktu liczbę osób, które dodały ten produkt do swojej listy życzeń („X osób dodało ten produkt do swojej listy życzeń”). Aby nie pokazywać mało pochlebnych liczb na nowych produktach, definiujesz **minimalny próg**: licznik pojawia się dopiero od tej liczby dodań.

## Automatyczne alerty: spadek ceny i powrót do magazynu

Moduł monitoruje produkty obecne na listach i wyzwala dwa typy alertów e-mail:

- **Alert spadku ceny**: gdy cena produktu z listy życzeń maleje, odpowiedni klienci są powiadamiani.
- **Alert powrotu do magazynu**: gdy wyprzedany produkt znów staje się dostępny, oczekujący klienci są informowani.

Każdy typ alertu aktywuje się niezależnie w konfiguracji. Faktyczna wysyłka e-maili jest realizowana przez CRON (patrz niżej). Szablony e-mail HTML są dostarczane po francusku i angielsku.

## Konfigurowalne przypomnienia e-mail

Na wzór przypomnień o porzuconym koszyku, przypomnienia przypominają klientom o produktach obecnych na ich liście życzeń. Konfigurujesz do **5 etapów** przypomnienia, każdy z:

- **Opóźnieniem** w godzinach (np. 24 h, 72 h, potem 168 h / 7 dni).
- **Personalizowanym tematem** po francusku i angielsku.

Zostaw opóźnienie etapu na **0**, aby go wyłączyć. Limit liczby e-maili przypomnienia na klienta zapobiega nadmiernemu nagabywaniu. Wartości domyślne proponują trzy gotowe etapy (24 h, 72 h, 168 h).

Trzymaj krótkie i zachęcające tematy oraz wystarczająco rozłóż etapy w czasie. Trzy dobrze rozłożone przypomnienia zwykle konwertują lepiej niż zbyt gęsta seria.

## Konfiguracja CRON

Alerty i przypomnienia są wysyłane przez zaplanowane zadanie. Przy instalacji moduł generuje **token** zabezpieczający URL CRON-a. Dodaj na swoim serwerze (lub u hostingodawcy) zadanie wywołujące URL modułu w regularnych odstępach — jedno przejście na godzinę to dobry punkt startowy.

```
curl "https://twoj-sklep.pl/modules/dfwishlist/cron/cron.php?action=all&token=TWOJ_TOKEN"
```

Parametr `action` przyjmuje trzy wartości:

- `all`: przetwarza alerty i przypomnienia (zalecane).
- `alerts`: przetwarza tylko alerty spadku ceny i powrotu do magazynu.
- `reminders`: przetwarza tylko przypomnienia.

Token jest obowiązkowy: wywołanie bez tokenu lub z błędnym tokenem jest odrzucane. Nie rozpowszechniaj publicznie pełnego URL CRON-a. Możesz przegenerować token w razie wycieku.

## Dashboard analityczny sprzedawcy

Zakładka **Wishlist** w back-office daje wgląd w aktywność w czasie rzeczywistym:

- **Najczęściej dodawane produkty**, z liczbą dodań.
- **Najpopularniejsze kategorie** na listach.
- **Wskaźnik konwersji** lista życzeń → zakup oraz wskaźnik dodania do koszyka.
- Wolumen aktywnych **udostępnień**.

Tabele można **eksportować do CSV**, aby wykorzystać je w arkuszu kalkulacyjnym lub skrzyżować z innymi danymi marketingowymi.

## FAQ i rozwiązywanie problemów

### Czy niezalogowani odwiedzający mogą używać listy życzeń?

Tak, jeśli opcja gościa jest włączona. Lista gościa jest przechowywana w cookie i automatycznie scalana z kontem klienta przy logowaniu lub rejestracji.

### Przycisk listy życzeń nie wyświetla się na karcie produktu

Sprawdź, czy moduł jest aktywny, czy motyw respektuje natywne hooki (**displayProductActions**, **displayProductAdditionalInfo**) i przetestuj inną pozycję przycisku. Na listach produktów skontroluj, czy opcja „Wyświetlaj na listach produktów” jest aktywna i czy motyw wywołuje hook **displayProductListFunctionalButtons**. Wyczyść cache po każdej zmianie.

### Alerty lub przypomnienia nie wychodzą

E-maile są wysyłane przez CRON, nie w czasie rzeczywistym. Sprawdź, czy zaplanowane zadanie faktycznie wywołuje URL modułu z prawidłowym tokenem, czy używana akcja to `all` (lub `alerts` / `reminders`) i czy wysyłka e-maili sklepu działa (konfiguracja SMTP PrestaShop).

### Jak spersonalizować e-maile przypomnienia?

Konfigurujesz do 5 etapów, każdy z opóźnieniem w godzinach i tematem po francusku i angielsku, bezpośrednio ze strony konfiguracji. Szablony HTML znajdują się w folderze `mails` modułu i można je nadpisać przez motyw.

### Czy dowód społeczny jest zawsze widoczny?

Nie. Licznik pojawia się dopiero od zdefiniowanego przez Ciebie minimalnego progu dodań, aby nie pokazywać zbyt niskich liczb na nowych produktach.

### Co się dzieje przy odinstalowaniu?

Odinstalowanie usuwa hooki i zakładkę modułu oraz kasuje jego tabele wraz z powiązanymi danymi list życzeń. Wykonaj wcześniej kopię, jeśli chcesz zachować te dane.