PS PrestaShop PrestaShop Intermédio

DataFirefly Live Shopping: guia completo

Instalar, configurar e animar vendas em direto: vídeo nativo (HLS / MP4 / embed), Estúdio em tempo real, ofertas relâmpago, chat e carrinho nativo para PrestaShop 8 e 9.

Atualizado Versão do módulo 1.0.0

Apresentação

O módulo DataFirefly Live Shopping (dflive) transforma a sua loja PrestaShop numa plataforma de venda por vídeo em direto. Difunde um live, fixa produtos em tempo real, lança ofertas relâmpago, os seus clientes adicionam ao carrinho sem sair da emissão, e a sessão fica acessível em replay. Tudo funciona na sua loja: nenhuma plataforma de live shopping de terceiros, nenhuma subscrição recorrente.

Três pilares: um vídeo nativo (HLS, MP4 ou embed), um Estúdio em tempo real integrado no back-office para comandar o live, e uma camada de shopping (fixação de produto, ofertas relâmpago, carrinho nativo, chat, reações, prova social).

Adaptação para Portugal: o módulo é entregue com 5 idiomas (FR, EN, ES, DE, IT). O português não está incluído: traduza as cadeias do módulo em Internacional → Traduções (tipo «Módulos instalados») antes do primeiro live, caso contrário a interface do espetador e do chat aparecerá em inglês.

Compatibilidade

  • PrestaShop 8.0 a 9.x
  • PHP 7.4 a 8.3
  • Loja única e multiloja
  • Multilingue (5 idiomas incluídos: FR, EN, ES, DE, IT)
  • Nenhuma dependência (nem Composer nem framework); o hls.js vem incluído no módulo
  • Compatível com alojamento partilhado (sincronização por polling AJAX, sem WebSocket nem SFU)

Pré-requisitos

O módulo gere a reprodução do vídeo e toda a camada de shopping, mas é a loja que fornece a fonte de vídeo. Consoante o modo escolhido:

  • HLS: um fluxo .m3u8 servido pelo seu próprio servidor HLS, pelo Mux ou pelo Cloudflare Stream, alimentado por um codificador como o OBS.
  • MP4: um URL que aponta para um ficheiro .mp4 acessível publicamente.
  • Embed: um live YouTube, Twitch ou Vimeo (URL ou código de incorporação).

Recomenda-se HTTPS: a reprodução automática e o ecrã inteiro comportam-se melhor numa loja servida em HTTPS, o que já é o caso da quase totalidade das lojas em produção.

Instalação

  1. No back-office, abra Módulos > Gestor de módulos.
  2. Clique em Instalar um módulo e selecione o ficheiro dflive.zip.
  3. Uma vez instalado, abra o menu Vender > Live Shopping.

Na instalação, o módulo cria as suas tabelas (sessões, produtos de sessão, mensagens, eventos, presença, lembretes), regista os separadores em Vender, adiciona as rotas /live e /live/{id}-{slug} e ativa o widget da página inicial.

Criar um live

A partir de Vender > Live Shopping, clique em Adicionar. O formulário está organizado em separadores:

Geral

  • Título e descrição do live (multilingue).
  • Apresentador: nome apresentado como anfitrião no chat e por baixo do vídeo.
  • Data programada: aciona a contagem decrescente do lado do espetador.
  • Estado: programado, em direto ou terminado.
  • Imagem de capa: apresentada antes do live e nas listas.

Vídeo

  • Tipo de vídeo: HLS, MP4 ou embed.
  • Fonte de vídeo: o URL .m3u8, o URL .mp4 ou o URL / código embed consoante o tipo.
  • URL de replay (opcional): por exemplo a gravação VOD do seu servidor HLS, servida depois do live.

Produtos

Associe os produtos que serão apresentados durante o live com o seletor de pesquisa AJAX. Esses produtos alimentam o carrossel do lado do espetador e passam a poder ser fixados a partir do Estúdio.

Opções e SEO

Ative ou não o chat, o chat de convidados, as reações e a prova social para esta sessão, e preencha o título e a descrição SEO da página do live.

Difundir o fluxo

Para um live em HLS, o princípio é o seguinte:

  1. Configure o seu codificador (OBS, por exemplo) para difundir para o seu servidor HLS, Mux ou Cloudflare Stream.
  2. Obtenha o URL .m3u8 de saída e cole-o no campo Fonte de vídeo da sessão.
  3. Inicie a difusão a partir do seu codificador, abra depois o Estúdio e clique em Iniciar o live.

