Cómo habilitar el modo de mantenimiento en WordPress y solucionar problemas

Tu sitio de WordPress acaba de mostrarte una pantalla blanca durante la actualización. Los visitantes ven CSS medio renderizado, códigos cortos rotos y ese mensaje encantador «Error al establecer conexión con la base de datos». ¿Te resulta familiar?

El modo de mantenimiento de WordPress existe para prevenir exactamente esto. Muestra una página de mantenimiento temporal mientras realizas cambios en segundo plano. Actualizaciones, rediseños, migraciones de base de datos, parches de seguridad: cualquier cosa que pueda hacer que tu sitio parezca roto para el mundo exterior.

Esta guía cubre tres formas de habilitar el modo de mantenimiento de WordPress, desde plugins de un clic hasta ediciones manuales de código. También abordaremos cómo solucionar un sitio que está atascado en modo de mantenimiento, porque esto sucede más a menudo de lo que a nadie le gustaría admitir.

Ya sea que gestiones un pequeño blog o una tienda de WooCommerce procesando pedidos reales, el principio es el mismo: no permitas que los visitantes vean la zona de obras. Una configuración limpia del modo de mantenimiento de WP lleva cinco minutos. Reparar el daño en el SEO causado por una actualización fallida en producción lleva semanas.

Cuándo usar el modo de mantenimiento de WordPress

No todos los cambios requieren modo de mantenimiento. ¿Una falta de ortografía en una entrada del blog? Solo edita y publica. Pero hay una lista clara de escenarios donde omitir el modo de mantenimiento te costará caro. Si alguna vez has visto a Google Search Console registrar un aumento en errores de rastreo justo después de realizar cambios en un sitio en producción, ya entiendes por qué esto es importante.

• Actualizaciones importantes de núcleo, tema o plugin. La incompatibilidad entre una nueva versión de plugin y tu tema puede romper toda la interfaz. Los visitantes no deberían ver eso.
• Rediseños completos del sitio. Cambiar de tema mientras los visitantes navegan crea un lío desordenado y medio estilizado. El modo de mantenimiento mantiene el aspecto antiguo hasta que el nuevo esté listo.
• Optimización de rendimiento y de base de datos. Ejecutar una limpieza exhaustiva de base de datos o una revisión de caché mientras los usuarios acceden al sitio puede provocar tiempos de espera y consultas corruptas.
• Auditorías de seguridad y eliminación de malware. Si estás eliminando scripts inyectados, lo último que quieres es que los visitantes los activen mientras trabajas.
• Cambios estructurales en el contenido. Cambiar las URL, eliminar páginas o reorganizar la taxonomía de tu sitio puede desencadenar cascadas de errores 404 y penalizaciones de SEO si los bots rastrean el sitio durante el proceso de cambio.
• Tiempo de inactividad planificado. Migraciones de servidor, actualizaciones de hosting, cambios de certificados SSL. Una página de mantenimiento es más profesional que un tiempo de espera de conexión.

Una distinción crítica: el modo de mantenimiento no es una página de «próximamente». Una página de próximamente es para sitios que aún no existen. El modo de mantenimiento es para sitios en vivo que necesitan tiempo de inactividad temporal. Diferentes códigos de estado HTTP, diferentes señales SEO, diferentes expectativas de usuario. El modo de mantenimiento debería devolver una cabecera 503 Servicio no disponible, lo que indica a los motores de búsqueda «vuelvan más tarde, esto es temporal». Una página de próximamente típicamente devuelve un 200 OK y está diseñada para crear anticipación y recopilar inscripciones de correo electrónico para un lanzamiento futuro.

Para mantener las ventanas de mantenimiento breves, prueba los cambios primero en un entorno de staging de WordPress. Un sitio de staging es un clon de tu sitio de producción donde puedes romper cosas libremente. Ejecuta tus actualizaciones ahí, confirma que todo funciona correctamente y luego despliégalas en producción con el modo de mantenimiento activado solo durante los pocos minutos que se tarda en publicar los cambios.

