# DataFirefly Product Video: volledige gids

> Gebruikersgids voor de module DataFirefly Product Video: video's toevoegen (MP4, YouTube, Vimeo) in de PrestaShop-productgalerij.

- Pagina: <https://www.datafirefly.com/nl/documentation/dfproductvideo/>
- Taal: nl
- Bijgewerkt op: 2026-09-16
- Andere talen: [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), [pl](https://www.datafirefly.com/pl/documentation/dfproductvideo/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfproductvideo/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## Overzicht

**DataFirefly Product Video** voegt video's direct toe aan de miniaturengalerij van de PrestaShop-productpagina, naast de afbeeldingen. Drie bronnen worden ondersteund: gehoste bestanden (MP4, WebM, OGG), **YouTube** en **Vimeo**. Elke video heeft zijn eigen poster, zijn eigen afspeelopties en een aanpasbare positie.

- Compatibiliteit: PrestaShop 8.0 tot 8.9
- Multistore: ja
- Meertalig: titel en beschrijving per taal vertaalbaar
- Versie: 1.0.0

## Installatie

1. Ga in de back-office naar _Modules > Module Manager_.
2. Klik op _Een module uploaden_ en selecteer het bestand `dfproductvideo.zip`.
3. De module maakt automatisch haar tabellen en de uploadmappen aan (`img/dfproductvideo/videos` en `img/dfproductvideo/posters`).
4. Klik op _Configureren_ om de standaardinstellingen te definiëren.

## Globale configuratie

De configuratiepagina definieert de waarden die standaard op elke nieuwe video worden toegepast:

- **Autoplay** — automatisch afspelen (de gedempte modus is vereist door Chrome en Safari).
- **Gedempt** — verplicht als autoplay is ingeschakeld.
- **Lus** — speelt de video continu opnieuw af.
- **Bedieningselementen tonen** — native afspeelbalk.
- **Lazy load** — laadt de video pas wanneer ze zichtbaar wordt.
- **Lightbox / Volledig scherm** — opening van de video in een overlay.
- **Responsive** — aanpassing aan de schermbreedte.
- **Analytics** — telling van het aantal weergaven per video.
- **Max. bestandsgrootte (MB)** — uploadlimiet, standaard 50 MB.
- **Toegestane extensies** — standaard `mp4,webm,ogg`.
- **Kleur en achtergrond van het Play-icoon** — personalisatie van de afspeelknop.

## Een video aan een product toevoegen

1. Open een productpagina in de back-office.
2. Ga naar het door de module toegevoegde tabblad **Video's**.
3. Kies de bron: te uploaden bestand, YouTube-link of Vimeo-link.
4. Vul zo nodig een **poster** (omslagafbeelding) en een **titel / beschrijving** per taal in.
5. Pas de afspeelopties aan (autoplay, gedempt, lus, bediening) als ze afwijken van de standaardwaarden.
6. Sla op. De video verschijnt in de galerij van het product.

De video's kunnen via slepen en neerzetten worden herordend, in- of uitgeschakeld, en één ervan kan als **omslagvideo** worden aangewezen (één per product en per winkel).

## Automatische posters

Wordt geen poster aangeleverd, dan genereert de module automatisch een voorbeeldafbeelding: de YouTube-miniatuur (`hqdefault`) voor YouTube-video's, en de Vimeo-thumbnail voor Vimeo-video's. Voor geüploade bestanden wordt aanbevolen handmatig een poster te leveren.

## Weergave in de front-office

De video's worden in de miniaturengalerij van de productpagina ingevoegd, direct na de afbeeldingen. Bij een klik speelt de video ter plekke af of opent ze in een lightbox, afhankelijk van de configuratie. Geüploade video's gebruiken de native HTML5-speler; YouTube en Vimeo worden geïntegreerd via hun officiële speler met de parameters die overeenkomen met de gekozen opties (autoplay, gedempt, lus, bediening).

## Analytics

Wanneer de Analytics-optie actief is, verhoogt elke weergave een teller (`play_count`) die in de database wordt opgeslagen. Zo meet u de videobetrokkenheid per product.

## Deïnstallatie

Het deïnstalleren verwijdert de tabellen van de module en haar instellingen. De videobestanden en posters die aan de producten zijn gekoppeld, worden eveneens opgeschoond.

## Technische details

- Tabellen: `dfproductvideo` (video's en opties) en `dfproductvideo_lang` (vertaalde titel / beschrijving).
- Gebruikte hooks: `displayAdminProductsExtra`, `displayAfterProductThumbs`, `actionFrontControllerSetMedia`, `actionProductUpdate`, `actionProductDelete`, `displayBackOfficeHeader`.
- Videobeheer via AJAX-controller (opslaan, verwijderen, herordenen, activeren).
- Weergavetracking via een aparte frontcontroller.