Modo Manutenção e Brevemente: guia completo

O Modo Manutenção e Brevemente (dfmaintenancepro) mostra uma página de espera desenhada aos visitantes não autorizados (contagem decrescente, captação de e-mails, acesso de testadores por IP ou token e soft launch por país) sem nunca ativar o modo de manutenção nativo do PrestaShop. A loja continua tecnicamente online: o back-office, os webhooks de pagamento e as tarefas agendadas continuam a funcionar normalmente.

Instalação

1. No back-office, abra Módulos > Gestor de módulos > Instalar um módulo.
2. Carregue o arquivo dfmaintenancepro.zip e clique em Instalar.
3. Clique em Configurar para abrir o painel do módulo.

A instalação cria a tabela dfmp_subscriber (e-mails captados), regista o separador oculto « Subscribers » e gera automaticamente um token de acesso único. Não é instalado nenhum override: o módulo assenta unicamente no hook actionDispatcherBefore.

Painel de informação

No topo da página de configuração, um painel resume o essencial:

• Estado: badge verde « ACTIVE » quando a página é servida aos visitantes, badge neutro caso contrário.
• URL de testador: a ligação https://a-sua-loja.pt/?dfmp_token=XXXX a partilhar: coloca um cookie de acesso no navegador do testador.
• Regenerar o token: invalida instantaneamente todos os cookies de acesso já concedidos.
• Pré-visualizar: mostra a página de manutenção mesmo com o módulo desativado (parâmetro dfmp_preview).
• E-mails captados: acesso direto à lista dos inscritos com o seu número.

Configuração geral

• Ativar a página de manutenção: o interruptor principal. Uma vez ativado, todos os visitantes não autorizados veem a página de espera.
• Modo: « Brevemente (pré-lançamento) » ou « Manutenção (indisponibilidade temporária) ». Esta escolha só muda o badge apresentado na página; o comportamento SEO regula-se na secção SEO.
• Data de lançamento: formato AAAA-MM-DD HH:MM, fuso horário do servidor (Europe/Lisbon numa loja portuguesa; atenção à mudança de hora de verão). Alimenta a contagem decrescente e o cabeçalho Retry-After.
• Mostrar a contagem decrescente: o contador dias/horas/minutos/segundos oculta-se automaticamente assim que a data é atingida.

Acesso de teste (IP e token)

Lista branca de IP

Uma entrada por linha (ou separadas por vírgulas). São aceites três formatos:

• Endereços exatos IPv4 ou IPv6: 82.64.12.7
• Intervalos CIDR: 192.168.1.0/24 ou 2001:db8::/32
• Wildcards IPv4: 192.168.1.*

Ligação de testador com token

Partilhe o URL apresentado no painel de informação. Na abertura, é colocado um cookie assinado com HMAC SHA-256 no navegador do testador durante a duração configurada (72 horas por defeito): navega depois na loja real como se nada fosse. O campo Duração do cookie de acesso controla essa validade.

Webhooks de pagamento

A opção Autorizar os controladores front dos módulos (ativada por defeito) deixa passar todos os pedidos fc=module: os IPN e callbacks de pagamento (PayPal, Stripe, IfthenPay, Easypay, etc.) nunca são bloqueados, mesmo em plena manutenção.

Soft launch por país

Este modo transforma a página de espera numa ferramenta de lançamento progressivo:

1. Ative o Soft launch.
2. Preencha os códigos de país ISO 3166-1 alpha-2 autorizados, separados por vírgulas: PT,ES,FR,BR.
3. Escolha o comportamento para um país indeterminado: mostrar a página de manutenção (por defeito, prudente) ou deixar entrar.

A deteção do país segue esta ordem:

1. Cabeçalhos de geolocalização do CDN: CF-IPCountry (Cloudflare), CloudFront-Viewer-Country (AWS), X-Vercel-IP-Country, X-Geoip-Country (nginx).
2. Base GeoLite2 do PrestaShop se a geolocalização estiver configurada em Parâmetros internacionais > Geolocalização.

Conteúdo e design

• Título, subtítulo, mensagem: traduzíveis idioma a idioma através das bandeiras; a mensagem aceita HTML simples.
• Logótipo: URL absoluto de uma imagem (PNG/SVG aconselhado). Vazio, aparece o nome da loja em texto.
• Cores: fundo, destaque (contagem decrescente, botão, badge) e texto, através dos seletores de cor.
• Redes sociais: Facebook, Instagram, X, LinkedIn, YouTube: preencha apenas as que quer mostrar, os ícones SVG estão integrados.
• CSS personalizado: injetado no fim dos estilos para ajustar tudo com precisão.

A página gerada é 100 % autónoma: CSS e JavaScript inline, nenhum tipo de letra nem script de terceiros, nenhum pedido externo. Respeita prefers-reduced-motion e adapta-se ao telemóvel.

Captação de e-mails

• Ativar a captação: mostra o formulário sob a contagem decrescente.
• Placeholder, designação do botão, mensagem de sucesso, menção RGPD: todos traduzíveis por idioma.

O formulário funciona em AJAX com um campo honeypot invisível que neutraliza os bots. Cada inscrição regista o e-mail, o idioma, o país detetado, o IP e a data, com unicidade por endereço e por loja.

Lista dos inscritos e exportação CSV

A partir do painel de informação, abra E-mails captados: a lista filtra-se por coluna, ordena-se, limpa-se em massa e exporta-se em CSV através do botão Exportar CSV, pronta a importar na sua ferramenta de e-mail marketing no dia do lançamento.

SEO

• Código HTTP 503 (recomendado): assinala ao Google uma indisponibilidade temporária. O cabeçalho Retry-After é calculado com base no tempo restante até à data de lançamento (limitado a 7 dias); sem data futura, é usado o valor do campo Retry-After.
• Código HTTP 200: para uma página « brevemente » duradoura e indexável.

Em todos os casos, a página envia uma etiqueta noindex, nofollow e cabeçalhos no-cache: o seu catálogo continua indexado, a página de espera não.

Funcionamento técnico

A cada pedido do front-office, o módulo avalia as autorizações por esta ordem e deixa passar no primeiro sucesso:

1. Colaborador autenticado no back-office (cookie psAdmin).
2. Parâmetro dfmp_token válido no URL (coloca o cookie de acesso).
3. Cookie de acesso assinado ainda válido.
4. IP presente na lista branca.
5. País autorizado se o soft launch estiver ativo.

Caso contrário, a página de manutenção é renderizada e a execução para antes do controlador front. Multiloja: a configuração e a lista de inscritos são próprias de cada loja.

Resolução de problemas

• Continuo a ver a loja apesar de o módulo estar ativo: está provavelmente autenticado no back-office no mesmo navegador, ou um cookie de acesso ainda está válido. Teste em navegação privada.
• Um testador vê a página de manutenção apesar da ligação com token: o token pode ter sido regenerado desde o envio da ligação; reenvie o URL apresentado no painel de informação.
• O soft launch bloqueia toda a gente: nenhum cabeçalho de CDN nem base GeoLite2 disponível: o país é indeterminado e a regra por defeito bloqueia. Passe « País desconhecido » para « Autorizar » ou configure a geolocalização.
• A contagem decrescente não aparece: verifique que a data de lançamento está no formato AAAA-MM-DD HH:MM e situada no futuro.
• Desinstalação: elimina a tabela dos inscritos: exporte o CSV antes se quiser conservar os endereços.