Tres formas de habilitar el modo de mantenimiento de WP

Hay tres enfoques prácticos para poner WordPress en modo de mantenimiento. Van desde «instalar un plugin y activar un interruptor» hasta «editar manualmente los archivos de configuración del servidor». Elige el que coincida con tu nivel de comodidad y tus requisitos. Cada método tiene pros y contras. Los plugins son los más fáciles pero añaden una dependencia. El código personalizado es ligero pero depende del tema. El método .htaccess es el más potente, pero requiere conocimientos a nivel de servidor. Aquí te explico cómo funciona cada uno, paso a paso.

Usando un plugin de modo de mantenimiento para WordPress

Para la mayoría de los propietarios de sitios, un plugin de modo de mantenimiento de WordPress es la opción correcta. Sin código que escribir, sin archivos que editar, y obtienes una página de mantenimiento personalizable desde el primer momento. Los mejores plugins de modo de mantenimiento de WordPress te permiten diseñar una página que realmente parece intencionada, no como si tu sitio se hubiera caído. Porque la percepción importa: una página de mantenimiento de marca transmite que estamos trabajando en mejoras, mientras que una pantalla de error blanca transmite que algo salió mal y nadie está atendiendo.

Una página de mantenimiento sólida debería incluir algunas cosas: un mensaje claro que explique la inactividad, tu logo para coherencia de marca, un temporizador de cuenta regresiva o el tiempo estimado de regreso, un formulario de suscripción para notificar a los visitantes cuando el sitio esté de vuelta y enlaces a tus cuentas sociales como una forma alternativa de contactarte. Algunos propietarios de sitios omiten todo esto y simplemente ponen una línea. Eso técnicamente funciona, pero se desaprovecha la oportunidad de mantener el interés de los visitantes.

Dos plugins dominan este espacio. Veamos ambos.

Cómo configurar la página de mantenimiento de SeedProd

SeedProd es un constructor de páginas freemium que incluye una función dedicada de modo de mantenimiento. La versión gratuita incluye edición por arrastrar y soltar y una biblioteca de plantillas. Los planes de pago (a partir de aproximadamente 39,50 USD/año) desbloquean más plantillas, además de constructores personalizados de páginas 404 y de inicio de sesión.

Aquí está la configuración:

1. Instala y activa SeedProd desde el directorio de complementos de WordPress.
2. Navega a la pestaña de SeedProd en tu panel de WordPress y haz clic en «Configurar una página de modo de mantenimiento».
3. Elige una plantilla de la biblioteca. Personalízala arrastrando y soltando: intercambia imágenes, edita texto, añade bloques de cuenta regresiva.
4. Haz clic en «Vista previa» para comprobar el diseño, luego en «Guardar».
5. Cuando salgas del editor, SeedProd pregunta si deseas activar el modo de mantenimiento. Confirma y verifica que el panel muestre «Modo de mantenimiento: Activo».
6. Cuando termines de trabajar, apaga la configuración desde el panel de SeedProd.

Todo el proceso lleva alrededor de cinco minutos. La principal limitación de la versión gratuita es una biblioteca de plantillas más pequeña, pero puedes crear una página de mantenimiento de WordPress personalizada desde cero si ninguno de los ajustes preestablecidos coincide con tu marca. SeedProd también te permite controlar qué roles de usuario pueden omitir el modo de mantenimiento, para que tu equipo de contenido pueda seguir iniciando sesión y trabajar mientras los visitantes ven la pantalla de mantenimiento.

Cómo configurar LightStart para WP Maintenance

LightStart (anteriormente WP Maintenance Mode) toma un enfoque diferente. En lugar de su propio constructor, se integra con el editor de bloques nativo de WordPress. Es menos vistoso que SeedProd, pero se siente familiar si ya conoces Gutenberg.

LightStart depende de Otter Blocks para sus funciones basadas en bloques, así que espera que ese plugin se instale automáticamente durante la configuración.

Guía de configuración:

