Popup Pro Newsletter: kompletny przewodnik

Popup Pro Newsletter wyświetla w Twoim sklepie Shopware popup zapisu do newslettera, który nagradza każdego nowego subskrybenta kodem rabatowym ważnym na jego pierwsze zamówienie. Cel jest podwójny: powiększyć listę mailingową i wywołać pierwszą sprzedaż. Plugin opiera się wyłącznie na natywnym systemie promocji Shopware: nie tworzy żadnej własnej encji w bazie danych. Oferuje dwa tryby kodu (unikalny per subskrybent albo stały), rabat konfigurowalny procentowo lub kwotowo, wyzwalacze po czasie i po przewinięciu strony oraz zapis przez oficjalną trasę newslettera z opcjonalnym double opt-in zgodnym z RODO. Ten przewodnik obejmuje instalację, konfigurację, działanie kodów rabatowych, personalizację i rozwiązywanie problemów. Zgodny z Shopware 6.6 i 6.7.

Jak działa kod rabatowy

Przy pierwszym w ogóle zapisie odwiedzającego plugin tworzy automatycznie promocję Shopware o nazwie “Popup Newsletter, Welcome”, przypisaną do bieżącego kanału sprzedaży, z rabatem zdefiniowanym w konfiguracji. Następnie przy każdym zapisie:

• w trybie kodu unikalnego (zalecanym) generowany jest w locie indywidualny kod, przypinany do promocji przez natywne indywidualne kody promocyjne Shopware, a następnie zwracany odwiedzającemu: nie do udostępnienia, śledzalny i możliwy do ograniczenia do jednego użycia;
• w trybie kodu stałego promocja ma jeden publiczny kod (typu WELCOME10) wyświetlany wszystkim subskrybentom.

Promocja pozostaje w pełni sterowalna w Marketing → Promocje: okres ważności, warunki, reguły zaawansowane. Aby zarezerwować ofertę na całkiem pierwsze zamówienie, zostaw włączoną opcję “jedno użycie na klienta”; przy ostrzejszym targetowaniu dodaj regułę Shopware (na przykład “liczba zamówień klienta = 0”) bezpośrednio na promocji.

Instalacja

1. Pobierz archiwum DataFireflyPopupProNewsletter-v1.0.0.zip ze swojego konta DataFirefly.
2. Zainstaluj je przez Administracja → Rozszerzenia → Moje rozszerzenia → Prześlij rozszerzenie albo skopiuj rozpakowany katalog do custom/plugins/.
3. Zainstaluj i aktywuj plugin:

   bin/console plugin:refresh
   bin/console plugin:install --activate DataFireflyPopupProNewsletter
   bin/console cache:clear

4. Skompiluj motyw, aby dołączyć style popupu:

   bin/console theme:compile

Jeśli budujesz plugin samodzielnie

Na pełnej deweloperskiej instalacji Shopware JS kompiluje się tak:

bin/console plugin:refresh
bin/console plugin:install --activate DataFireflyPopupProNewsletter
bash bin/build-storefront.sh

Generuje to src/Resources/app/storefront/dist/storefront/js/data-firefly-popup-pro-newsletter/data-firefly-popup-pro-newsletter.js. Spakuj plugin ponownie razem z tym katalogiem dist/ przed wdrożeniem na produkcję.

Konfiguracja

Otwórz Rozszerzenia → Moje rozszerzenia → Popup Pro Newsletter → ⋯ → Konfiguruj. Ustawienia są zorganizowane w karty.

Ogólne

• Włącz popup: włącza albo całkowicie wyłącza wyświetlanie.

Wyświetlanie

• Pokaż po czasie (sekundy): popup pojawia się po X sekundach. 0 wyłącza ten wyzwalacz.
• Pokaż po przewinięciu (% strony): popup pojawia się po osiągnięciu tego procentu przewinięcia. 0 wyłącza ten wyzwalacz.
• Nie pokazuj ponownie przez (dni): częstotliwość wyświetlania per odwiedzający, zapamiętywana po stronie przeglądarki.
• Ukryj dla zalogowanych klientów: nie wyświetla popupu klientom już zalogowanym.

