Barra de Anúncio e Contagem Decrescente (dfannouncebar)

Apresentação

O módulo dfannouncebar acrescenta uma barra de anúncio inteligente à sua loja PrestaShop 8 ou 9: vários textos em rotação na mesma barra, uma contagem decrescente em direto, segmentação por idioma, país e grupo de clientes, agendamento por datas e um botão de fecho memorizado por cookie. Estão disponíveis três posições: topo da página, topo fixo (sticky) e fundo fixo.

Instalação

1. No back-office, abra Módulos → Gestor de módulos → Instalar um módulo.
2. Envie o ficheiro dfannouncebar.zip e clique em Instalar.
3. Clique em Configurar para abrir a página do módulo.

Na instalação, o módulo cria uma barra de exemplo inativa com um texto multilingue (código HELLO10 e contagem decrescente a 7 dias): ative-a para ver de imediato o resultado e depois adapte-a ou elimine-a.

Configuração geral

A página de configuração contém uma definição global: o hook de ancoragem da posição «topo da página».

• displayBanner (predefinido): posição padrão acima do cabeçalho no tema Classic.
• displayTop: solução de recurso se o seu tema não declarar o displayBanner.

Uma proteção interna impede qualquer apresentação duplicada se o seu tema executar os dois hooks. As posições fixas (topo fixo e fundo fixo) não dependem desta definição.

Criar uma barra

Na página de configuração, clique em Gerir as barras. Cada barra tem:

• Posição: topo da página, topo fixo (acompanha o deslocamento) ou fundo fixo. O módulo compensa automaticamente o padding da página nas posições fixas.
• Prioridade: se várias barras visarem a mesma posição, só é apresentada a que tiver a prioridade mais baixa.
• Cores: fundo e texto, aplicados através de variáveis CSS.
• Rotação: intervalo em segundos entre dois textos. A rotação faz pausa quando o rato passa por cima.
• Fecho: botão de fecho opcional; o tempo de vida do cookie (em horas) determina quando a barra reaparece.
• Agendamento: data de início e data de fim no formato AAAA-MM-DD, completadas automaticamente com 00:00:00 e 23:59:59.
• Loja: em multiloja, uma barra pode ser global ou limitada a uma loja.

Textos e contagem decrescente

Na lista de barras, a ação Textos abre os textos da barra. Cada texto é multilingue e inclui:

• Texto: o conteúdo apresentado. Insira o marcador {countdown} no ponto onde o cronómetro deve aparecer.
• Data-limite: o alvo da contagem decrescente, apresentada no formato Xd HH:MM:SS e atualizada a cada segundo (a legenda dos dias é traduzível).
• Ocultar depois de expirar: o texto desaparece automaticamente na data-limite, tanto no navegador como no servidor (não é servido qualquer HTML morto).
• Botão de ação: legenda e URL opcionais, apresentados em estilo de pastilha.
• Ordem: posição do texto na rotação.

Segmentação

Cada barra pode ser restringida por:

• Idiomas: a barra só é apresentada nos idiomas selecionados.
• Países: baseado no país do contexto do PrestaShop; a precisão aumenta se a geolocalização por IP estiver ativada em Parâmetros internacionais → Localização.
• Grupos de clientes: visitantes, convidados, clientes ou qualquer grupo personalizado (VIP, B2B…).

Um campo deixado vazio significa «toda a gente». Os três critérios acumulam-se.

Resolução de problemas

• A barra não aparece no topo da página: o seu tema provavelmente não declara o displayBanner; passe o hook de ancoragem para displayTop na configuração.
• A barra não aparece de todo: verifique se está ativa, se o agendamento cobre a data de hoje, se a segmentação corresponde ao seu perfil de teste e se nenhuma barra de prioridade inferior ocupa a mesma posição. Pense também no cookie de fecho: abra uma janela de navegação privada.
• A contagem decrescente não aparece: certifique-se de que o texto contém mesmo {countdown} e de que está preenchida uma data-limite futura.
• Aparecem duas barras no topo: o hook de ancoragem pode ter sido alterado enquanto uma cache de página servia a versão anterior; limpe a cache do PrestaShop.