DataFirefly Product Video
Instrukcja DataFirefly Product Video 2.0.0: wideo MP4, WebM, YouTube i Vimeo w galerii produktu PrestaShop 1.7.8, 8 i 9.
Przegląd
DataFirefly Product Video dodaje wideo MP4, WebM, YouTube i Vimeo do galerii zdjęć na stronie produktu, obok fotografii, z plakietką „Wideo” na miniaturze. Odtwarzacze YouTube i Vimeo ładują się dopiero po kliknięciu, a gdy działa menedżer cookies, po zgodzie odwiedzającego.
- Zgodność: PrestaShop od 1.7.8 do 9 (sprawdzone na 1.7.8.11, 8.2.1 i 9.1.5), PHP od 7.4 do 8.5.
- Motywy: wbudowane w galerie Hummingbird i Classic; inne motywy: pasek wideo pod galerią.
- Wielojęzyczność (tytuły, opisy i napisy w każdym języku) i multisklep (wideo przypisane do sklepów).
- Wersja: 2.0.0.

Instalacja i aktualizacja
- W Moduły > Menedżer modułów kliknij Prześlij moduł i wyślij
dfproductvideo-2.0.0.zip. - Moduł tworzy swoje tabele i chroniony katalog
img/dfproductvideo/(videos,posters,subtitles). - Otwórz Konfiguruj, aby sprawdzić ustawienia i zakładkę Diagnostyka.
Z wersji 1.0.0: prześlij zip 2.0.0 na istniejącą wersję. Wszystkie wideo i pliki zostają zachowane. Każdy plik jest ponownie sprawdzany pod kątem zawartości: plik, który nie jest prawdziwym wideo (na przykład skrypt ze zmienioną nazwą na .mp4, akceptowany przez 1.0.0), zostaje ukryty w sklepie i zgłoszony, nigdy usunięty; plakat, który nie jest obrazem, zostaje odłączony od wideo, ale pozostaje na serwerze. Ramka na stronie modułu wymienia te elementy.
Dodawanie wideo do produktu
Otwórz stronę produktu, zakładkę Moduły, a następnie DataFirefly Product Video. Wideo produktu są wyświetlane z plakatem, czasem trwania, miejscem, językami napisów i liczbą odtworzeń. Zmieniaj kolejność przeciąganiem lub klawiaturą (Tab do uchwytu, potem Alt + ↑ / ↓).

Plik MP4 lub WebM
Upuść plik lub kliknij Wybierz plik. Pokazany limit to najniższa wartość spośród ustawienia modułu, upload_max_filesize i post_max_size. Czas trwania i wymiary są odczytywane z pliku. Jako plakat prześlij obraz lub kliknij Użyj bieżącej klatki.

Zbyt duży plik zostaje odrzucony przed przesłaniem, z limitem serwera i ustawieniami php.ini do zmiany.

YouTube lub Vimeo
Wklej adres wideo i kliknij Sprawdź adres. Akceptowane są linki watch, youtu.be, shorts, embed i live ze znacznikiem czasu (t=1m30s), vimeo.com, player.vimeo.com oraz niepubliczne linki Vimeo z hashem. Dodaj plakat: jest serwowany przez Twój sklep, odwiedzający nie łączą się z YouTube ani Vimeo, aby go zobaczyć.

Tytuł, opis i napisy
Dla każdego języka: tytuł (odczytywany przez czytniki ekranu i używany w danych strukturalnych), opis i plik napisów WebVTT (.vtt). Domyślnie wyświetlane są napisy w języku strony.

Miejsce, kombinacje i odtwarzanie
- Miejsce: przed obrazami, po obrazie n lub po obrazach.
- Otwórz galerię na tym wideo: wideo zastępuje zdjęcie główne (jedno na produkt).
- Kombinacje: pozostaw puste dla wszystkich lub zaznacz te, które pokazują wideo.
- Autoodtwarzanie: zawsze wyciszone, nigdy dla odwiedzających, którzy wybrali ograniczenie ruchu; bez sterowania widoczny pozostaje przycisk pauzy.
Ustawienia modułu
Podgląd na żywo pokazuje plakietkę, przycisk odtwarzania i sposób otwierania przed zapisaniem.

