Blueberry Studio
Blue Mystery Box: magiczne skrzynki w koszyku
Moduł gamifikacji koszyka. Wyświetla klientowi „magiczną skrzynkę”, która po kliknięciu odsłania losowy rabat: procent, kwotę albo darmową dostawę. Efekt FOMO, wyższa wartość koszyka i klienci, którzy wracają sprawdzić nowy drop.
Moduł bluemysterybox • wersja 1.1.0 • PrestaShop 1.7 – 9.0
W jednym zdaniu: W panelu ustawiasz jakie rabaty mają się losować i z jakim prawdopodobieństwem, ograniczasz dostępność do wybranych dni/godzin i progów koszyka, a moduł sam wyświetla skrzynkę w koszyku klienta i po kliknięciu dokleja mu wygrany rabat, bez przeładowania strony.
Zanim zaczniesz, najważniejsze pojęcia (przeczytaj, to zajmie minutę):
- Panel administracyjny (admin / back office): strona, na której zarządzasz sklepem. Wchodzisz przez swój specjalny adres i logujesz się e-mailem i hasłem.
- Mystery Box (skrzynka): pojedyncza kampania. Ma nazwę, listę nagród, warunki dostępności i status.
- Nagroda (reward): konkretny rabat, który klient może wylosować, np. „10% zniżki” albo „darmowa dostawa”. Każda ma swoją wagę: im wyższa, tym częściej się wylosuje.
- Waga losowania: liczba względna. Nagroda z wagą
50wylosuje się średnio 5× częściej niż ta z wagą10. Nie musisz liczyć procentów: moduł normalizuje sam. - Cache (pamięć podręczna): sklep zapamiętuje wygląd stron, żeby działały szybciej. Po zmianach czasem trzeba ją „wyczyścić”, żeby zobaczyć efekt.
Spis treści
1.Co dokładnie robi moduł
Blue Mystery Box wstawia w koszyku (lub w podsumowaniu zamówienia) interaktywną skrzynkę. Klient klika, widzi animację otwarcia, dostaje jeden z rabatów które ustawiłeś. Rabat jest doklejany do koszyka automatycznie, bez przeładowania strony.
Do tego dochodzi pełen panel zarządzania kampaniami: dowolna liczba skrzynek, każda z własną listą nagród, oknem czasowym i progami koszyka. Kampanie można włączać i wyłączać jednym kliknięciem.
2.Instalacja / aktualizacja
- Zaloguj się do panelu administracyjnego sklepu.
- Z menu wybierz Moduły → Menedżer modułów.
- W prawym górnym rogu kliknij „Prześlij moduł”.
- Wskaż plik
bluemysterybox.zip. - Poczekaj na komunikat o powodzeniu i, jeśli trzeba, kliknij „Zainstaluj”.
Po instalacji w menu Moduły → Menedżer modułów szukaj „Blue Mystery Box → Konfiguruj”. Cała robota dzieje się tam.
3.Ustawienia globalne
Zakładka „Ustawienia” na górze konfiguracji. Ustawiasz raz i wracasz tylko, jeśli chcesz coś zmienić.
| Ustawienie | Do czego |
|---|---|
| Moduł aktywny | Główny wyłącznik. Zostaw Tak. Wyłączenie ukrywa wszystkie skrzynki, ale nie kasuje kampanii. |
| Wyświetlanie w koszyku | Wybierz, gdzie skrzynka ma się pojawić: stopka koszyka, sam koszyk lub podsumowanie zamówienia. |
| Animacje | Włącza efekty 3D otwierania skrzynki. Wyłącz, jeśli klienci używają wolnych urządzeń albo styl sklepu jest minimalistyczny. |
| Dźwięki | Krótki „ping” przy otwarciu. Domyślnie wyłączone (dźwięk na stronie irytuje 90% odbiorców). |
4.Nowy Mystery Box (kampania)
- W konfiguracji przejdź do zakładki „Mystery Boxes”.
- Kliknij „Dodaj Mystery Box”.
- Wypełnij pola:
- Nazwa: dla Ciebie, klienci widzą to tylko jeśli sam wstawisz w tytule skrzynki. Np. „Weekendowy Drop”.
- Tytuł skrzynki: co widzi klient nad grafiką, np. „Otwórz i zgarnij niespodziankę”.
- Opis: jedno-dwa zdania pod tytułem, np. „Codziennie inne rabaty. Kliknij i sprawdź, co dziś wypadło.”
- Status: draft na start (nikt nie widzi), potem active.
- Zapisz. Kampania trafia na listę, na razie bez nagród i warunków.
5.Nagrody: typy rabatów i wagi
W widoku kampanii dodajesz jedną lub więcej nagród. Klient dostanie jedną, wylosowaną według wag.
| Typ rabatu | Kiedy wybierać |
|---|---|
| Procent | Np. 10%, 20%, 50%. Skaluje się z wartością koszyka: dobre do zwiększania średniej wartości zamówienia. |
| Kwota | Stała suma w walucie sklepu, np. 25 zł. Prosto i przewidywalnie, dobre do koszyków w wąskim zakresie cen. |
| Darmowa dostawa | Rabat na koszty wysyłki, w praktyce zerujący je do zera. Doskonały „lock-in” do finalizacji zamówienia. |
Dla każdej nagrody ustaw:
- Wartość (procent lub kwota; dla darmowej dostawy nie dotyczy).
- Waga losowania — liczba, jak często ma wypadać. Przykład: chcesz żeby 20% szło jako „darmowa dostawa”, 60% jako „5% rabatu”, 20% jako „15% rabatu”, ustawiasz odpowiednio wagi
20 / 60 / 20. Sumy nie muszą wyjść na 100, moduł normalizuje. - Limit użyć (opcjonalnie) — po ilu wylosowaniach nagroda przestaje wchodzić w pulę. Przydatne dla top-tier prizeów typu „50% rabatu, ale tylko 10 pierwszych osób”.
Uważaj z wysokimi procentami. Nagroda „50%” z wagą
10 obok trzech nagród „5%” z wagą 1 każda daje 50%-owy rabat w 77% otwarć, a nie 25% jak by się mogło wydawać. Zawsze policz koszt oczekiwany przed publikacją.
6.Warunki dostępności (kiedy skrzynka się pokazuje)
Sekcja „Warunki” w widoku kampanii. Możesz łączyć wiele reguł jednocześnie; jeśli któraś nie jest spełniona, skrzynka się nie pokaże.
| Warunek | Zastosowanie |
|---|---|
| Dni tygodnia | Np. tylko czwartki (klasyczny „Thirsty Thursday drop”) albo tylko weekendy. |
| Godziny | Przedział czasu w ciągu doby, np. 18:00–23:59 („Happy Hour”). |
| Zakres dat | Data od–do. Po dacie zamknięcia skrzynka znika automatycznie, nie musisz jej wyłączać ręcznie. |
| Wartość koszyka | Minimalna i maksymalna kwota. Klasyk: „darmowa skrzynka od 200 zł w koszyku”, żeby zachęcić do dobicia progu. |
Skrzynka bez żadnych warunków = zawsze widoczna dla wszystkich klientów. To OK dla trwałej promocji, ale traci efekt „drop-u”. FOMO działa najlepiej, kiedy okno jest krótkie.
7.Test kampanii i publikacja
- Zostaw kampanię na razie w statusie draft.
- W drugiej przeglądarce (albo trybie incognito) wejdź na sklep jako klient, dodaj coś do koszyka i sprawdź, czy skrzynka się pojawia (jeśli status = draft, powinna być niewidoczna).
- Przełącz status na active i odśwież koszyk. Skrzynka powinna się pojawić.
- Kliknij, sprawdź czy animacja gra, czy rabat doklejający się do koszyka jest prawidłowej wielkości i czy sekcja rabatów w podsumowaniu go pokazuje.
- Jak wszystko OK, przełącz status trwale na active.
Wyczyść cache po każdej zmianie: Zaawansowane → Wydajność → Wyczyść cache. Bez tego zmieniona kampania może się nie odświeżyć u zalogowanych klientów.
8.Jak to wygląda dla klienta
- Klient wchodzi do koszyka i widzi grafikę zamkniętej skrzynki z tytułem i opisem kampanii.
- Klika w skrzynkę. Odpala się krótka animacja 3D otwierania.
- Po animacji widzi wygraną nagrodę (np. „Wygrałeś: 10% rabatu”).
- Rabat od razu pojawia się w podsumowaniu koszyka — bez klikania „zastosuj kupon”.
- Klient przechodzi do checkoutu z aktywnym rabatem.
Rabat z Mystery Box jest przypisany do bieżącej sesji koszyka. Jeśli klient wyczyści koszyk i doda produkty od nowa, moduł potraktuje to jako nową próbę i wylosuje raz jeszcze (chyba że włączyłeś limit „1 raz na klienta”).
9.Najczęstsze pytania i problemy
Skrzynka się nie pokazuje
- Sprawdź, czy moduł jest aktywny globalnie (Ustawienia).
- Sprawdź, czy kampania ma status active.
- Sprawdź, czy jesteś w oknie dostępności (dzień/godzina/data).
- Sprawdź, czy wartość koszyka mieści się w progach.
- Wyczyść cache PrestaShop.
Skrzynka jest, ale po kliknięciu nic się nie dzieje
- Otwórz w przeglądarce narzędzia deweloperskie (F12), zakładka Console. Jeśli widać czerwony błąd JS, prawdopodobnie zderzył się jakiś inny moduł.
- Sprawdź, czy motyw sklepu nie blokuje AJAX-a w koszyku. Standardowy PrestaShop classic działa bez problemu.
Klient dostał rabat, ale nie widzi go w podsumowaniu
- To zwykle problem z hookem koszyka. W konfiguracji zmień „Wyświetlanie” z displayShoppingCartFooter na displayCart (albo odwrotnie) i sprawdź ponownie.
Chcę żeby jeden klient mógł otworzyć skrzynkę tylko raz na dzień
- W obecnej wersji MVP jest limit „raz na sesję koszyka”. Twarde ograniczenie „raz na dzień na klienta” wymaga dopisania powiązania z
id_customer+ datą — do zrobienia w kolejnej wersji, jeśli będzie sens.
Chcę mieć skrzynki tylko dla stałych klientów
- Ustaw warunek „Minimalna wartość koszyka” na próg, który zwykle osiągają tylko powracający klienci, albo poczekaj na wersję z segmentacją po grupie klienta.