# Oferta do dia WooCommerce (Deals of the Day): guia completo

> Guia completo para instalar, configurar e usar o DataFirefly Deals of the Day no WooCommerce.

- Página: <https://www.datafirefly.com/pt/documentation/deals-of-the-day-woocommerce/>
- Idioma: pt
- Atualizado em: 2026-11-19
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/deals-of-the-day-woocommerce/index.md), [en](https://www.datafirefly.com/en/documentation/deals-of-the-day-woocommerce/index.md), [es](https://www.datafirefly.com/es/documentation/deals-of-the-day-woocommerce/index.md), [de](https://www.datafirefly.com/de/documentation/deals-of-the-day-woocommerce/index.md), [it](https://www.datafirefly.com/it/documentation/deals-of-the-day-woocommerce/index.md), [pl](https://www.datafirefly.com/pl/documentation/deals-of-the-day-woocommerce/index.md), [nl](https://www.datafirefly.com/nl/documentation/deals-of-the-day-woocommerce/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Visão geral

O DataFirefly Deals of the Day acrescenta ao WooCommerce uma página «Deals of the Day» e um motor de rotação automática. À hora escolhida, o plugin seleciona produtos segundo as suas regras, aplica um desconto e termina as ofertas anteriores. Também pode programar ofertas manualmente.

O preço da oferta é calculado em tempo real enquanto a oferta está online. Os preços guardados no WooCommerce nunca são alterados: no fim da oferta, ou quando as unidades previstas são vendidas, o preço normal volta sozinho.

**Em resumo:** ative o plugin, adicione a página de ofertas ao menu, defina as regras em **WooCommerce > Deals of the Day > Automatic rotation** e clique em **Go live now**.

A interface do plugin está em inglês e francês. Neste guia, os nomes de ecrãs e botões aparecem em inglês, tal como surgem na administração.

## Instalação

1. Em **Plugins > Adicionar novo > Carregar plugin**, escolha `df-deals-of-the-day.zip` e ative o **DataFirefly Deals of the Day**.
2. Chega ao painel do plugin. A página de ofertas já está criada e publicada: adicione-a ao menu em **Aspeto > Menus** ou no editor do site.

Requisitos: WordPress 6.2 ou superior, WooCommerce 7.8 ou superior, PHP 7.4 ou superior. Compatível com HPOS, os blocos Carrinho e Finalização, temas de blocos e temas clássicos.

## Início rápido

1. **Página de ofertas**: criada na ativação com o bloco «Deals of the Day». Adicione-a ao menu.
2. **Regras de rotação**: no separador **Automatic rotation**, escolha o modo, a hora, o número de produtos, o desconto e as exclusões, e guarde.
3. **Publicação**: clique em **Go live now** por baixo da seleção prevista para lançar já a primeira rotação, ou aguarde a hora prevista. Também pode criar uma oferta manual no separador **Deals**.

## Os três modos

- **Automatic**: os produtos rodam segundo o calendário e as suas regras.
- **Hybrid** (predefinido): as suas ofertas manuais em curso ocupam primeiro os seus lugares, a rotação preenche os restantes até ao número de produtos definido.
- **Manual**: só estão online as ofertas que programar. Passar ao modo manual termina as ofertas automáticas em curso.

No mesmo produto, uma oferta manual tem sempre prioridade sobre uma automática.

## Calendário de rotação

- **Every day**: todos os dias à hora escolhida (meia-noite por omissão).
- **Every X hours**: a cada X horas a partir de uma hora inicial. A cada 6 horas desde as 08:00 dá 02:00, 08:00, 14:00 e 20:00.
- **Every week**: todas as semanas num dia e hora definidos.

As horas seguem o fuso horário da loja (**Definições > Geral**). Cada oferta automática dura até à rotação seguinte. O planeador verifica a cada 5 minutos se há uma rotação a fazer e se alguma oferta começou, terminou ou esgotou.

## Seleção e desconto

- **Products per rotation**: de 1 a 60.
- **Priority**: aleatória, produtos que vendem pouco (para escoar stock parado), mais vendidos, maior stock (produtos com gestão de stock), mais recentes, preços mais altos.
- **Featured deal**: maior desconto, primeiro produto escolhido ou nenhuma. A oferta em destaque aparece em grande no topo da página.
- Desconto: **Same percentage for all** ou **Random within a range** por escalões. De 15 a 40% em escalões de 5 dá 15, 20, 25, 30, 35 ou 40%.
- **Maximum discount per unit**: se a percentagem ultrapassar este valor num produto caro, o desconto fica limitado a este valor.
- **Units per deal**: unidades vendidas a preço de oferta. 0 = ilimitado. Com um limite aparece uma barra de stock.
- **Maximum per order**: impede um cliente de comprar mais unidades a preço de oferta numa encomenda. 0 = sem limite.

## Produtos abrangidos e regras de exclusão

A rotação escolhe produtos de **todo o catálogo**, de **algumas categorias** (subcategorias incluídas), **algumas etiquetas** ou **uma lista de produtos**. Um produto que cumpra qualquer destas regras nunca entra numa rotação automática:

- categorias, etiquetas, marcas (WooCommerce Brands e os principais plugins de marcas) ou produtos excluídos;
- tipos de produto assinalados (os produtos agrupados são sempre excluídos, não têm preço próprio);
- produtos já em promoção, esgotados, em encomenda pendente, sem imagem, ocultos do catálogo ou em destaque, segundo os interruptores ativados;
- preço normal fora do intervalo mínimo / máximo;
- stock abaixo do stock mínimo (produtos com gestão de stock);
- produtos publicados há menos de X dias (novidades);
- produtos que tiveram uma oferta automática nos últimos X dias (**Cooldown**, 30 dias por omissão).

Para excluir um único produto, abra-o e assinale **Never include this product in automatic rotations** em **Dados do produto > Geral**.

A caixa **Live check** mostra quantos produtos cumprem as suas regras enquanto as edita, antes de guardar. Se o número for inferior aos produtos por rotação, fica laranja.

Com **Relax if not enough products**, a rotação preenche os lugares vazios com produtos ainda no prazo de regresso, em vez de os deixar livres. A seleção prevista assinala-os com «Cooldown relaxed».

## Seleção da próxima rotação

Por baixo das regras, **Next rotation lineup** mostra os produtos previstos com preço normal, preço de oferta e desconto. É recalculada assim que altera as regras.

- O botão **Swap for another product** substitui um produto por outro produto elegível.
- **Shuffle** recalcula toda a seleção.
- **Go live now** termina as ofertas automáticas em curso e publica a seleção de imediato. A rotação seguinte mantém-se à hora prevista.

No momento da rotação, cada produto previsto é verificado de novo: se já não cumprir as regras (por ter esgotado entretanto, por exemplo), é substituído e o histórico de rotações indica-o.

## Ofertas manuais

No separador **Deals**, clique em **New deal**. Também pode partir de um produto: ligação **Create a deal** na lista de produtos ou botão **Schedule a deal for this product** na sua página de edição.

1. **Produto**: um produto simples, um produto variável (todas as variações ficam com desconto) ou uma única variação.
2. **Desconto**: percentagem (**Percentage**), valor (**Amount off**) ou preço exato (**Deal price**). A pré-visualização mostra o preço normal, o preço de oferta e o desconto real.
3. **Datas**: início e fim no fuso horário da loja, com durações rápidas (24 horas, 48 horas, 3 dias, 1 semana, até à meia-noite).
4. **Limites**: unidades disponíveis a preço de oferta, máximo por encomenda, oferta em destaque.

A lista de ofertas filtra-se por estado (em curso, programada, terminada) e por origem (automática, manual). Cada oferta pode ser editada, terminada de imediato, relançada como oferta manual com a mesma duração ou eliminada (as estatísticas mantêm-se).

## Página do produto, loja e carrinho

No separador **Design**:

- **Badge**: texto («Deal of the day» por omissão, editável), ícone, percentagem e estilo nas imagens: pastilha, fita, canto ou autocolante. O selo substitui o selo «Promoção!» do WooCommerce nos produtos em oferta.
- **Colours & shape**: seis paletas prontas ou as suas cores, e o arredondamento dos cantos, com pré-visualização em tempo real.
- **Product page**: posição do bloco de oferta (por baixo do título, por baixo do preço, acima ou abaixo do botão Adicionar ao carrinho, ou oculto) e elementos mostrados: contagem decrescente, barra de stock, valor poupado, prova social. O limiar de urgência mostra «Only X left!» quando as unidades restantes descem abaixo desta percentagem.
- **Shop & category listings**: selo nas imagens e contagem decrescente por baixo do preço.

Com um tema de blocos, o selo substitui o dos blocos Imagem do produto e Selo de promoção, e o bloco de oferta aparece por baixo do bloco Preço do produto. Com um construtor de páginas, oculte o bloco automático e coloque o shortcode `[df_deal_panel]` onde quiser.

No carrinho e na finalização, o artigo indica «Deal of the day: -30%». Os limites de unidades e por encomenda são verificados no carrinho clássico e com os blocos Carrinho e Finalização. Se a oferta terminar com o artigo no carrinho, volta ao preço normal.

## A página de ofertas

A página mostra um cabeçalho com título, número de ofertas, maior desconto e contagem decrescente até às próximas ofertas, a oferta em destaque, a grelha das restantes ofertas e uma antevisão «Coming next» com imagens desfocadas da próxima seleção e das ofertas programadas. Quando a contagem chega a zero, a página recarrega.

Em **Design > Deals page** define o título e o subtítulo (escreva-os em português), a disposição (oferta em destaque + grelha, grelha ou lista), as colunas, a ordem, a contagem decrescente, a antevisão, o recarregamento automático e a mensagem sem ofertas.

```
[df_deals_of_the_day layout="hero_grid|grid|list" columns="3" limit="12" show_hero="no" show_upcoming="no" sort="featured|discount|price_asc|ending"]
[df_deal_panel id="123"]
[df_deal_badge id="123"]
[df_deals_countdown format="boxes|inline"]
```

No editor, o bloco **Deals of the Day** (categoria WooCommerce) tem definições próprias de disposição, colunas e número de ofertas.

## Definições

- **Deals page**: página que mostra as ofertas, ou crie uma nova.
- **The discount applies to**: preço normal (recomendado, a oferta substitui qualquer preço promocional) ou preço atual (a oferta soma-se a uma promoção em curso).
- **Price rounding**: preço exato, ,99, ,95, ,90 ou número inteiro. Sempre por defeito, o desconto mostrado nunca é exagerado.
- **EU Omnibus reference price**: mostra por baixo do preço o preço mais baixo dos 30 dias anteriores à oferta, calculado a partir do preço normal, do preço atual e das ofertas anteriores do plugin.
- **Deal label in cart & checkout**.
- **Purge page cache when deals change**, com a lista de plugins de cache detetados.
- **Delete all data when the plugin is deleted**: ofertas, estatísticas e definições. Os preços dos produtos nunca são alterados.

O preço de referência Omnibus tem em conta as ofertas do plugin e a promoção em curso, mas não as promoções passadas geridas por outro plugin. Confirme que corresponde à sua situação antes de o mostrar.

## Estatísticas

O painel mostra em 30 dias a faturação sem impostos a preço de oferta, as unidades vendidas e as encomendas, o rácio carrinho para encomenda, a poupança dos clientes, a faturação diária de 14 dias, as ofertas em curso com vendas e tempo restante, os melhores produtos, o histórico de rotações e o estado do planeador. Uma venda conta quando a encomenda fica em espera, em processamento ou concluída, e é retirada se a encomenda for cancelada, falhar ou for reembolsada.

## Cache e planeamento

Quando uma oferta começa, termina ou esgota, o plugin limpa as caches de produto do WooCommerce e a cache de páginas do WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround Speed Optimizer, Breeze, Autoptimize, Nginx Helper e Cachify. As outras caches podem usar a ação `dfdod_purge_cache`.

As rotações correm pelo WP-Cron a cada 5 minutos e, como recurso, na primeira visita após a hora prevista. Se `DISABLE_WP_CRON` estiver definido, configure o cron do servidor para chamar `wp-cron.php` a cada 5 minutos.

## Programadores

- Filtros: `dfdod_deal_price`, `dfdod_apply_deal_pricing`, `dfdod_rotation_query_args`, `dfdod_product_rejection_reason`, `dfdod_rotation_discount`, `dfdod_next_rotation`, `dfdod_badge_html`, `dfdod_panel_html`, `dfdod_card_html`, `dfdod_page_html`, `dfdod_admin_capability`.
- Ações: `dfdod_rotated`, `dfdod_order_counted`, `dfdod_purge_cache`.
- Meta de produto: `_dfdod_exclude` = `yes` exclui um produto das rotações.

## Resolução de problemas

### Nenhum produto na seleção prevista

O contador Live check está a 0: as exclusões afastam todo o catálogo. Desative «Already on sale» ou «Without an image», alargue o intervalo de preços ou reduza o prazo de regresso.

### A rotação não aconteceu à hora prevista

Veja o estado do planeador no histórico de rotações. Se o WP-Cron estiver desativado e o site não tiver tido visitas, a rotação espera pela primeira visita. Adicione um cron de servidor.

### Um cliente ainda vê o preço antigo

Foi servida uma página em cache. Confirme que a limpeza da cache está ativa e que o seu plugin de cache é detetado; caso contrário, use a ação `dfdod_purge_cache`.

### O selo não aparece no meu tema

Alguns temas não usam o selo de promoção do WooCommerce. Coloque o shortcode `[df_deal_badge]` no modelo da página ou do cartão de produto.
