# DataFirefly Venda Flash e Contagem Decrescente para Shopware 6: instalação, configuração e utilização

> Apresentação O DataFirefly Venda Flash e Contagem Decrescente transforma as suas promoções Shopware em vendas flash agendadas: o desconto é aplicado na hora por um processador de carrinho nativo, ativado…

- Página: <https://www.datafirefly.com/pt/documentation/dfflashsale-shopware/>
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfflashsale-shopware/index.md), [en](https://www.datafirefly.com/en/documentation/dfflashsale-shopware/index.md), [es](https://www.datafirefly.com/es/documentation/dfflashsale-shopware/index.md), [de](https://www.datafirefly.com/de/documentation/dfflashsale-shopware/index.md), [it](https://www.datafirefly.com/it/documentation/dfflashsale-shopware/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfflashsale-shopware/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfflashsale-shopware/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O DataFirefly Venda Flash e Contagem Decrescente transforma as suas promoções Shopware em vendas flash agendadas: o desconto é aplicado na hora por um processador de carrinho nativo, ativado e cortado ao segundo, sem CRON e sem alterar os dados dos seus produtos. O preço riscado aparece nativamente nas páginas de produto e nas listagens, e um banner fixo com contagem decrescente sincronizado com a hora do servidor cria a urgência.

## Pré-requisitos

- Shopware 6.5.x, 6.6.x ou 6.7.x (um único ZIP)
- PHP 8.1 no mínimo
- Sem CRON, sem Scheduled Task, sem build Node.js

## Instalação

### Pela administração

1. Extensões > As minhas extensões > **Carregar extensão**, e selecione o ficheiro `DfFlashSale-1.0.0.zip`.
2. Clique em **Instalar** e depois em **Ativar**.

### Por linha de comandos

```
bin/console plugin:refresh
bin/console plugin:install --activate DfFlashSale
bin/console assets:install
bin/console cache:clear
```

O JS de administração é entregue **pré-compilado**, incluindo para o novo carregador Vite do Shopware 6.7: nenhum `build-administration.sh` é necessário. Depois de `assets:install` e `cache:clear`, recarregue a administração com Ctrl+F5.

Se transferir a extensão por FTP, verifique que a pasta oculta `src/Resources/public/administration/.vite/` é mesmo copiada: alguns clientes FTP excluem os ficheiros que começam por um ponto. Sem ela, a entrada de menu não aparece no Shopware 6.7.

## Criar uma campanha

Vá a **Marketing > Vendas Flash > Criar uma venda flash**. Uma campanha configura-se em cinco blocos:

### Campanha

- **Nome interno**: visível apenas na administração.
- **Ativa**: interruptor geral da campanha.
- **Datas de início e de fim**: o desconto e o banner ativam-se e cortam-se automaticamente ao segundo, segundo a hora do servidor.

### Desconto

- **Tipo**: percentagem ou montante fixo.
- **Valor**: por exemplo 30 para 30 % de desconto, ou 10 para 10 € por unidade.

### Segmentação

- **Todo o catálogo**, **Categorias** (as subcategorias são incluídas automaticamente através da árvore de categorias) ou **Produtos selecionados** (as variantes de um produto principal selecionado ficam cobertas).
- **Canais de venda**: deixe vazio para todos os canais, ou restrinja a campanha a certos canais.

### Banner fixo

- **Âmbito**: todas as páginas (exceto o checkout), apenas a página inicial ou apenas as páginas de produto.
- **Posição**: topo ou fundo da página, com deslocamento automático do conteúdo.
- **Cores**: fundo, texto e destaque, por campanha.
- **Textos**: texto do banner, texto do teaser e mensagem de fim, traduzíveis através do seletor de idioma no topo da página.

### Contagem decrescente

- **Teaser**: antes do arranque, o banner apresenta o texto do teaser com uma contagem decrescente até ao lançamento, e depois a página recarrega automaticamente.
- **Fim de campanha**: oculte o banner ou apresente a sua mensagem de fim.
- **Modo evergreen**: cada visitante vê o seu próprio temporizador (duração em horas, guardada no navegador dele), limitado pela data de fim da campanha. O desconto mantém-se ativo durante toda a janela da campanha; o temporizador individual é uma alavanca de urgência visual.

## Funcionamento do desconto

O desconto é aplicado por um processador de carrinho executado depois do cálculo dos preços de produto e antes das promoções do Shopware. Na página de produto, nas listagens, na pesquisa e nos sliders, o preço com desconto aparece com o preço antigo riscado através do mecanismo de _list price_ nativo, compatível com qualquer tema. Nada é escrito na base de dados nos seus produtos: no fim da campanha, tudo volta instantaneamente ao normal.

A contagem decrescente está alinhada com a hora do servidor através de um desvio calculado no carregamento da página: alterar o relógio do navegador não tem qualquer efeito.

Se um produto já tiver um preço riscado (list price), o da venda flash substitui-o durante a campanha.

## Multilingue

Os textos de campanha (banner, teaser, mensagem de fim) traduzem-se pelo seletor de idioma da página de detalhe. As etiquetas da contagem decrescente (d/h/min/s) são fornecidas em francês, inglês e alemão e podem ser ajustadas através dos snippets do Shopware (Definições > Loja > Snippets, chaves `dfFlashSale.*`).

## Resolução de problemas

- **A entrada «Vendas Flash» não aparece**: verifique que a extensão está ativa (`bin/console plugin:list`), execute de novo `assets:install` e `cache:clear`, e recarregue a administração com Ctrl+F5. Na 6.7, verifique a presença da pasta `.vite` (ver Instalação).
- **O banner não aparece**: a campanha está ativa? As datas atuais estão dentro da janela? O âmbito do banner é compatível com a página visitada? O canal de venda está incluído? Limpe também a cache HTTP (`bin/console cache:clear`).
- **O desconto não aparece no carrinho**: verifique a segmentação (o produto pertence às categorias ou produtos selecionados?) e o canal de venda.

## Desinstalação

Na desinstalação, as tabelas da extensão (`df_flash_sale`, `df_flash_sale_translation`) são eliminadas, exceto se marcar «Conservar os dados» no gestor de extensões.
