Mostrar una página de mantenimiento y compartir acceso de vista previa

Usa Maintenance mode en Settings → POM Tweaks → Content → Maintenance para reemplazar las páginas públicas del frontend mientras el trabajo está en curso. Los administradores del sitio configuran la página y pueden compartir un enlace de vista previa privado con revisores que no tienen una cuenta de WordPress.

Los usuarios que han iniciado sesión siguen viendo el sitio normal. Los visitantes que no han iniciado sesión y no tienen acceso de vista previa válido reciben la página de mantenimiento con HTTP 503, una sugerencia de reintento de una hora e instrucciones para no almacenar en caché ni indexar esa respuesta.

Configurar la página de mantenimiento

  1. Activa Maintenance mode y selecciona Save.
  2. Establece Browser tab title.
  3. Elige Custom HTML o Existing page en Display.
  4. Para el modo personalizado, introduce el marcado del cuerpo en Maintenance HTML y los estilos en Maintenance CSS. Se admite HTML seguro; los scripts no forman parte de este campo.
  5. Para el modo de página, introduce Maintenance page ID. Usa una página publicada sin contraseña. Su plantilla de página y su contenido aparecen en la URL solicitada por el visitante; los visitantes no son redirigidos al enlace permanente de esa página.
  6. Mantén HTML y CSS adecuados configurados como alternativa. Una página que no exista, sea privada, esté protegida con contraseña o no esté disponible usa esta alternativa en lugar de exponer el contenido original solicitado.
  7. Guarda y, a continuación, purga las cachés de página existentes y comprueba el resultado en un navegador con la sesión cerrada.

En multisitio, el ajuste se aplica solo al sitio actual. El ID de página debe pertenecer a ese sitio. La página de HTML personalizado es independiente; el modo de página usa la plantilla de página del tema activo y sus integraciones.

Dar acceso de vista previa temporal a un revisor

  1. En Preview token, mantén el valor generado o selecciona Generate new preview token.
  2. Selecciona Save antes de usar o compartir el nuevo enlace.
  3. Usa Preview website with saved token. Los administradores del sitio también ven Preview website en el aviso de mantenimiento.
  4. Copia el enlace para el revisor al que va destinado. Cualquiera que lo tenga puede previsualizar el frontend público, así que mantenlo privado.
  5. Pide al revisor que lo abra en el navegador que usará para las pruebas. Tras la validación, el token se elimina de la barra de direcciones y ese navegador puede navegar por el sitio durante dos días.

La cookie de vista previa se limita al sitio actual y no está disponible para JavaScript. Solo se envía por HTTPS cuando el sitio usa HTTPS. Un nuevo enlace válido reemplaza el acceso de vista previa obsoleto. El acceso de vista previa no inicia sesión al revisor, no concede un rol de administración ni desbloquea contenido de WordPress que, por separado, requiera autenticación o contraseña.

El enlace en sí sigue siendo válido hasta que cambie su token; la duración de dos días se aplica a la cookie de vista previa de cada navegador. Selecciona Generate new preview token y guarda para revocar los enlaces y las cookies antiguos. Borra Preview token y guarda para desactivar por completo los enlaces de vista previa. Cuando una cookie caduca, volver a abrir un enlace todavía válido inicia otra sesión de dos días.

Alcance y almacenamiento en caché

El mantenimiento cubre las peticiones de plantillas del frontend, incluidas las peticiones de feed que llegan a WordPress. El inicio de sesión, la administración, REST, AJAX, el cron y las operaciones de línea de comandos siguen estando disponibles. Los archivos subidos y las respuestas servidas directamente por un servidor web o una CDN no pasan por este ajuste. Se trata de una función de presentación temporal, no de un límite de control de acceso para información confidencial.

El módulo evita el almacenamiento en caché de las respuestas que gestiona, incluidas los intercambios de token y las vistas previas. Las cachés existentes del servidor, de la CDN o de página completa pueden responder antes de que se ejecute WordPress: púrgalas o ponlas en pausa al activar el mantenimiento y asegúrate de que no sirven páginas públicas almacenadas ni almacenan en caché las respuestas de vista previa. Vuelve a purgar después de desactivar el mantenimiento para que los visitantes vean de inmediato el sitio normal.

Si una CDN o un proxy inverso reenvía solo cookies seleccionadas, permite que las wordpress_pom_maintenance_* cookies de vista previa lleguen a WordPress y excluye de la caché de páginas compartida las peticiones que las incluyan. La cookie de vista previa es independiente de las cookies de inicio de sesión de WordPress y no inicia sesión al visitante. Las cookies del navegador deben permanecer habilitadas, incluso en una ventana privada; abre de nuevo el enlace de vista previa guardado al iniciar una nueva sesión de navegación privada.

Verificar y finalizar

  1. Con la sesión cerrada y sin una cookie de vista previa, visita la página de inicio y otra página. Ambas deberían mostrar el mantenimiento.
  2. Abre el enlace de vista previa guardado, confirma que el token desaparece de la URL y sigue otro enlace interno. El sitio normal debería seguir visible.
  3. En otro navegador con la sesión cerrada, prueba un token incorrecto. No debe conceder acceso.
  4. Genera y guarda un token nuevo; el enlace anterior y la vista previa del navegador deberían dejar de funcionar. Comprueba el enlace nuevo.
  5. Si usas el modo de página, verifica su diseño y sus enlaces. Una página que pasa a ser privada o protegida con contraseña debería cambiar a la alternativa de HTML seguro.
  6. Cuando el trabajo esté listo, desactiva Maintenance mode, guarda y purga las cachés de página. No se requiere ninguna restauración de contenido ni de usuarios.

Si la vista previa falla, usa el enlace que coincide con el último token guardado, permite las cookies y mantén el mismo nombre de host y esquema HTTPS mientras navegas. Si el token desaparece pero el mantenimiento permanece, comprueba que tu CDN reenvía la cookie de vista previa y vuelve a abrir el enlace guardado. Una cookie de mantenimiento antigua sin procesar no es suficiente: vuelve a abrir el enlace de vista previa. Si los visitantes ven el sitio normal sin un token, comprueba si han iniciado sesión o si están recibiendo una respuesta almacenada en caché anterior.