O módulo não o prende a nenhuma infraestrutura: escolhe a sua cadeia de difusão (auto-alojada ou na cloud) e cola simplesmente o URL. Para um teste rápido, basta um ficheiro MP4 ou um embed YouTube / Twitch.

O Estúdio (régie)

O Estúdio é a sala de controlo integrada no back-office. Abra-o a partir do botão Estúdio da lista de lives.

  • Iniciar / Terminar o live: alterna o estado da sessão. No fim, as ofertas relâmpago em curso são automaticamente limpas.
  • Fixar um produto: o seu cartão aparece imediatamente em sobreposição para os espetadores. Fixar um produto desafixa automaticamente o anterior.
  • Oferta relâmpago: introduza um desconto (por exemplo 20% ou 10€). O módulo cria um SpecificPrice no momento e o preço recalculado aparece instantaneamente do lado dos espetadores. O botão dedicado permite parar a oferta.
  • Anúncio: difunde uma mensagem do anfitrião fixada no chat.
  • Moderação: ocultar, mostrar ou fixar qualquer mensagem do chat.
  • Estatísticas em direto: número de espetadores e de reações em tempo real.

O Estúdio envia eventos (fixação, oferta, anúncio, mudança de estado) que são recolhidos pelos espetadores no ciclo de polling seguinte. O intervalo é configurável nas definições do módulo.

Do lado do espetador

A página de um live (/live/{id}-{slug}) apresenta:

  • O leitor de vídeo com uma faixa «EM DIRETO» e o número de espetadores.
  • O cartão do produto fixado em sobreposição, com botão de adicionar ao carrinho.
  • O carrossel de produtos do live, cada um adicionável ao carrinho nativo do PrestaShop com um clique.
  • O chat (clientes e, se ativo, convidados) com anti-flood, mensagens do anfitrião e reações de corações animadas.
  • Os toasts de prova social «Alguém acabou de adicionar…» aquando das adições ao carrinho.

Para uma sessão programada, o espetador vê uma contagem decrescente e pode inscrever-se por e-mail para ser avisado do início. Depois do live, a sessão passa a replay e continua acessível.

Definições do módulo

A página de configuração reúne as definições globais, nomeadamente:

  • Intervalo de polling (3 000 ms por defeito): frequência de atualização do chat e dos eventos.
  • Chat ativo e chat de convidados: autoriza o chat e, se for o caso, a participação dos visitantes sem sessão iniciada.
  • Reações e prova social: ativa os corações e os toasts de adição ao carrinho.
  • Tempo de presença: duração a partir da qual um espetador inativo deixa de ser contado.
  • Comprimento máximo de uma mensagem e anti-flood: enquadram o chat.
  • Widget da página inicial e número de lives apresentados: comandam o bloco da página inicial.

Página de lista e widget da página inicial

A página /live lista os lives em curso, a decorrer em breve e os replays. O widget da página inicial destaca as sessões ativas e programadas, dentro do limite configurado.

FAQ e resolução de problemas

O vídeo não arranca

Verifique o tipo de vídeo e a fonte. Para um fluxo HLS, certifique-se de que o URL .m3u8 está acessível publicamente e que o seu codificador está a difundir. Para um embed, verifique que o URL YouTube, Twitch ou Vimeo é válido.

O preço da oferta relâmpago não muda para os espetadores

A oferta é aplicada através de um SpecificPrice criado no momento e propagada no ciclo de polling seguinte. Verifique o intervalo de polling e que a oferta não foi já parada. As ofertas em curso são limpas automaticamente no fim do live.

O chat não aparece ou recusa as minhas mensagens

Confirme que o chat está ativo para a sessão e globalmente. O chat de convidados tem de estar ativo para autorizar os visitantes sem sessão iniciada. O anti-flood impõe um intervalo mínimo entre duas mensagens.

A contagem decrescente não aparece

A contagem decrescente só aparece para as sessões com o estado programado cuja data está no futuro. Verifique o estado e a data programada.

O módulo funciona em alojamento partilhado?

Sim. A sincronização em tempo real usa polling AJAX, sem servidor WebSocket nem SFU, o que garante a compatibilidade com os alojamentos partilhados correntes.

Esta página foi útil?

Ainda com dúvidas? Contacte o suporte