PS PrestaShop PrestaShop Iniciante

DataFirefly Product Video

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

Atualizado Versão do módulo 1.0.0

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.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte