Oferta do Dia PrestaShop
Instalar, configurar e planear as ofertas do dia: calendário, preenchimento automático, stock reservado, limites e apresentação na loja.
Apresentação
O módulo Oferta do Dia (dfdealoftheday) destaca um produto com um preço especial, um stock reservado para a oferta e uma contagem decrescente até ao fim real da oferta. Três tipos de oferta: Oferta do dia (24 horas), Oferta da semana (7 dias) e Venda relâmpago (início e fim livres). O preço usa um preço específico nativo do PrestaShop com datas sobre a janela da oferta: começa e termina sozinho, sem tarefa CRON.
Compatibilidade: PrestaShop 1.7.8.0 a 9.x, PHP 7.4 a 8.5, multiloja. Testado em PrestaShop 1.7.8.11, 8.2.1 e 9.1.5, com os temas Classic e Hummingbird.

Instalação e atualização
- No back-office, abra Módulos > Gestor de módulos e clique em Carregar um módulo.
- Envie o ficheiro
dfdealoftheday-2.0.0.zip. - O módulo cria as suas tabelas e o separador Catálogo > Ofertas do dia. Junta-se ao hook
displayHomesem alterar a posição dos outros módulos.
A partir de uma versão 1.x, basta enviar o novo ZIP: a atualização recupera as ofertas, as vendas, as definições e os preços específicos da versão anterior. Um preço específico só é recuperado se ainda visar o produto da oferta.
Definições
As definições estão no separador Definições da página Catálogo > Ofertas do dia.
Planeamento
- Hora de mudança das ofertas: as ofertas do dia e da semana começam e terminam a esta hora, no fuso horário da loja. Alterá-la desloca as ofertas futuras; a oferta em curso termina à nova hora para não deixar nenhum intervalo.
- Permitir ofertas simultâneas: uma oferta do dia, uma oferta da semana, vendas relâmpago e ofertas de categoria podem então decorrer ao mesmo tempo, uma por tipo e categoria. Um produto nunca está em duas ofertas ao mesmo tempo.
- Máximo por encomenda predefinido: pré-preenchido nas novas ofertas.
Stock da oferta
- Quando são reservadas as unidades da oferta? «No carrinho, por tempo limitado»: as unidades são guardadas para o cliente enquanto o carrinho estiver ativo e libertadas após a Duração da reserva (minutos) sem atividade. «Apenas na encomenda»: os carrinhos não guardam nada. Em ambos os casos, um bloqueio impede que duas encomendas fiquem com a mesma unidade.
- Quando já não resta nenhuma unidade ao preço da oferta: o produto continua à venda ao preço normal, ou é retirado dos carrinhos.
- Manter visível uma oferta esgotada até ao fim; caso contrário, o bloco mostra a contagem decrescente da próxima oferta.
- Limiar de stock baixo (%): a quantidade restante é destacada abaixo deste limiar. Mostra sempre as unidades realmente restantes.
Preço de referência
- Desconto anunciado: em relação ao preço mais baixo dos 30 dias anteriores à oferta, ou em relação ao preço habitual atual (comportamento do PrestaShop). O módulo regista todos os dias o preço realmente aplicado aos visitantes para os produtos programados. Sem 30 dias de histórico e sem preço de referência declarado, nenhum desconto é anunciado.
- Aplicá-lo também aos preços do tema: o preço riscado e o selo de desconto do tema usam o preço de referência no produto em oferta.
Apresentação
- Bloco na página inicial, Barra de anúncio em todas as páginas (hook
displayBanner, o visitante pode fechá-la), caixa na página do produto com a sua Posição na página do produto (sob o preço ou sob o botão Adicionar ao carrinho), ofertas de categoria no topo da sua categoria, selo nas miniaturas, contagem decrescente, barra de stock. - Anunciar a próxima oferta: apenas a hora de início, o produto sem o seu preço, ou o produto e o seu preço de oferta.
- Atualização em direto das páginas em cache: um pequeno pedido por página vista atualiza o stock restante e a contagem decrescente quando a página vem de uma cache. Nunca um pedido por segundo.
- Cor de destaque e URL da página de ofertas.
Criar uma oferta
Clique em Agendar uma oferta, num dia vazio do calendário ou na caixa do módulo na página do produto do back-office.
- Tipo e datas: oferta do dia, oferta da semana ou venda relâmpago. As horas são as da loja.
- Produto: pesquisa por nome, referência ou ID, depois todas as combinações ou apenas uma. Uma oferta de categoria aparece no topo da categoria e na página de ofertas.
- Grupo de clientes: todos ou um grupo.
- Tipo de desconto e Valor do desconto: percentagem, ou montante sem IVA ou com IVA.
- Stock da oferta, Máximo por encomenda e Máximo por cliente: 0 = sem limite. O máximo por cliente conta todas as encomendas e carrinhos do mesmo endereço de e-mail, convidados incluídos.
- Preço de referência declarado (opcional): deixe vazio para usar o histórico. Preencha-o apenas se conhecer esse preço; continua a ser responsável por ele.
- Título (opcional): texto curto apresentado acima do nome do produto.
O formulário mostra uma pré-visualização (preço normal, preço da oferta, preço de referência, stock real) e verifica os conflitos em direto.

