PS PrestaShop Iniciante

DataFirefly Advent Calendar: calendário do Advento para PrestaShop

Instalação e atualização, definições e cron dos lembretes, modelos prontos, janelas e códigos de desconto, prémio instantâneo, pré-visualização, e-mails, sorteio, estatísticas e resolução de problemas.

Atualizado Versão do módulo 2.0.0

Instalação e atualização

Instale o módulo em Módulos > Gestor de módulos > Carregar um módulo enviando o ficheiro ZIP, ou copie a pasta dfadventcalendar para o diretório /modules/ da sua loja e clique em Instalar. O mesmo ZIP funciona do PrestaShop 1.7.8 ao 9.x.

A instalação cria as tabelas do módulo, regista os seus hooks, cria a página do calendário (um endereço por idioma) e acrescenta o separador Catálogo > Descontos > Calendário do Advento. As imagens das janelas ficam guardadas em /img/dfadventcalendar/, fora da pasta do módulo.

Atualização a partir da 1.0.0: carregue o novo ZIP e o PrestaShop executa a migração. Calendários, janelas, participantes e códigos são conservados. O endereço anterior da página continua válido em todos os idiomas, para que as ligações já enviadas por e-mail continuem a funcionar.

Definições do módulo

A página de configuração do módulo (botão Configurar) reúne as definições comuns a todos os calendários.

  • Endereço da página do calendário: um endereço por idioma, por exemplo /calendario-do-advento em português e /advent-calendar em inglês. O módulo recusa um endereço já usado por outra página. O título SEO da página define-se em Parâmetros da loja > Tráfego e SEO.
  • Fuso horário e hora da loja: as janelas abrem neste fuso horário, qualquer que seja o do visitante ou do servidor.
  • Lembretes por execução do cron: número máximo de e-mails enviados em cada chamada (150 por predefinição).
  • Conservar os dados ao desinstalar: calendários, janelas, participantes e imagens ficam na base de dados, prontos para uma reinstalação.
  • Relógio de teste (apenas no modo debug): todo o calendário comporta-se como se fosse a data e a hora introduzidas. O back office mostra um aviso enquanto estiver definido. Nunca o deixe ativo numa loja em produção.

Lembrete diário: tarefa cron

Copie o endereço cron apresentado e programe-o a cada 15 minutos no painel do seu alojamento:

*/15 * * * * curl -s "https://www.a-sua-loja.pt/module/dfadventcalendar/cron?token=O_SEU_TOKEN" > /dev/null

O calendário funciona sem cron: só os e-mails de lembrete dependem dele. A última execução é apresentada, e a lista de verificação do lançamento no painel assinala um cron parado.

DataFirefly Calendário do Advento: definições do módulo: endereço da página por idioma, fuso horário da loja, cron dos lembretes e conservação dos dados
Definições do módulo: endereço da página por idioma, fuso horário da loja, cron dos lembretes e conservação dos dados

Criar um calendário

Abra Catálogo > Descontos > Calendário do Advento. O mais rápido é partir de um modelo: datas, número de janelas, tema e título em todos os seus idiomas já estão preparados. Só falta preencher as janelas.

  • Calendário do Advento, 24 janelas ou 25 janelas com o dia de Natal, a partir de 1 de dezembro;
  • Os 12 dias de Natal, de 13 a 24 de dezembro;
  • Semana da Black Friday, 7 janelas até à última sexta-feira de novembro;
  • Contagem decrescente de evento, 10 janelas antes de um lançamento ou de uma venda privada.

O botão Calendário em branco ou Novo calendário permite escolher cada definição.

DataFirefly Calendário do Advento: lista de calendários com modelos prontos: Advento, 12 dias de Natal, semana da Black Friday e contagem decrescente
Lista de calendários com modelos prontos: Advento, 12 dias de Natal, semana da Black Friday e contagem decrescente

Datas e abertura

  • Data da primeira janela e número de janelas (de 1 a 60): uma janela por dia a partir dessa data.
  • Hora de abertura das janelas: 00:00 para a meia-noite, ou uma hora marcada como 08:00. Antes dessa hora, a janela da véspera continua a ser a janela do dia.

Aspeto