- Galeria: odtwarzanie w galerii lub w lightboxie, domyślne miejsce, kolor, styl przycisku, plakietka i czas trwania, etykieta „Wideo” na miniaturach produktów, wideo w szybkim podglądzie.
- Odtwarzanie: wartości domyślne nowych wideo, pauza poza ekranem, ładowanie plików po kliknięciu (zalecane) lub metadanych.
- YouTube, Vimeo i zgoda:
youtube-nocookie.com, Vimeodnt=1, miniatury przechowywane w sklepie, informacja przed załadowaniem zewnętrznego odtwarzacza. - Dane strukturalne i statystyki:
VideoObject, licznik odtworzeń, okres przechowywania, limit godzinowy. - Przesyłanie: maksymalny rozmiar i akceptowane formaty.

Wszystkie wideo i statystyki
Zakładka Wszystkie wideo zawiera wideo z katalogu z wyszukiwaniem (produkt, indeks, tytuł, ID) i filtrami typu i statusu.

Zakładka Statystyki pokazuje odtworzenia dziennie, odsetek wideo obejrzanych do końca (MP4/WebM) i najczęściej odtwarzane wideo z 7, 30, 90 lub 365 dni. Statystyki są anonimowe: bez cookie, bez adresu IP, bez danych klienta. Odtworzenie jest liczone raz na wideo i na wyświetlenie strony, znane boty są pomijane. Przycisk Wyczyść usuwa liczniki.

W sklepie
Kliknięcie miniatury odtwarza wideo w galerii z napisami.

W przypadku YouTube i Vimeo przed kliknięciem do dostawcy nie trafia żadne żądanie. Bez menedżera cookies krótki komunikat podaje dostawcę przed załadowaniem jego odtwarzacza.

Z banerem tarteaucitron od DataFirefly odtwarzacz czeka na zgodę na usługę YouTube lub Vimeo; przycisk Zezwól na YouTube i odtwórz zapisuje wybór w banerze.

Przycisk powiększenia motywu otwiera wideo w lightboxie, ze strzałkami i przesuwaniem między wideo.

Główne wideo z autoodtwarzaniem startuje bez dźwięku i ma przycisk pauzy.

Na telefonie wideo są slajdami karuzeli, dostępnymi przesunięciem palcem.

Etykieta „Wideo” pojawia się na miniaturach produktów, a wideo są dostępne w szybkim podglądzie.


Dane strukturalne
Każde wideo z plakatem jest publikowane jako VideoObject w nagłówku strony produktu: name, description, thumbnailUrl, uploadDate, duration oraz contentUrl (plik) lub embedUrl (YouTube, Vimeo). Moduł DataFirefly All in One SEO nie publikuje VideoObject: nie ma duplikatu.
Bezpieczeństwo i diagnostyka
Wideo są sprawdzane pod kątem zawartości, plakaty ponownie kodowane, napisy oczyszczane, a wszystkie pliki otrzymują losowe nazwy. Katalog img/dfproductvideo/ jest chroniony przez .htaccess: żaden skrypt nie może się w nim uruchomić. Nginx ignoruje te pliki: skopiuj reguły z zakładki Diagnostyka do bloku server sklepu.

Rozwiązywanie problemów
- „Plik przekracza limit serwera”: zwiększ
upload_max_filesizeipost_max_size(nieco wyżej) wphp.ini, a potem limit modułu. - Zmiana nie jest widoczna w sklepie: wyczyść pamięć podręczną PrestaShop (Zaawansowane > Wydajność), zwłaszcza przy włączonej kompresji CSS/JS.
- Wideo „Nieprawidłowy plik” po aktualizacji: plik z 1.0.0 nie jest prawdziwym wideo; zastąp go w zakładce produktu.
- Vimeo „nie znaleziono lub prywatne”: dla niepublicznego wideo wklej pełny adres z hashem.
- Brak liczonych odtworzeń: przy pamięci podręcznej całych stron liczeni są tylko odwiedzający, którzy otrzymują świeżą stronę.
Odinstalowanie
Odinstalowanie usuwa wszystkie wideo produktów, ich pliki (img/dfproductvideo), statystyki i ustawienia.
Historia wersji
- 2.0.0: PrestaShop od 1.7.8 do 9, Hummingbird, WebM, napisy WebVTT, kontrola plików po zawartości, fasada YouTube/Vimeo i zgoda, dostępny lightbox, wideo dla kombinacji, szybki podgląd,
VideoObject, anonimowe statystyki, lista globalna, diagnostyka, 8 języków, aktualizacja z 1.0.0. - 1.0.0: pierwsza wersja (PrestaShop 8).