Szablony

Szablony to gotowe sceny, których możesz używać jako punktów wyjścia. Plugin oferuje garść wbudowanych szablonów (obecnie startery typu slider) i pozwala zapisać dowolną z twoich scen jako własny szablon do ponownego użycia. Własne szablony są zapisywane w twoim sklepie i można ich używać wielokrotnie; aplikowanie szablonu regeneruje UUID-y, więc powstała scena jest całkowicie niezależna od źródła.

Przeglądanie szablonów

Z modala Add stage kliknij Browse templates…. Otwiera się browser szablonów z trzema rzeczami per szablon:

• Preview — miniaturka sceny.
• Name — wyświetlana nazwa.
• Built-in badge — jeśli przyszedł z pluginem (np. rotating-cans, studio-edit, editorial-spotlight). Wbudowanych nie można usuwać.

Wybierz szablon, skonfiguruj parametry (zobacz niżej), kliknij Use template. Nowa scena jest tworzona i lądujesz w jej edytorze.

Parametry szablonu

Gdy aplikujesz szablon, modal oferuje parametry, które zostaną wpieczone w nową scenę:

• Stage name — jak nazwać nową scenę (np. Spring Sale Hero).
• Custom width (px) / Custom height (px) (opcjonalnie) — nadpisz natywne wymiary płótna szablonu. Gdy ustawione i różne od szablonu, pozycje warstw i keyframe’y są przeskalowywane proporcjonalnie.
• Slide count (tylko szablony slider) — liczba slajdów. Poniżej natywnej liczby szablonu dodatkowe slajdy są ucinane; powyżej — dodatkowe slajdy są klonowane z istniejących, żeby sąsiednie slajdy się nie powtarzały.
• Slide duration (s) (tylko szablony slider) — sekundy per slajd. Zalecane 5–7 s, żeby odwiedzający przeczytał nagłówek; dłużej dla slajdów bogatych w treść. Minimum 2 s. Sceny z markerami intro / outro rozciągają sekcję środkową (loop) zachowując intro / outro nietknięte; bez markerów keyframe’y skalują się proporcjonalnie.

Kliknij Use template, żeby zastosować. Zobaczysz toast: Stage created from template.

Zapisywanie sceny jako szablon

W toolbarze edytora kliknij Save as template…. Wypełnij:

• Template name — wymagane, musi być unikalne. Jeśli nazwa się powiela, dostajesz “A template with this name already exists. Please choose a different name.”

Kliknij Save template, żeby zapisać. Przyszłe flow tworzenia pokazują ten szablon w Browse templates. Toast potwierdza Template saved.

Snapshot przechwytuje bieżący stan sceny — warstwy, sceny, slajdy, animacje, ustawienia — jako JSON payload. Nie zawiera powiązań targetowania / trigger / frequency / schedule / audience sceny (te należą do sceny, nie do designu szablonu).

Usuwanie własnego szablonu

W browserze szablonów własne szablony mają akcję Delete template (wbudowane nie). Prompt potwierdzenia: “Delete template ‘<name>’? This cannot be undone.”

Wbudowane szablony

Plugin ships przynajmniej z tymi starterami slider (ładowanymi z dysku spod src/Resources/templates/<type>/):

• rotating-cans — animowany karuzel produktowych puszek.
• studio-edit — układ edytorial.
• editorial-spotlight — sfokusowany product spotlight.

Wszystkie trzy są typu slider. Wbudowane typu popup mogą zostać dodane z czasem — sprawdź w browserze co faktycznie jest obecne w twojej instalacji.

Jak działa apply()

Pod maską krok apply:

1. Ładuje zapisany szablon (albo źródło wbudowane z dysku).
2. Generuje świeże UUID-y dla sceny, każdej warstwy, każdego keyframe’a, każdego slajdu, każdego M:N pivot.
3. Resolwuje referencje media — jeśli nazwa pliku media nadal istnieje w bibliotece, jest reużywana; brakujące referencje są pomijane z warningiem.
4. Opcjonalnie przeskalowuje pozycje warstw + keyframe’ów, jeśli ustawisz Custom width / height.
5. Opcjonalnie ucina / klonuje slajdy, jeśli ustawisz Slide count.
6. Zapisuje nową scenę i przekierowuje do jej edytora.

Powstała scena nie ma linka z powrotem do szablonu — edytowanie jej nie zmienia szablonu.

Gdzie dalej

• Drafty i wersje — autozapis / snapshot / restore wewnątrz sceny (ortogonalne do szablonów).
• Stages → Slider — config playback dla szablonów slider.
• Layers — co faktycznie jest wewnątrz szablonu.