Há nove temas disponíveis: Floresta de abetos, Papel kraft, Geada, Noite de inverno, Bengala de açúcar e quatro temas fora do Natal (Preto e dourado, Black Friday, Pastel de primavera, Lagoa de verão). A opção Cores personalizadas ativa quatro cores. Há três estilos de janelas: portas que abrem, caixas de presente com laço e mosaicos minimalistas. A decoração anima o fundo: neve, estrelas, confetes ou nenhuma. Uma pré-visualização em direto mostra o resultado enquanto define o calendário.

Com tamanhos variados, a grelha preenche-se sem espaços vazios em 6 ou 4 colunas. No telemóvel passa a 4 colunas regulares. As animações param para os visitantes que pedem ao seu dispositivo para reduzir o movimento.

DataFirefly Calendário do Advento: definições do aspeto com pré-visualização em direto: tema, estilo das janelas e decoração
Definições do aspeto com pré-visualização em direto: tema, estilo das janelas e decoração

Participação

  • E-mail obrigatório para abrir as janelas: se estiver desativado, os visitantes abrem livremente, mas os códigos pessoais e os jogos continuam reservados aos participantes.
  • Reservado a contas de cliente: só participam clientes com sessão iniciada, e os seus códigos ficam associados à conta. É a melhor proteção contra a recolha de códigos com endereços descartáveis.
  • Confirmar o endereço de e-mail (double opt-in) e uma caixa de newsletter opcional, desmarcada.
  • Permitir abrir janelas passadas: os códigos partilhados continuam então válidos até ao fim do calendário.
  • Texto de consentimento: acrescente a ligação para a sua política de privacidade.

Configurar as janelas

O painel do calendário apresenta as janelas como cartões: data, tipo, recompensa, código, aberturas, códigos revelados e encomendas. Os filtros Por configurar, Com código, Prémio instantâneo, Hoje e próximas e Passadas e a pesquisa encontram uma janela de imediato. Cada cartão permite editar a janela, abri-la em pré-visualização ou ativá-la.

DataFirefly Calendário do Advento: editor visual das janelas com filtros, pesquisa e estatísticas por janela
Editor visual das janelas com filtros, pesquisa e estatísticas por janela

Tipos de janela

  • Mensagem: texto, imagem e botão opcional.
  • Código de desconto: o código é o destaque, num bilhete para copiar ou adicionar ao carrinho.
  • Produto revelado: ficha de produto com preço e botão para adicionar ao carrinho.
  • Prémio instantâneo: o participante tenta a sorte e ganha a recompensa com a probabilidade que definir.

Recompensa e código

Desconto em percentagem, desconto em valor, portes grátis, produto oferecido, ou uma regra de carrinho existente da loja com as suas próprias condições. Para as recompensas criadas pelo módulo:

  • Código pessoal: uma regra de carrinho de utilização única é gerada quando o participante abre a janela. Fica associada à conta de cliente, se for conhecida, e é válida até à meia-noite, mais a validade adicional que escolher.
  • Mesmo código para todos: uma regra de carrinho por janela, sincronizada automaticamente. Deixe o campo vazio para um código automático (prefixo, ano e número, por exemplo ADVENT26-07).
  • Valor mínimo de encomenda e limitação ao produto revelado opcionais.

Os botões Janela anterior e Janela seguinte permitem preencher o calendário de seguida. Sem tempo? Preencher as janelas vazias aplica um plano pronto a usar, traduzido em todos os seus idiomas.

Prémio instantâneo

Defina a probabilidade de ganhar (de 1 a 100%), o número de prémios (0 para ilimitado) e a mensagem quando o participante não ganha. O sorteio é feito no servidor quando a janela abre, uma só vez por participante. Reabrir a janela dá o mesmo resultado. Quando todos os prémios forem ganhos, os participantes seguintes veem a mensagem de derrota.

DataFirefly Calendário do Advento: definições do prémio instantâneo de uma janela: probabilidade de ganhar, número de prémios e mensagem de derrota
Definições do prémio instantâneo de uma janela: probabilidade de ganhar, número de prémios e mensagem de derrota

Pré-visualizar e lançar

O painel reúne tudo o que precisa para lançar o calendário:

  • Pré-visualizar a: escolha uma data e abra o calendário tal como estará nesse dia. Os códigos apresentados são exemplos e nada é guardado. As ligações de pré-visualização expiram ao fim de 7 dias.
  • Lista de verificação do lançamento: calendário ativo, janelas configuradas, cron dos lembretes e e-mails da loja.
  • Mais > Enviar-me os e-mails de teste: os quatro e-mails (lembrete, boas-vindas, confirmação, ligação de acesso) seguem para o funcionário com sessão iniciada, no seu idioma.