Treść

Tytuł, podtytuł, placeholder pola e-mail, tekst przycisku, komunikat sukcesu (użyj placeholdera %code%, aby wstawić kod), komunikat oczekiwania na potwierdzenie (double opt-in), opcjonalny adres URL ilustracji i kolor akcentu. Wszystkie te teksty są edytowalne i tłumaczalne.

Kod rabatowy

• Tryb kodu: unikalny (zalecany) albo stały.
• Kod stały / prefiks: publiczny kod w trybie stałym albo prefiks kodów indywidualnych w trybie unikalnym.
• Typ i wartość rabatu: procent albo kwota stała, dowolna wartość.
• Jedno użycie na klienta: ogranicza promocję do jednego użycia, aby zarezerwować ofertę na pierwsze zamówienie.
• Double opt-in: wysyła e-mail potwierdzający przed wydaniem kodu.

Double opt-in i RODO

Zapis przechodzi przez oficjalną trasę newslettera Shopware (NewsletterSubscribeRoute), co gwarantuje synchronizację z Twoimi istniejącymi odbiorcami. Gdy double opt-in jest włączony, odwiedzający otrzymuje swój kod dopiero po potwierdzeniu adresu e-mailem; w międzyczasie w popupie wyświetla się personalizowalny komunikat oczekiwania. Nie są używane żadne cookies firm trzecich: zapamiętanie “nie pokazuj ponownie” jest przechowywane po stronie przeglądarki przez localStorage.

Personalizacja popupu

Rendering jest wydzielony w views/storefront/component/datafirefly/popup-newsletter.html.twig, wstrzykiwanym z views/storefront/base.html.twig w bloku base_body. Aby zmienić strukturę popupu, nadpisz ten szablon w swoim motywie. Style znajdują się w app/storefront/src/scss/base.scss, a kolorem akcentu steruje zmienna CSS --df-popup-accent, zasilana przez ustawienie “kolor akcentu” z konfiguracji. Zachowaniem (wyzwalacze, AJAX, kopiowanie kodu) zarządza plugin storefrontu PopupNewsletterPlugin.

FAQ i rozwiązywanie problemów

Popup w ogóle się nie wyświetla. W niemal wszystkich przypadkach oznacza to brak prekompilowanego JavaScriptu: sprawdź, czy zainstalowany ZIP zawiera katalog dist/, a następnie uruchom theme:compile i wyczyść cache. Zbadaj stronę: element .df-popup-newsletter powinien być obecny w DOM z atrybutem hidden, to JS go odsłania.

Zamknąłem go raz i już nie wraca. To zachowanie oczekiwane: plugin zapamiętuje zamknięcie na skonfigurowaną liczbę dni przez klucz dfPopupNewsletterDismissedAt w localStorage. Aby przetestować ponownie, otwórz okno przeglądania prywatnego albo wyczyść pamięć lokalną przeglądarki.

Popup wyświetla się, ale bez stylów. Motyw nie został przekompilowany: uruchom bin/console theme:compile.

Kod nie jest stosowany w koszyku. Sprawdź w Marketing → Promocje, czy promocja “Popup Newsletter, Welcome” jest aktywna, przypisana do właściwego kanału sprzedaży i mieści się w swoim okresie ważności. W trybie unikalnym sprawdź, czy kod indywidualny nie został już wykorzystany.

Co dzieje się przy odinstalowaniu? Promocja i już rozdane kody są celowo zachowywane, aby nie unieważniać kodów będących w obiegu u Twoich klientów. Usuń je ręcznie w Marketing → Promocje, jeśli zajdzie taka potrzeba.

Czy plugin spowalnia mój sklep? Nie: żadnej własnej encji, żadnego dodatkowego zapytania przy ładowaniu stron, jeden lekki plik JS i SCSS skompilowany w Twoim motywie.