DataFirefly Product Video

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.