# DataFirefly Product Video

> Guia de utilização do módulo DataFirefly Product Video: acrescentar vídeos (MP4, YouTube, Vimeo) à galeria de produto do PrestaShop.

- Página: <https://www.datafirefly.com/pt/documentation/dfproductvideo/>
- Idioma: pt
- Atualizado em: 2026-09-09
- Outros idiomas: [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), [nl](https://www.datafirefly.com/nl/documentation/dfproductvideo/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O **DataFirefly Product Video** acrescenta vídeos diretamente à galeria de miniaturas da ficha de produto do PrestaShop, ao lado das imagens. São suportadas três origens: ficheiros alojados (MP4, WebM, OGG), **YouTube** e **Vimeo**. Cada vídeo tem o seu póster, as suas opções de reprodução e uma posição personalizável.

- Compatibilidade: PrestaShop 8.0 a 8.9
- Multiloja: sim
- Multi-idioma: título e descrição traduzíveis por idioma
- Versão: 1.0.0

## Instalação

1. No back-office, vá a _Módulos > Gestor de módulos_.
2. Clique em _Carregar um módulo_ e selecione o ficheiro `dfproductvideo.zip`.
3. O módulo cria automaticamente as suas tabelas e as pastas de carregamento (`img/dfproductvideo/videos` e `img/dfproductvideo/posters`).
4. Clique em _Configurar_ para definir as predefinições.

## Configuração global

A página de configuração define os valores aplicados por predefinição a cada novo vídeo:

- **Reprodução automática**: leitura automática (o modo sem som é exigido pelo Chrome e pelo Safari).
- **Sem som**: obrigatório se a reprodução automática estiver ativa.
- **Repetição**: reproduz o vídeo continuamente.
- **Mostrar os controlos**: barra de reprodução nativa.
- **Carregamento diferido (lazy load)**: carrega o vídeo apenas quando fica visível.
- **Lightbox / Ecrã inteiro**: abertura do vídeo em sobreposição.
- **Responsivo**: adaptação à largura do ecrã.
- **Estatísticas**: contagem do número de reproduções por vídeo.
- **Tamanho máximo do ficheiro (MB)**: limite de carregamento, 50 MB por predefinição.
- **Extensões permitidas**: por predefinição, `mp4,webm,ogg`.
- **Cor e fundo do ícone de reprodução**: personalização do botão de leitura.

## Acrescentar um vídeo a um produto

1. Abra uma ficha de produto no back-office.
2. Vá ao separador **Vídeos**, acrescentado pelo módulo.
3. Escolha a origem: ficheiro a carregar, ligação do YouTube ou ligação do Vimeo.
4. Se for preciso, indique um **póster** (imagem de capa) e um **título e descrição** por idioma.
5. Ajuste as opções de reprodução (automática, sem som, repetição, controlos) se diferirem das predefinições.
6. Grave. O vídeo aparece na galeria do produto.

Os vídeos podem ser reordenados por arrastamento, ativados ou desativados, e um deles pode ser designado como **vídeo de capa** (apenas um por produto e por loja).

Preencha o título e a descrição em português: são campos por idioma e servem de texto alternativo para quem não reproduz o vídeo, além de darem contexto ao motor de pesquisa. Se o vídeo tiver locução ou texto no ecrã noutra língua, uma descrição em português por baixo compensa em parte essa barreira.

## Pósteres automáticos

Se não fornecer um póster, o módulo gera automaticamente uma imagem de pré-visualização: a miniatura do YouTube (`hqdefault`) nos vídeos do YouTube e a miniatura do Vimeo nos vídeos do Vimeo. Nos ficheiros carregados, é recomendável fornecer um póster manualmente.

## Apresentação no front-office

Os vídeos inserem-se na galeria de miniaturas da ficha de produto, logo a seguir às imagens. Ao clicar, o vídeo é reproduzido no lugar ou abre em lightbox, consoante a configuração. Os vídeos carregados usam o leitor HTML5 nativo; o YouTube e o Vimeo são integrados através do respetivo leitor oficial, com os parâmetros correspondentes às opções escolhidas (reprodução automática, sem som, repetição, controlos).

Um vídeo do YouTube ou do Vimeo é incorporado a partir do servidor deles: deposita cookies e transmite o endereço IP do visitante logo no carregamento da página. Em Portugal, a Lei n.º 41/2004 exige consentimento prévio para esse depósito, e o fornecedor é um subcontratante a inscrever no seu registo de atividades de tratamento, sob supervisão da CNPD. Duas formas de resolver: ligar a incorporação à sua plataforma de consentimento, ou alojar o ficheiro MP4 no seu servidor, caso em que não há cookies nem transmissão de dados. O carregamento diferido reduz o problema mas não o elimina, porque o pedido acaba por ser feito.

## Estatísticas

Com a opção de estatísticas ativa, cada reprodução incrementa um contador (`play_count`) guardado na base de dados. Isso permite medir o envolvimento com o vídeo, produto a produto.

## Desinstalação

A desinstalação elimina as tabelas do módulo e as suas definições. Os ficheiros de vídeo e os pósteres associados aos produtos são igualmente limpos.

## Pormenores técnicos

- Tabelas: `dfproductvideo` (vídeos e opções) e `dfproductvideo_lang` (título e descrição traduzidos).
- Hooks utilizados: `displayAdminProductsExtra`, `displayAfterProductThumbs`, `actionFrontControllerSetMedia`, `actionProductUpdate`, `actionProductDelete` e `displayBackOfficeHeader`.
- Gestão dos vídeos por controlador AJAX (gravação, eliminação, reordenação, ativação).
- Seguimento das reproduções por um controlador de front-office dedicado.