# DataFirefly Product Video

> Instrukcja obsługi modułu DataFirefly Product Video: dodawanie filmów (MP4, YouTube, Vimeo) do galerii produktu w PrestaShop.

- Strona: <https://www.datafirefly.com/pl/documentation/dfproductvideo/>
- Język: pl
- Zaktualizowano: 2026-08-05
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfproductvideo/index.md), [en](https://www.datafirefly.com/en/documentation/dfproductvideo/index.md), [es](https://www.datafirefly.com/es/documentation/dfproductvideo/index.md), [de](https://www.datafirefly.com/de/documentation/dfproductvideo/index.md), [it](https://www.datafirefly.com/it/documentation/dfproductvideo/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfproductvideo/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfproductvideo/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Prezentacja

**DataFirefly Product Video** dodaje filmy bezpośrednio do galerii miniatur na karcie produktu PrestaShop, obok zdjęć. Obsługiwane są trzy źródła: pliki hostowane (MP4, WebM, OGG), **YouTube** oraz **Vimeo**. Każdy film ma własny poster, własne opcje odtwarzania i konfigurowalną pozycję.

- Kompatybilność: PrestaShop 8.0 do 8.9
- Multisklep: tak
- Wielojęzyczność: tytuł i opis tłumaczone dla każdego języka
- Wersja: 1.0.0

## Instalacja

1. W panelu administracyjnym przejdź do _Moduły > Menedżer modułów_.
2. Kliknij _Załaduj moduł_ i wybierz plik `dfproductvideo.zip`.
3. Moduł automatycznie tworzy swoje tabele oraz katalogi uploadu (`img/dfproductvideo/videos` i `img/dfproductvideo/posters`).
4. Kliknij _Konfiguruj_, aby ustawić wartości domyślne.

## Konfiguracja globalna

Strona konfiguracji określa wartości stosowane domyślnie do każdego nowego filmu:

- **Autoplay**: automatyczne odtwarzanie (tryb wyciszony jest wymagany przez Chrome i Safari).
- **Wyciszenie**: obowiązkowe, gdy autoplay jest włączony.
- **Pętla**: odtwarza film w sposób ciągły.
- **Pokaż kontrolki**: natywny pasek odtwarzania.
- **Leniwe ładowanie (lazy load)**: ładuje film dopiero, gdy staje się widoczny.
- **Lightbox / Pełny ekran**: otwieranie filmu w nakładce.
- **Responsywność**: dopasowanie do szerokości ekranu.
- **Analityka**: zliczanie liczby odtworzeń każdego filmu.
- **Maks. rozmiar pliku (MB)**: limit uploadu, domyślnie 50 MB.
- **Dozwolone rozszerzenia**: domyślnie `mp4,webm,ogg`.
- **Kolor i tło ikony Play**: personalizacja przycisku odtwarzania.

## Dodawanie filmu do produktu

1. Otwórz kartę produktu w panelu administracyjnym.
2. Przejdź do zakładki **Filmy** dodanej przez moduł.
3. Wybierz źródło: plik do przesłania, link YouTube lub link Vimeo.
4. W razie potrzeby dodaj **poster** (obraz okładki) oraz **tytuł / opis** dla każdego języka.
5. Dostosuj opcje odtwarzania (autoplay, wyciszenie, pętla, kontrolki), jeśli różnią się od wartości domyślnych.
6. Zapisz. Film pojawi się w galerii produktu.

Filmy można zmieniać kolejnością metodą przeciągnij i upuść, włączać lub wyłączać, a jeden z nich można oznaczyć jako **film okładkowy** (tylko jeden na produkt i na sklep).

## Automatyczne postery

Jeśli poster nie został dodany, moduł automatycznie generuje obraz podglądu: miniaturę YouTube (`hqdefault`) dla filmów z YouTube oraz miniaturę Vimeo dla filmów z Vimeo. W przypadku plików przesyłanych ręcznie zalecane jest dodanie własnego postera.

## Wyświetlanie w sklepie

Filmy pojawiają się w galerii miniatur na karcie produktu, zaraz po zdjęciach. Po kliknięciu film odtwarza się w miejscu lub otwiera w lightboksie, zależnie od konfiguracji. Przesłane pliki korzystają z natywnego odtwarzacza HTML5; YouTube i Vimeo są osadzane przez ich oficjalne odtwarzacze z parametrami odpowiadającymi wybranym opcjom (autoplay, wyciszenie, pętla, kontrolki).

## Analityka

Gdy opcja Analityka jest aktywna, każde odtworzenie zwiększa licznik (`play_count`) zapisywany w bazie danych. Pozwala to mierzyć zaangażowanie wideo dla każdego produktu.

## Odinstalowanie

Odinstalowanie usuwa tabele modułu oraz jego ustawienia. Pliki wideo i postery powiązane z produktami również są czyszczone.

## Szczegóły techniczne

- Tabele: `dfproductvideo` (filmy i opcje) oraz `dfproductvideo_lang` (tłumaczone tytuły / opisy).
- Używane hooki: `displayAdminProductsExtra`, `displayAfterProductThumbs`, `actionFrontControllerSetMedia`, `actionProductUpdate`, `actionProductDelete`, `displayBackOfficeHeader`.
- Zarządzanie filmami przez kontroler AJAX (zapis, usuwanie, zmiana kolejności, aktywacja).
- Śledzenie odtworzeń przez dedykowany kontroler front.