1. Instala y activa LightStart desde el directorio de plugins.
2. En la configuración de LightStart, selecciona el tipo de página Modo de mantenimiento y continúa.
3. Configura la pestaña General. Las configuraciones clave: establece el estado en «Activado», habilita la excepción para los bots de búsqueda (selecciona «Sí» para mantener tus posiciones SEO durante el tiempo de inactividad), define qué roles de usuario aún pueden acceder al backend y frontend, y añade las páginas o direcciones IP que desees excluir del modo de mantenimiento.
4. Abre la pestaña de Diseño. Importa una plantilla inicial, luego personalízala en el editor de bloques de WordPress como cualquier otra página.
5. Revisa la pestaña de Módulo si deseas que el seguimiento de Google Analytics esté activo durante el mantenimiento.
6. La pestaña de Gestionar Bot permite configurar un flujo de chat para capturar contactos por correo electrónico mientras el sitio está inactivo. Opcional pero útil.

Recuerda restablecer el estado a Desactivado una vez que tu sitio esté listo para salir en vivo. Es fácil olvidar este paso, especialmente después de una larga sesión de mantenimiento. He visto sitios estar en modo de mantenimiento durante días porque alguien olvidó activar el interruptor. Configura un recordatorio en el calendario si es necesario.

Habilitar el modo de mantenimiento con código personalizado

Los plugins añaden sobrecarga. Si ya estás usando más de 30 plugins y tu tiempo de carga es preocupantemente alto, añadir otro no es lo ideal. La ruta manual te proporciona el modo de mantenimiento de WordPress sin dependencias de plugins, consultas innecesarias a la base de datos o pantallas de advertencia de actualización.

Este método utiliza una función PHP personalizada en el archivo functions.php de tu tema. Se enlaza a la acción get_header de WordPress y muestra un mensaje de mantenimiento sencillo a cualquiera que no sea un administrador conectado. El fragmento completo tiene alrededor de diez líneas. No ganará ningún premio de diseño, pero hace el trabajo de manera limpia.

Aquí está el código:

// Activate WordPress Maintenance Mode
function wp_maintenance_mode() {
  if (!current_user_can('edit_themes') || !is_user_logged_in()) {
    wp_die('<h1>Under Maintenance</h1><br />We are improving our site. Back soon.');
  }
}
add_action('get_header', 'wp_maintenance_mode');

Añade este fragmento al final del archivo functions.php de tu tema activo. Accede a él mediante el gestor de archivos de tu proveedor o a través de FTP con un cliente como FileZilla.

La desventaja: esto depende del tema. Si cambias de tema, el código permanece en el archivo del tema anterior. Si deseas que persista en los cambios de tema, usa un tema hijo y añade el código al functions.php del hijo en su lugar.

Para desactivar el modo de mantenimiento, elimina el fragmento de código y guarda. Eso es todo.

Realiza una copia de seguridad de tu sitio antes de editar cualquier archivo de tema. Un paréntesis mal colocado en functions.php hará que tu sitio muestre una pantalla en blanco.

Activa el modo de mantenimiento a través de .htaccess

El método .htaccess funciona a nivel de servidor, lo que lo hace independiente de tu tema de WordPress, plugins o incluso de WordPress mismo. Es la mejor opción para configuraciones de WordPress multisitio donde necesitas que cada subsitio esté en mantenimiento simultáneamente.

El proceso tiene dos partes: crea una página de mantenimiento en HTML y luego añade las reglas de redirección a .htaccess.

Primero, crea un archivo llamado maintenance.html con tu mensaje personalizado. Una versión básica:

<!DOCTYPE html>
<html><head><title>Maintenance</title></head>
<body><h1>We'll Be Right Back</h1>
<p>Improving the site. Back shortly.</p></body></html>

Sube maintenance.html a tu directorio public_html. Luego abre .htaccess (se encuentra en el mismo directorio raíz) y añade estas reglas por encima de la línea # FIN WordPress:

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_URI} !^/maintenance\.html$
RewriteRule ^(.*)$ https://yourdomain.com/maintenance.html [R=307,L]