Bloqueante: outra oferta no mesmo período (sem ofertas simultâneas), ou o mesmo produto em duas ofertas. Avisos: outro preço específico do produto (regra de preço de catálogo, preço de cliente, preço de combinação, desconto por quantidade), uma regra de carrinho que se pode somar ao preço da oferta, stock real inferior ao stock da oferta, histórico de preços incompleto, preço da oferta não inferior ao preço de referência, módulos DataFirefly cuja acumulação deve ser verificada.
Planear várias semanas
O calendário
O calendário tem uma vista mensal e uma vista semanal. Arraste uma oferta que ainda não começou para outro dia para a mover, ou para outra oferta do mesmo tipo para trocar as datas.

Modelos, duplicação e repetição
Um modelo guarda um tipo, um desconto e limites: escolha-o no topo do formulário para o preencher com um clique. Uma oferta pode ser duplicada ou repetida todas as semanas durante 26 semanas no máximo; os dias já ocupados são ignorados e cada cópia pode depois ser editada à parte.

Preenchimento automático
Preencher o planeamento automaticamente cria uma oferta por dia vazio num período de 366 dias no máximo: dias da semana, origem dos produtos (categoria com ou sem subcategorias, lista de ID ou mais vendidos), ordem, apenas produtos em stock, intervalo mínimo entre duas ofertas do mesmo produto, desconto e limites. Os dias já planeados nunca são alterados.
Um produto que volta a estar em oferta menos de 30 dias depois da anterior tem como preço de referência o preço dessa oferta: o desconto anunciado é menor. Um intervalo mínimo de 30 dias evita isso.
Stock, limites e encomendas
- Cada encomenda é controlada sob bloqueio até ao pagamento. Só são contadas as unidades realmente vendidas ao preço da oferta.
- O carrinho é ajustado ao menor destes números: unidades restantes da oferta, máximo por encomenda, unidades ainda permitidas ao cliente. O cliente vê uma mensagem clara.
- Um carrinho aberto depois do fim da oferta, ou acima do stock, volta ao preço normal com uma mensagem.
- Cancelamento, erro de pagamento, reembolso parcial, devolução ou encomenda alterada: as unidades são recontadas a partir da encomenda, nunca devolvidas duas vezes. O preço da oferta volta se forem libertadas unidades durante a oferta.

Se um módulo de pagamento validar uma encomenda através de uma notificação diferida, depois de as unidades terem sido libertadas, a venda é registada como excesso e assinalada no painel, sem ser bloqueada: o cliente pagou.
Apresentação na loja
- Página inicial: bloco com imagem, preço, preço de referência, desconto, barra de stock e contagem decrescente.
- Hook personalizado:
{hook h='displayDfDealOfTheDay'}ou{widget name='dfdealoftheday'}num template do tema. - Página de ofertas: ofertas em curso e anúncio da próxima oferta, no URL definido.
- Página do produto: caixa com o fim real, preço de referência, stock real e limites.
- Listas de produtos: selo nas miniaturas. Barra de anúncio no topo das páginas se a opção estiver ativa.

A contagem decrescente leva ao fim real da oferta, segundo a hora do servidor, e nunca recomeça. A página recarrega uma vez no fim. O temporizador é legível pelos leitores de ecrã e respeita a definição de movimento reduzido do dispositivo.
Acompanhamento dos resultados
O Painel mostra as ofertas em curso e futuras, as unidades e o volume de negócios sem IVA medidos nas encomendas, o ritmo de escoamento das ofertas limitadas, a cobertura dos próximos 14 dias, os pontos a verificar e um registo (preços criados, retirados ou restaurados, ofertas movidas, vendas em excesso). Os números vêm apenas de encomendas reais.

Para verificar uma oferta futura, guarde-a e use Pré-visualização na loja: esta ligação privada é a única forma de ver a oferta antes de começar.
Resolução de problemas
O preço da oferta não se aplica
Verifique se a oferta está ativa e se o seu stock não está vendido, e leia os avisos do formulário: um preço de cliente, um preço de combinação ou um desconto por quantidade prevalece sobre a oferta.
O preço riscado ou o desconto não aparece
O módulo não anuncia nenhum desconto enquanto não tiver 30 dias de histórico de preços do produto, salvo preço de referência declarado. Também não o anuncia se o preço da oferta não for inferior ao preço de referência.
A caixa não aparece na página do produto
Mude Posição na página do produto para «Sob o botão Adicionar ao carrinho».
O stock apresentado não muda com uma cache de página
Mantenha ativa a Atualização em direto das páginas em cache e limpe a cache no início de uma oferta se os preços do tema tiverem de mudar de imediato.
Desinstalação
A desinstalação elimina as ofertas, o histórico de vendas e de preços, as definições e os preços específicos criados pelo módulo, e só esses. Os outros preços específicos da loja não são tocados.
O módulo é uma ferramenta: calcula um preço de referência e mostra uma contagem decrescente e um stock reais, mas não garante a conformidade dos seus anúncios de preços, que continua a ser da sua responsabilidade.