DataFirefly Calendário do Advento: painel do back office: lista de lançamento, participantes, janelas abertas, códigos, encomendas, faturação e gráfico de atividade
Painel do back office: lista de lançamento, participantes, janelas abertas, códigos, encomendas, faturação e gráfico de atividade

O que o cliente vê

A página do calendário abre com uma contagem decrescente até à próxima janela, com a janela do dia em destaque. Depois de se inscrever, o participante vê o seu anel de progresso, a sua série de dias seguidos e o interruptor do lembrete diário.

DataFirefly Calendário do Advento: página do calendário do Advento com contagem decrescente, anel de progresso, série de dias e sorteio final
Página do calendário do Advento com contagem decrescente, anel de progresso, série de dias e sorteio final

As janelas têm cinco estados: hoje (halo animado), por recuperar, aberta (conteúdo visível), próxima (cadeado e data) e perdida. Uma estrela assinala as janelas de jogo.

DataFirefly Calendário do Advento: grelha de janelas: janela do dia, janelas abertas, por recuperar e próximas
Grelha de janelas: janela do dia, janelas abertas, por recuperar e próximas

Ao abrir, uma janela apresenta a surpresa: produto com o seu preço, código num bilhete, botões Adicionar ao meu carrinho e Copiar. Se o carrinho estiver vazio, o código é guardado durante 14 dias e aplicado ao primeiro produto adicionado.

DataFirefly Calendário do Advento: janela do dia que revela um produto e um código de desconto pessoal para copiar ou adicionar ao carrinho
Janela do dia que revela um produto e um código de desconto pessoal para copiar ou adicionar ao carrinho

O resumo Os seus códigos lista os códigos obtidos, com a sua validade e estado (usado, expirado).

DataFirefly Calendário do Advento: carteira dos códigos obtidos pelo participante, com cópia e adicionar ao carrinho
Carteira dos códigos obtidos pelo participante, com cópia e adicionar ao carrinho

No telemóvel, a grelha passa a 4 colunas regulares e os painéis empilham-se.

DataFirefly Calendário do Advento: calendário do Advento no telemóvel com painel de participação e janelas
Calendário do Advento no telemóvel com painel de participação e janelas

Jogo de prémio instantâneo

Uma janela de jogo permite ao participante tentar a sorte. Se ganhar, recebe o código como numa janela normal. Caso contrário, vê a mensagem de derrota e pode jogar na próxima janela de jogo. Um visitante não inscrito é convidado a deixar o seu e-mail: uma só oportunidade por participante.

DataFirefly Calendário do Advento: janela de jogo de prémio instantâneo: o participante ganha um código de desconto
Janela de jogo de prémio instantâneo: o participante ganha um código de desconto

Faixa da página inicial e botão flutuante

A faixa aparece na página inicial durante o calendário e, se quiser, alguns dias antes do início. O botão flutuante, a ativar nas definições do calendário, lembra a janela do dia em todas as páginas. O visitante pode escondê-lo até ao dia seguinte. Para colocar a faixa noutro local, acrescente {hook h='displayDfAdventCalendar'} a um template do seu tema.

DataFirefly Calendário do Advento: faixa da página inicial e botão flutuante com a janela do dia
Faixa da página inicial e botão flutuante com a janela do dia

Contagens decrescentes fora do Natal

O mesmo módulo anima qualquer momento forte: semana da Black Friday, lançamento de uma coleção, saldos, aniversário da loja. Escolha um modelo de contagem decrescente, um tema como Preto e dourado, mosaicos minimalistas e uma hora de abertura. Antes do início, a página mostra a contagem decrescente até à primeira janela.

DataFirefly Calendário do Advento: calendário de contagem decrescente para um evento fora do Natal, tema preto e dourado com mosaicos minimalistas
Calendário de contagem decrescente para um evento fora do Natal, tema preto e dourado com mosaicos minimalistas

Lembretes e e-mails

Todos os dias, a partir da hora escolhida (nunca antes da hora de abertura das janelas), um e-mail curto anuncia a janela do dia aos participantes confirmados que ainda não a abriram. Um participante recebe no máximo um lembrete por dia, e nenhum no dia da inscrição: basta o e-mail de boas-vindas. Os e-mails usam as cores do tema do calendário.

