Wprowadzenie

P2Lab Stage to wizualny builder treści promocyjnych w Shopware 6. Zamiast układać bloki CMS dla każdego bannera albo hero, projektujesz bezpośrednio na warstwowym płótnie — dodajesz obrazy, teksty, buttony, kształty, countdowny — animujesz je na osi czasu z keyframe’ami i decydujesz kto je zobaczy i na jakich stronach. Plugin znajdziesz pod Marketing → Stages w panelu admina Shopware.

Dla kogo

Projektanci i marketerzy, którzy chcą układać treści promocyjne wizualnie na warstwowym płótnie — bez pisania HTML/CSS.
Sklepy, które potrzebują kampanii czasowych — flash sale, promocje sezonowe, rotacje hero — gdzie ten sam overlay albo hero ma odpalać na różnych stronach, dla różnych odbiorców, w określonym harmonogramie.
Sklepy, które muszą respektować RODO/GDPR — popupy, które czekają na zgodę cookie zanim zapiszą stan odrzucenia, a w razie braku zgody fallbackują na sesję PHP.

Dwa typy scen

Każda treść renderowana przez plugin to scena. Dziś dostępne są dwa typy:

Popup — overlay nad stroną. Dziewięć wariantów wyświetlania: wycentrowany modal, bannery góra/dół, slide-iny lewo/prawo, cztery rogowe toasty. Konfigurowalne wyzwalanie (natychmiast / opóźnienie / scroll), częstotliwość (na sesję / N dni / zawsze / na stałe), harmonogram i odbiorcy.
Slider — osadzany w stronach CMS przez element Shopping Experiences P2Lab Stage Slider. Wiele slajdów, każdy z własną sceną; wbudowana oś czasu slidera utrzymuje je w synchronizacji.

Kluczowe pojęcia

Te terminy będą się przewijać przez całą dokumentację. Krótki słownik, żeby nie były później zaskoczeniem:

Stage (scena) — pojedyncza treść z własnym płótnem, warstwami, osią czasu, triggerem, odbiorcami i statystykami. Jednostka, którą tworzysz i którą zarządzasz.
Layer (warstwa) — element na płótnie. Warstwy wizualne (image, text, button, html, arrow, shape), organizacyjne (group), kontenerowe (scene, section, row, column), kompozytowe (countdown, coupon, slider-timeline). Referencja.
Scene (scena) — warstwa-kontener z własną osią czasu. Przydatna do grupowania sub-animacji (np. odsłonięcie logo, które loopuje niezależnie) albo dla slajdów wewnątrz slidera.
Timeline (oś czasu) — dolny panel edytora. Steruje animacjami opartymi o keyframe’y na każdej warstwie — playhead, scrubber, presety, operacje na pasmach.
Trigger (wyzwalacz) — reguła decydująca kiedy popup odpala dla odwiedzającego: natychmiast, po N sekundach albo przy N% scrolla.
Targeting — reguły decydujące kto widzi scenę i gdzie: typy stron, wzorce URL, kanały sprzedaży, grupy klientów, reguły, kategorie, produkty, producenci, product streamy, strony CMS.
Frequency (częstotliwość) — jak często ten sam odwiedzający widzi scenę ponownie: raz na sesję, raz na N dni, zawsze, albo do momentu trwałego odrzucenia.
Display variant (wariant wyświetlania) — dla scen popup, preset pozycjonowania (modal, banner top/bottom, slide-in left/right, toast top-right/top-left/bottom-right/bottom-left).

Jak scena trafia do odwiedzającego

Budujesz scenę w adminie (Marketing → Stages → Add stage).
Przypisujesz targetowanie i trigger / częstotliwość.
Ładuje się strona storefrontu. Plugin’owy hook footera wstrzykuje ukryty kontener kontekstu z aktualnym typem strony / ID.
Browser JS strzela /p2lab-stage/resolve, backend zwraca każdą kwalifikującą się scenę jako pre-renderowany HTML + metadane triggera.
Klient planuje każdą scenę zgodnie z jej triggerem, montuje ją gdy się wyzwala, rejestruje event impression i respektuje suppression częstotliwości przy kolejnych ładowaniach.

Slidery osadzone w stronach CMS renderują się server-side jako część zwykłego pipeline’u sekcji CMS; popupy renderują się client-side przez endpoint resolve.

Gdzie dalej

Zainstaluj i skonfiguruj plugin — Instalacja.
Przejdź end-to-end przez tworzenie pierwszej sceny — Twoja pierwsza scena.
Przejrzyj edytor zanim zaczniesz budować — Edytor — przegląd.