Instalacja

P2Lab Stage instaluje się jak każdy standardowy plugin Shopware. Po aktywacji w konfiguracji systemowej pojawiają się dwie karty — jedna per kanał sprzedaży (zachowanie storefrontu) i jedna globalna (zachowanie edytora).

Wymagania

• Shopware 6.6 (composer.json pluginu ogranicza shopware/core do >=6.6 <6.7)

Instalacja i aktywacja

1. Wgraj plugin (albo ściągnij przez Composer), żeby trafił do custom/plugins/P2LabStage.
2. Otwórz Settings → System → Plugins, znajdź P2Lab Stage, kliknij Install a potem Activate.
3. Zbuduj assety admina i storefrontu tak jak zwykle (bin/build-administration.sh, bin/build-storefront.sh albo twój pipeline CI).
4. Wyczyść cache Shopware.

Po aktywacji moduł jest dostępny pod Marketing → Stages, a ustawienia pluginu pod Settings → Plugins → P2Lab Stage.

Ustawienia storefrontu (per kanał sprzedaży)

Otwórz Settings → Plugins → P2Lab Stage → Popup (albo alternatywnie wybierz konfigurację scoped do kanału sprzedaży pod Sales Channels → <channel> → Plugins).

Enable popups on storefront

Główny przełącznik dla całego pipeline’u popupów na tym kanale sprzedaży. Gdy wyłączony, /p2lab-stage/resolve nie zwraca nic i żaden popup się nie renderuje — przydatne jako kill switch. Domyślnie: włączone.

Dismiss persistence (GDPR)

Gdzie przeglądarka przechowuje stan “już widziałem ten popup”, sterowane Twoją polityką zgód cookie:

• Wait for cookie acceptance (GDPR-compatible) (domyślnie) — plugin nie dotyka sessionStorage / localStorage dopóki odwiedzający nie zaakceptuje cookies. Do czasu zgody, suppression częstotliwości żyje tylko w sesji PHP.
• Use browser storage (sessionStorage / localStorage) — zapisuj client-side natychmiast, bez bramki zgody. Wybierz tylko jeśli Twoja polityka prawna traktuje te magazyny jako wyłączone (np. functional cookies).
• Use cookies (set without consent) — fallback do faktycznych cookies. Ta sama uwaga prawna co wyżej.

Wybrany tryb zmienia jak agresywnie odwiedzający są deduplikowani między ładowaniami stron — zobacz Storefront → GDPR & storage.

Popup display mode

Co się dzieje gdy więcej niż jeden popup kwalifikuje się na tej samej stronie:

• Only first (highest priority) (domyślnie) — renderuj tylko jedną scenę o najwyższym priorytecie. Sceny o niższym priorytecie są pomijane na to ładowanie strony.
• Queue (sequential) — renderuj je kolejno wg priorytetu, jedna po drugiej (z uwzględnieniem limitu per-sesja poniżej).

Maximum popups shown per session

Twardy limit liczby różnych popupów, które jeden odwiedzający zobaczy w sesji, niezależnie ile by się kwalifikowało. Domyślnie: 3.

Ustawienia edytora (globalne)

Otwórz Settings → Plugins → P2Lab Stage → Editor / Revisions. Te ustawienia są globalne (nie per kanał sprzedaży), bo dotyczą zachowania edytora, nie renderowania storefrontu.

Autosave interval

Co ile edytor zapisuje roboczą kopię niezapisanych zmian. Wartości w pickerze: 15 / 30 / 60 / 120 / 300 sekund. Domyślnie: 30 sekund.

Jeśli karta przeglądarki padnie zanim zapiszesz, przy następnej wizycie możesz odzyskać draft — zobacz Editor → Drafts & revisions.

Maximum revisions per stage

Ile snapshotów jest przechowywanych per scena. Po przekroczeniu limitu, najstarsza wersja jest usuwana. Wartości: 25 / 50 / 100 / 200. Domyślnie: 50.

Revisions retention

Snapshoty starsze niż ten limit są usuwane podczas zaplanowanego czyszczenia. Wartości: 7 / 14 / 30 / 60 / 90 dni. Domyślnie: 30 dni.

Limit (revisionsMaxCount) i retencja (revisionsRetentionDays) działają jednocześnie — snapshot jest usuwany, gdy któreś z ograniczeń zostanie przekroczone.

Weryfikacja instalacji

1. Otwórz Marketing → Stages w adminie. Strona listy ładuje się z pustym stanem “No stages yet”.
2. Kliknij Add stage, stwórz mały testowy popup (dowolna nazwa, domyślny modal), zapisz.
3. Przypisz mu kanał sprzedaży w zakładce Targeting.
4. Wejdź na storefront tego kanału sprzedaży. Popup powinien się wyrenderować.

Jeśli się nie pokazuje, Troubleshooting przeprowadzi Cię przez najczęstsze przyczyny (główny przełącznik wyłączony, brak zgody GDPR, cache częstotliwości, mismatch kanału sprzedaży).

Gdzie dalej

• Zbuduj kompletny popup end-to-end — Twoja pierwsza scena.
• Pełna referencja system-config jest w Advanced → System config.