1. Do czego służy moduł
Prosty Popup Modalny wyświetla w sklepie okno wyskakujące. Możesz w nim pokazać ogłoszenie, kod rabatowy, zaproszenie do newslettera albo ważną informację dla klientów.
Okno to natywny modal Bootstrap Twojego szablonu (Bootstrap 4 w szablonie Classic w PrestaShop 1.7.8 i 8.x, Bootstrap 5 w szablonie Hummingbird w PrestaShop 9.x). Wygląda więc tak samo jak inne okna sklepu i nie dokłada żadnej zewnętrznej biblioteki.
Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy) oraz z multistore.
2. Instalacja
- Pobierz moduł z Moje konto → Historia zamówień w addonspresta.com.
- W panelu administracyjnym otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Wskaż plik
ap_simplepopup_v1.0.1.zipi poczekaj na potwierdzenie. - Kliknij Konfiguruj na karcie modułu.
Jeśli masz dostęp do konsoli serwera, możesz też rozpakować archiwum do katalogu modules/ i w katalogu głównym sklepu uruchomić php bin/console prestashop:module install ap_simplepopup.
3. Jak to działa
Moduł dodaje okno na końcu strony (punkt zaczepienia displayBeforeBodyClosingTag) i dołącza do niego mały skrypt. Gdy klient otwiera stronę, skrypt sprawdza, czy klient zamknął już aktualny popup. Jeśli nie, odczekuje ustawione opóźnienie i otwiera okno.
Wybór klienta zapisuje się w pliku cookie, gdy tylko zamknie on okno w dowolny sposób — krzyżykiem, klawiszem Escape, kliknięciem obok okna — albo kliknie link w jego treści. Popup nie wraca, dopóki cookie nie wygaśnie. Gdy zmienisz tytuł lub treść, każdy klient zobaczy nowy popup jeden raz, nawet jeśli zamknął poprzedni. Żeby pokazać wszystkim ponownie popup bez zmian, użyj opcji Pokaż popup ponownie wszystkim.
Popup nigdy nie pojawia się w koszyku ani podczas składania zamówienia, żeby nie przeszkadzać w zakupie.
Ustawienia są zapisane w standardowej konfiguracji PrestaShop, osobno dla każdego sklepu. Moduł nie zmienia tabel PrestaShop i nie łączy się z żadnym zewnętrznym serwerem.
4. Funkcje i ustawienia
Otwórz Moduły → Menedżer modułów → Prosty Popup Modalny → Konfiguruj. Ramka Pomoc na górze strony prowadzi do tej instrukcji w Twoim języku i do strony modułu w addonspresta.com, pokazuje też adres wsparcia i wersję modułu.
Włącz popup
Włącza lub wyłącza popup w sklepie bez odinstalowania modułu i bez utraty treści.
Gdzie wyświetlać
Wybierz, gdzie ma się pojawiać popup:
- Wszystkie strony: każda strona sklepu poza koszykiem i składaniem zamówienia.
- Tylko strona główna: wyłącznie strona główna sklepu.
Opóźnienie wyświetlenia (sekundy)
Czas od załadowania strony do otwarcia okna. Wpisz 0, żeby popup pojawił się od razu, albo kilka sekund (na przykład 3–5), żeby klient najpierw zobaczył stronę. Dozwolone wartości: od 0 do 60.
Czas zapamiętania w cookie (dni)
Przez ile dni sklep pamięta, że klient zamknął popup. Wpisz 0, żeby pamiętał tylko do zamknięcia przeglądarki, albo od 1 do 365 dni (domyślnie 7).
Tytuł popupa
Opcjonalny tytuł w nagłówku okna, osobny dla każdego języka. Język bez tytułu pokazuje tytuł z domyślnego języka sklepu. Jeśli chcesz popup bez tytułu, zostaw to pole puste w języku domyślnym.
Treść popupa
Zawartość okna edytowana w edytorze wizualnym: tekst, nagłówki, linki, obrazki, przyciski albo kody rabatowe, osobno dla każdego języka. Treść jest wymagana w domyślnym języku sklepu — pusty akapit się nie liczy. Język bez własnej treści pokazuje treść z języka domyślnego.
Pokaż popup ponownie wszystkim
Włącz ten przełącznik i zapisz, a popup pojawi się znowu każdemu klientowi, także temu, który już go zamknął — na przykład gdy promocja wraca z tym samym tekstem. Przełącznik jest domyślnie wyłączony i po zapisie sam wraca na „Nie”, więc zwykły zapis ustawień nigdy nie resetuje popupu.
5. Multistore
Ustawienia zapisują się dla sklepu lub grupy sklepów wybranej w nagłówku panelu. Wybierz Wszystkie sklepy, żeby wszędzie był ten sam popup, albo przełącz się na jeden sklep, żeby nadać mu własne treści, opóźnienie i miejsce wyświetlania. Cookie zamknięcia jest osobne dla każdego sklepu; reset wykonany przy wybranych Wszystkich sklepach albo grupie sklepów pokazuje popup ponownie w każdym sklepie z tego wyboru. W kontekście wszystkich sklepów albo grupy zapisać może tylko pracownik, który zarządza każdym jej sklepem. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Otwórz Moduły → Menedżer modułów → Prosty Popup Modalny → Odinstaluj. Odinstalowanie usuwa wszystkie ustawienia modułu. Żeby wstrzymać popup bez utraty treści, wyłącz Włącz popup albo wyłącz moduł.
7. Najczęstsze pytania i problemy
Popup nie pojawia się w sklepie. Sprawdź, czy opcja Włącz popup jest włączona i czy nie jesteś w koszyku albo w zamówieniu. Jeśli popup był już zamknięty w tej przeglądarce, usuń cookies sklepu w przeglądarce albo otwórz sklep w oknie prywatnym. Potem wyczyść pamięć podręczną w Zaawansowane → Wydajność.
Po zmianie popupa klienci go nie widzą. Po zmianie tytułu lub treści popup pojawia się ponownie wszystkim, po ustawionym opóźnieniu. Jeśli wybrano Tylko strona główna, pojawia się tylko na stronie głównej.
Czy mogę dopasować wygląd do szablonu?
Popup korzysta ze standardowego znacznika modala Bootstrap i przejmuje style okien, czcionki i przyciski Twojego szablonu. Własne poprawki dodasz w arkuszu stylów szablonu dla klas .ap-simplepopup, .ap-simplepopup__title, .ap-simplepopup__body i .ap-simplepopup__close.
Czy mogę pokazywać popup tylko części klientów?
Tak, programista zrobi to przez punkt zaczepienia modułu actionApSimplepopupDisplay — opis w pliku README.md w katalogu modułu.
Czy moduł spowalnia sklep? Nie. Dodaje małe okno i krótki skrypt, i to tylko na stronach, na których popup się wyświetla.
8. Aktualizacje i wsparcie
Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz tak samo jak nowy moduł. Ustawienia i treści zostają zachowane.
Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy na addonspresta.com (od poniedziałku do piątku, 10:00–16:00; odpowiadamy zwykle w ciągu 2 dni roboczych). Podaj wersję PrestaShop, wersję modułu i opis problemu.