Sustituye yourdomain.com por tu dominio real. El indicador R=307 envía una redirección temporal, lo que indica a los motores de búsqueda que esto no es permanente. Esto es importante para el SEO. Un 301 indicaría un movimiento permanente, y los motores de búsqueda comenzarían a desindexar tus páginas. El indicador R=307 conserva tus posiciones mientras la página de mantenimiento está activa.

Una ventaja de este enfoque sobre el método functions.php: funciona incluso si WordPress está dañado. Si una mala actualización de plugin bloqueó toda tu instalación de WP, la redirección de .htaccess se activa porque Apache la procesa antes de que WordPress se cargue. Eso lo convierte en un buen recurso de respaldo en tu caja de herramientas.

Cuando el mantenimiento esté terminado, elimina las reglas de reescritura de .htaccess. Deja maintenance.html en el servidor si lo deseas; no causará ningún problema dejarlo ahí.

Sitio de WordPress atascado en modo de mantenimiento: cómo solucionarlo

Ejecutaste una actualización de plugin, tu navegador se cerró a mitad del proceso, y ahora tu sitio de WordPress muestra «Brevemente no disponible para mantenimiento programado. Vuelve en un minuto.» Eso fue hace 45 minutos. Tu cliente está llamando. Tu panel de analíticas muestra una línea plana.

Esto es lo que ocurrió: WordPress crea un archivo llamado .maintenance en tu directorio raíz (public_html) cada vez que ejecuta actualizaciones. Cuando la actualización se completa, WordPress elimina ese archivo. Si la actualización se interrumpe por un cierre inesperado del navegador, un tiempo de espera del servidor o una pérdida de conexión, el archivo permanece. Y tu sitio de WordPress permanece atascado en modo de mantenimiento hasta que alguien lo elimine manualmente.

La solución es sencilla:

1. Conéctate a tu servidor a través del Administrador de archivos o FTP.
2. Navega a tu directorio raíz (public_html).
3. Busca el archivo .maintenance y elimínalo.
4. Recarga tu sitio. Debería volver.

Si no hay ningún archivo .maintenance visible (está oculto por defecto en algunos gestores de archivos; activa «mostrar archivos ocultos»), el problema probablemente es un conflicto de plugin o de tema. Aquí es donde la resolución de problemas se vuelve tediosa, pero existe un proceso de depuración sistemático que funciona siempre:

• Cambia el nombre de la carpeta /wp-content/plugins/ a /wp-content/plugins_disabled/ mediante FTP. Esto desactiva todos los plugins a la vez.
• Si el sitio carga, devuelve el nombre original a la carpeta y reactiva los plugins uno por uno hasta encontrar el culpable.
• Si aún no carga, intenta lo mismo con tu carpeta de temas. Cambia a un tema por defecto (como Twenty Twenty-Four) para aislar el problema.

Para prevenir que esto vuelva a ocurrir:

• No cierres la pestaña del navegador mientras se ejecutan las actualizaciones de WordPress. Ve a hacerte un café, pero deja la pestaña abierta.
• Actualiza los plugins uno a la vez, no en bloque. Las actualizaciones en bloque aumentan la probabilidad de un tiempo de espera. Habilita las actualizaciones automáticas de WordPress para lanzamientos menores para reducir la carga manual.
• Comprueba tu espacio en disco. Las actualizaciones que fallan a mitad del proceso suelen deberse a almacenamiento insuficiente. Si tu plan de hosting tiene poco espacio, es hora de limpiar o mejorar. Realiza una rápida revisión en tu panel de hosting; cualquier cifra por debajo de 500 MB de espacio libre supone un riesgo real para las actualizaciones.

Si has probado todo y el sitio todavía no puede salir del modo de mantenimiento, revisa los registros de errores de tu servidor. Se encuentran en tu panel de control de hosting con nombres como «Registro de errores» o «Acceso en bruto». El registro te dirá exactamente qué archivo o proceso falló, lo cual es mucho más útil que adivinar.

FAQ sobre el modo de mantenimiento de WordPress