Twój pierwszy film

Ten przewodnik dodaje pierwszy film do produktu. Osadzimy film z YouTube — ten sam flow działa dla Vimeo, TikTok, Dailymotion, Facebook, Gcore i bezpośrednich URL-i.

Zanim zaczniesz

• Plugin jest zainstalowany i aktywowany (Instalacja).
• Masz produkt do testów.

Krok 1 — Otwórz zakładkę mediów produktu

1. Przejdź do Catalogue → Products i otwórz dowolny produkt.
2. Przełącz się na zakładkę Media.

Override Product Video rozszerza prawy panel każdego wpisu mediów o trzy zakładki:

• File — standardowa referencja medium Shopware
• Video — konfiguracja wideo HTML5
• Embed Video — zewnętrzny URL filmu (YouTube, Vimeo itp.)

Wypełniasz albo Video (dla wgranego pliku), albo Embed Video (dla URL-a).

Krok 2 — Wklej URL z YouTube

1. Kliknij Add file albo Add from media library, żeby utworzyć wpis mediów, następnie zaznacz go.
2. W prawym panelu znajdź kartę Embed Video.
3. Kliknij Add i wklej URL z YouTube (https://www.youtube.com/watch?v=... albo krótki youtu.be/…).
4. Plugin rozpoznaje URL jako YouTube i automatycznie pobiera miniaturę.

Krok 3 — Ustaw opcje odtwarzania

Otwórz zakładkę Settings wewnątrz wpisu mediów, żeby skonfigurować opcje per wideo:

• Mark video as cover — zastąp cover w listingu produktów tym filmem
• Autoplay, Muted, Loop, Controls, Play inline, Keyboard
• Start video at / End video at — przycinanie zakresu odtwarzania
• Theme — wybierz jeden z ośmiu motywów odtwarzacza YouTube
• Use default settings — wróć do globalnych wartości domyślnych

Wartości domyślne dla nowych wpisów pochodzą z Settings → System → System Config → Product videos → YouTube settings. Możesz je nadpisać per wideo tutaj.

Krok 4 — Zapisz i podejrzyj

• Zapisz produkt.
• Otwórz go w storefroncie — film pojawia się w galerii z nakładką play.
• Kliknij nakładkę play. Jeśli tryb RODO jest włączony, najpierw zobaczysz prompt zgody na cookies; w przeciwnym razie iframe YouTube ładuje się i odtwarza.

Co się stało pod maską

• Plugin zapisał twoje metadane wideo (type, url, source, opcje odtwarzania) wewnątrz customFields.p2labProductVideo na wierszu product_media.
• Storefrontowe szablony Twig (product-video.html.twig oraz overrides galerii) wykrywają metadane Product Video i renderują odtwarzacz wideo zamiast zwykłego obrazu.
• Jeśli tryb RODO jest włączony (Do not require cookies accept = off), iframe jest blokowany za nakładką zgody na cookies.

Następne kroki

• Dodaj więcej filmów i ustaw ich kolejność w galerii.
• Wypróbuj lokalne wideo HTML5 (Wideo lokalne) zamiast osadzenia.
• Wstaw blok P2Lab Video Player na stronę Shopping Experience (Shopping Experiences).
• Skonfiguruj inny theme odtwarzacza dla YouTube (Motywy YouTube).