Configurar modo mantenimiento en PrestaShop | Guía básica

Aquí tienes el artículo completo, en formato Markdown, con el tono didáctico y la estructura que necesitas.

¿Qué es el modo mantenimiento en PrestaShop y para qué sirve?

Imagina que estás reformando tu tienda física. Pones un cartel en la puerta que dice "Cerrado por obras". Pues bien, el modo mantenimiento de PrestaShop es exactamente ese cartel, pero para tu tienda online.

Cuando activas esta función, tu sitio web deja de ser visible para los clientes habituales. En lugar de ver los productos y poder comprar, los visitantes se encontrarán con una pantalla de mantenimiento (generalmente personalizable). Esto es esencial para realizar tareas delicadas sin que los usuarios se encuentren con errores, páginas a medio cargar o procesos de compra rotos.

¿Cuándo deberías usarlo?

Actualizaciones críticas: Al actualizar el núcleo de PrestaShop, un módulo o un tema.
Cambios de diseño: Cuando estás modificando la plantilla o la maquetación de la tienda.
Migraciones: Al mover la tienda a un nuevo servidor o cambiar de dominio.
Solución de errores: Si detectas un fallo de seguridad o un bug que afecta a la experiencia de usuario.
Ajustes de configuración: Modificar archivos sensibles como el .htaccess o el config/defines.inc.php.

Como SysAdmin, una de tus primeras lecciones es: nunca trabajes sobre una tienda en producción sin ponerla en mantenimiento. Podrías perder ventas, pero, lo que es peor, podrías generar desconfianza en tus clientes.

Método 1: Configurar el modo mantenimiento desde el Back Office (La vía fácil)

Este es el método recomendado para la mayoría de los usuarios. Es rápido, visual y no requiere tocar una sola línea de código.

Paso 1: Accede al panel de administración de PrestaShop

Abre tu navegador y dirígete a la URL de tu Back Office. Normalmente es algo como tudominio.com/adminXXXXX (donde las X son un código aleatorio). Introduce tu usuario y contraseña.

Paso 2: Navega hasta la configuración general

Una vez dentro, busca en el menú lateral izquierdo. Ve a la sección "Parámetros de la tienda" y luego haz clic en "General".

Paso 3: Localiza la opción "Mantenimiento"

Dentro de la pantalla de "General", verás varias pestañas en la parte superior. Haz clic en la pestaña que dice "Mantenimiento".

Paso 4: Activa el modo y personalízalo

Aquí tienes las opciones clave:

Activar el modo mantenimiento: Cambia el selector a "Sí".
IP de mantenimiento: Este es un campo muy importante. Aquí puedes añadir tu propia dirección IP. Si lo haces, tú podrás ver la tienda con normalidad (sin la pantalla de mantenimiento) mientras que el resto del mundo verá el cartel. Para saber tu IP, puedes buscar "cuál es mi IP" en Google.
Nombre de la tienda: El nombre que aparecerá en la pantalla de mantenimiento.
Texto personalizado: Aquí puedes escribir un mensaje amigable, como: "Estamos mejorando la tienda para ofrecerte una mejor experiencia. Vuelve en unos minutos".

[TIP] Usa el campo de IP de mantenimiento para no quedarte ciego. Si metes tu IP, podrás navegar por la tienda y comprobar que todo funciona mientras está en modo "oculto" para los demás.

Paso 5: Guarda los cambios

Una vez configurado, haz clic en el botón "Guardar" en la parte superior derecha. ¡Listo! Tu tienda ya está en modo mantenimiento.

Método 2: Configurar el modo mantenimiento vía FTP o cPanel (Para SysAdmins)

A veces, el Back Office puede fallar o estar bloqueado. Como buen SysAdmin, debes saber cómo forzar el mantenimiento desde el servidor.

Paso 1: Accede a los archivos de tu tienda

Conéctate a tu servidor mediante un cliente FTP (como FileZilla) o desde el administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).

Paso 2: Localiza el archivo de configuración

Navega hasta la carpeta raíz de tu PrestaShop. Normalmente es public_html o www. Dentro, busca el archivo llamado config/defines.inc.php.

Paso 3: Edita el archivo

Descarga el archivo o edítalo directamente desde el panel. Busca la siguiente línea:

define('_PS_MODE_DEV_', false);

Justo debajo de ella, añade esta línea:

define('_PS_MAINTENANCE_TASK_', true);

[WARNING] Este método es un "todo o nada". No podrás acceder tú mismo a la tienda a menos que también edites el archivo .htaccess. Es más seguro usar el Back Office si es posible.

Paso 4: Guarda y sube el archivo

Guarda los cambios y, si lo descargaste, vuelve a subir el archivo a la misma ubicación, sobrescribiendo el original.

Para desactivarlo, simplemente cambia true por false o borra la línea que añadiste.

Método 3: Usando la terminal (SSH) para SysAdmins avanzados

Si tienes acceso SSH a tu servidor, este es el método más rápido y profesional.

Paso 1: Conéctate por SSH

Usa tu terminal favorita (Putty, Terminal de Linux, etc.) y conéctate a tu servidor.

Paso 2: Usa el comando de PrestaShop

PrestaShop 1.7 y 8.x incluyen una consola de comandos (CLI). Ejecuta el siguiente comando desde la raíz de tu tienda:

php bin/console prestashop:maintenance --enable

Para desactivarlo:

php bin/console prestashop:maintenance --disable

Paso 3: Verifica el estado

Puedes comprobar si está activo con:

php bin/console prestashop:maintenance --status

[INFO] Si tu servidor usa Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso al panel es el 2106. Desde allí puedes gestionar tus sitios web y acceder a la terminal integrada si está disponible.

Solución de problemas comunes (FAQ)

1. "Me he quedado fuera de mi Back Office"

Esto puede pasar si activas el mantenimiento pero no pones tu IP correctamente, o si tu IP cambia (por ejemplo, si usas una VPN).

Solución: Accede por FTP o cPanel. Busca el archivo config/defines.inc.php y desactiva temporalmente el modo mantenimiento desde ahí (Método 2). Luego, vuelve a entrar al Back Office y configura bien la IP.

2. "Los motores de búsqueda están indexando mi pantalla de mantenimiento"

Si tienes el modo mantenimiento activado durante mucho tiempo, Google podría indexar esa página, lo cual es malo para el SEO.

Solución: No dejes el modo mantenimiento activo más de 24-48 horas. Además, desde el Back Office, asegúrate de que la opción "Índice de motores de búsqueda" esté en "No" (esto se suele configurar en Parámetros de la tienda > SEO y URLs).

3. "Mis clientes ven un error 500 en lugar de la pantalla de mantenimiento"

Esto suele ocurrir si el tema o un módulo no es compatible con la versión de PrestaShop.

Solución: Desactiva el modo mantenimiento. Luego, desactiva los módulos no esenciales o cambia temporalmente al tema por defecto (por ejemplo, "Classic"). Vuelve a activar el mantenimiento.

4. "¿Puedo personalizar más la pantalla de mantenimiento?"

Sí. El texto que pones en el Back Office se muestra, pero puedes ir más allá. Puedes editar el archivo themes/tu_tema/modules/ps_maintenance/ps_maintenance.tpl para cambiar el HTML y CSS de la página de mantenimiento.

[WARNING] Si editas el archivo .tpl directamente, perderás los cambios al actualizar el tema. Es mejor crear un sobreescribe en tu tema hijo si usas uno.

Conclusión y buenas prácticas

Configurar el modo mantenimiento en PrestaShop es una tarea sencilla pero crucial para cualquier SysAdmin. No importa si lo haces desde el Back Office, por FTP o por SSH; lo importante es hacerlo siempre antes de tocar algo crítico.

Resumen rápido para tu checklist:

Antes de la tarea: Activa el modo mantenimiento. Añade tu IP para poder probar.
Durante la tarea: Realiza los cambios (actualizaciones, migraciones, etc.).
Después de la tarea: Prueba que todo funciona correctamente (navega, haz un pedido de prueba, etc.).
Desactiva el modo mantenimiento.

Siguiendo esta guía, te asegurarás de que tu tienda PrestaShop esté siempre protegida y que la experiencia de tus clientes no se vea afectada por tus tareas de administración. ¡Manos a la obra!