Modo Mantenimiento & Coming Soon — Guía completa

Modo Mantenimiento & Coming Soon (dfmaintenancepro) muestra una página de espera diseñada a los visitantes no autorizados — cuenta atrás, captura de emails, acceso de testers por IP o token y soft launch por país — sin activar nunca el modo mantenimiento nativo de PrestaShop. La tienda permanece técnicamente en línea: el back-office, los webhooks de pago y las tareas programadas siguen funcionando con normalidad.

Instalación

1. En el back-office, abre Módulos > Gestor de módulos > Subir un módulo.
2. Sube el archivo dfmaintenancepro.zip y haz clic en Instalar.
3. Haz clic en Configurar para abrir el panel del módulo.

La instalación crea la tabla dfmp_subscriber (emails capturados), registra la pestaña oculta «Subscribers» y genera automáticamente un token de acceso único. No se instala ningún override: el módulo se apoya en el único hook actionDispatcherBefore.

Panel de información

En la parte superior de la página de configuración, un panel resume lo esencial:

• Estado — insignia verde «ACTIVE» cuando la página se sirve a los visitantes, insignia neutra en caso contrario.
• URL de tester — el enlace https://tutienda.com/?dfmp_token=XXXX para compartir: instala una cookie de acceso en el navegador del tester.
• Regenerar token — invalida al instante todas las cookies de acceso ya concedidas.
• Vista previa — muestra la página de mantenimiento incluso con el módulo desactivado (parámetro dfmp_preview).
• Emails capturados — acceso directo al listado de suscriptores con su recuento.

Configuración general

• Activar la página de mantenimiento — el interruptor principal. Una vez activado, todos los visitantes no autorizados ven la página de espera.
• Modo — «Coming soon (pre-lanzamiento)» o «Mantenimiento (indisponibilidad temporal)». Solo cambia la insignia mostrada en la página; el comportamiento SEO se ajusta en la sección SEO.
• Fecha de lanzamiento — formato AAAA-MM-DD HH:MM, zona horaria del servidor. Alimenta la cuenta atrás y la cabecera Retry-After.
• Mostrar cuenta atrás — el contador días/horas/minutos/segundos se oculta automáticamente al alcanzar la fecha.

Acceso de prueba (IP y token)

Whitelist de IP

Una entrada por línea (o separadas por comas). Se aceptan tres formatos:

• Direcciones IPv4 o IPv6 exactas: 82.64.12.7
• Rangos CIDR: 192.168.1.0/24 o 2001:db8::/32
• Comodines IPv4: 192.168.1.*

Enlace de tester con token

Comparte la URL mostrada en el panel de información. Al abrirla, se instala en el navegador del tester una cookie firmada HMAC SHA-256 durante el tiempo configurado (72 horas por defecto): a partir de ahí navega por la tienda real con total normalidad. El campo Duración de la cookie de acceso controla esta validez.

Webhooks de pago

La opción Permitir controladores front de módulos (activada por defecto) deja pasar todas las peticiones fc=module: los IPN y callbacks de pago (PayPal, Stripe, etc.) nunca se bloquean, ni siquiera en pleno mantenimiento.

Soft launch por país

Este modo convierte la página de espera en una herramienta de despliegue progresivo:

1. Activa Soft launch.
2. Indica los códigos de país ISO 3166-1 alpha-2 autorizados, separados por comas: ES,FR,PT.
3. Elige el comportamiento para un país indeterminado: mostrar la página de mantenimiento (por defecto, prudente) o dejar entrar.

La detección del país sigue este orden:

1. Cabeceras de geolocalización de CDN: CF-IPCountry (Cloudflare), CloudFront-Viewer-Country (AWS), X-Vercel-IP-Country, X-Geoip-Country (nginx).
2. Base GeoLite2 de PrestaShop si la geolocalización está configurada en Internacional > Geolocalización.

Contenido y diseño

• Título, subtítulo, mensaje — traducibles idioma por idioma mediante las banderas; el mensaje acepta HTML simple.
• Logo — URL absoluta de una imagen (PNG/SVG recomendado). Vacío, se muestra el nombre de la tienda en texto.
• Colores — fondo, acento (cuenta atrás, botón, insignia) y texto, mediante selectores de color.
• Redes sociales — Facebook, Instagram, X, LinkedIn, YouTube: rellena solo las que quieras mostrar, los iconos SVG están integrados.
• CSS personalizado — inyectado al final de los estilos para ajustes finos.

La página generada es 100 % autónoma: CSS y JavaScript inline, sin fuentes ni scripts de terceros, cero peticiones externas. Respeta prefers-reduced-motion y se adapta al móvil.

Captura de emails

• Activar la captura — muestra el formulario bajo la cuenta atrás.
• Placeholder, etiqueta del botón, mensaje de éxito, aviso RGPD — todos traducibles por idioma.

El formulario funciona en AJAX con un campo honeypot invisible que neutraliza a los bots. Cada suscripción registra el email, el idioma, el país detectado, la IP y la fecha, con unicidad por dirección y por tienda.

Listado de suscriptores y exportación CSV

Desde el panel de información, abre Emails capturados: el listado se filtra por columna, se ordena, se limpia en masa y se exporta a CSV con el botón Export CSV — listo para importar en tu herramienta de emailing el día del lanzamiento.

SEO

• Código HTTP 503 (recomendado) — indica a Google una indisponibilidad temporal. La cabecera Retry-After se calcula sobre el tiempo restante hasta la fecha de lanzamiento (con tope de 7 días); sin fecha futura, se usa el valor del campo Retry-After.
• Código HTTP 200 — para una página coming soon duradera e indexable.

En todos los casos, la página envía una etiqueta noindex, nofollow y cabeceras no-cache: tu catálogo permanece indexado, la página de espera no.

Funcionamiento técnico

En cada petición front, el módulo evalúa las autorizaciones en este orden y deja pasar al primer acierto:

1. Empleado conectado al back-office (cookie psAdmin).
2. Parámetro dfmp_token válido en la URL (instala la cookie de acceso).
3. Cookie de acceso firmada aún válida.
4. IP presente en la whitelist.
5. País autorizado si el soft launch está activo.

En caso contrario, se muestra la página de mantenimiento y la ejecución se detiene antes del controlador front. Multitienda: la configuración y el listado de suscriptores son propios de cada tienda.

Solución de problemas

• Sigo viendo la tienda aunque el módulo está activo — probablemente estás conectado al back-office en el mismo navegador, o una cookie de acceso sigue vigente. Prueba en navegación privada.
• Un tester ve la página de mantenimiento pese al enlace con token — puede que el token se haya regenerado desde que se envió el enlace; reenvía la URL mostrada en el panel de información.
• El soft launch bloquea a todo el mundo — no hay cabecera CDN ni base GeoLite2 disponible: el país es indeterminado y la regla por defecto bloquea. Cambia «País desconocido» a «Permitir» o configura la geolocalización.
• La cuenta atrás no aparece — comprueba que la fecha de lanzamiento use el formato AAAA-MM-DD HH:MM y esté en el futuro.
• Desinstalación — elimina la tabla de suscriptores: exporta antes el CSV si quieres conservar las direcciones.