DataFirefly Calendário do Advento: e-mail de lembrete diário que anuncia a janela do dia
E-mail de lembrete diário que anuncia a janela do dia

São fornecidos quatro modelos em oito idiomas em mails/: dfadvent_reminder (lembrete), dfadvent_welcome (boas-vindas), dfadvent_confirm (confirmação do endereço) e dfadvent_access (ligação de acesso). Um participante que volta a introduzir o seu endereço recebe uma ligação de acesso: o módulo nunca inicia sessão a alguém só com um endereço escrito, e o mesmo endereço recebe no máximo um e-mail a cada 2 minutos. Para personalizar os modelos, copie-os para themes/o-seu-tema/modules/dfadventcalendar/mails/.

DataFirefly Calendário do Advento: e-mail de boas-vindas que confirma a participação, com as cores do calendário
E-mail de boas-vindas que confirma a participação, com as cores do calendário

Participantes

A lista de participantes filtra-se com um clique: confirmados, a aguardar confirmação, lembretes ativos, newsletter, contas de cliente, vencedores do sorteio. Indica as janelas abertas e os códigos obtidos por cada um, e exporta para CSV.

DataFirefly Calendário do Advento: participantes com filtros rápidos: confirmados, pendentes, lembretes, newsletter, contas de cliente
Participantes com filtros rápidos: confirmados, pendentes, lembretes, newsletter, contas de cliente

Sorteio final

Nas definições do calendário, fixe o número mínimo de janelas abertas para participar (0 desativa o sorteio) e descreva o prémio. O painel indica quantos participantes são elegíveis. O botão Sortear um vencedor escolhe ao acaso entre os participantes confirmados elegíveis, excluindo os vencedores anteriores. Cada sorteio fica registado.

Um sorteio e um jogo de prémio instantâneo estão sujeitos às regras dos concursos e passatempos promocionais. Publique um regulamento na sua loja antes do lançamento.

Estatísticas

O painel mostra os participantes (confirmados, com conta de cliente), as janelas abertas e a média por participante, os códigos revelados e a parte de códigos pessoais usados, as encomendas válidas feitas com um código, a faturação sem impostos dessas encomendas e os lembretes ativos. O gráfico de atividade mostra, janela a janela, as aberturas e as inscrições.

Se o Google Tag Manager estiver presente, o módulo envia estes eventos para o dataLayer: dfadv_join, dfadv_door_open, dfadv_code_copy, dfadv_code_apply e dfadv_share.

O menu Mais > Duplicar para o ano seguinte copia o calendário e as suas janelas com um ano de diferença, inativo, sem participantes nem códigos.

Dados pessoais

  • A caixa de consentimento é obrigatória, a caixa de newsletter é separada e desmarcada.
  • Cada e-mail de lembrete contém uma ligação para cancelar a subscrição com um clique.
  • O endereço IP só é guardado em hash, para limitar as inscrições a 5 por hora por ligação.
  • O módulo responde aos pedidos de exportação (códigos incluídos) e de eliminação de dados pessoais do PrestaShop.

Resolução de problemas

Os lembretes não são enviados

Verifique a lista de verificação do lançamento no painel: cron executado nas últimas 24 horas, e-mails da loja ativados. Os lembretes saem a partir da hora escolhida, e apenas para participantes confirmados que ainda não abriram a janela do dia.

A página do calendário devolve um erro 404

Verifique se os URL amigáveis estão ativados e depois limpe a cache. Se o endereço entrar em conflito com outra página, altere-o nas definições do módulo.

Uma janela continua fechada no seu dia

Verifique a hora de abertura do calendário e o fuso horário da loja (Internacional > Localização). Uma janela não configurada ou inativa continua fechada.

O código não é adicionado ao carrinho

A mensagem apresentada vem do PrestaShop: valor mínimo não atingido, código expirado ou código associado a outra conta de cliente. Se o carrinho estiver vazio, o código fica à espera e aplica-se ao primeiro produto.

Compatibilidade

  • PrestaShop do 1.7.8 ao 9.x, o mesmo ZIP para todas as versões.
  • Temas Classic, Hummingbird e temas derivados.
  • Multiloja (um calendário por loja) e multimoeda (valores convertidos na moeda do visitante).
  • Arquitetura ModuleAdminController, sem dependências Composer.
  • Módulo traduzido em inglês, francês, espanhol, alemão, italiano, neerlandês, polaco e português.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte