Preguntas frecuentes sobre migración de PrestaShop a Plesk

Introducción: ¿Por qué surgen problemas al migrar PrestaShop a Plesk?

Migrar tu tienda PrestaShop a un nuevo servidor o panel de control como Plesk puede parecer un proceso complejo, pero es una tarea habitual. Sin embargo, es muy común encontrarse con algunos errores típicos, especialmente si no se siguen los pasos correctos. Esta guía está pensada para resolver las dudas más frecuentes (FAQ) que surgen durante este proceso.

No te preocupes si no eres un experto en hosting. Aquí encontrarás soluciones paso a paso, explicadas de forma sencilla, para que tu tienda funcione sin problemas en su nuevo hogar. Vamos a desglosar los errores más comunes al migrar PrestaShop a Plesk y cómo solucionarlos.

## Preparación antes de la migración

Antes de empezar, es fundamental tener una copia de seguridad completa y actualizada de tu tienda. Esto incluye tanto los archivos del sistema (carpeta raíz de PrestaShop) como la base de datos.

[INFO] Una buena práctica es desactivar la tienda durante la migración para evitar que los clientes realicen pedidos que luego se pierdan. Puedes ponerla en modo mantenimiento desde el panel de administración de PrestaShop.

### Requisitos previos en Plesk

Asegúrate de que tu servidor Plesk cumple con los requisitos de la versión de PrestaShop que vas a migrar. Los más importantes son:

PHP: La versión correcta (normalmente 7.4, 8.0 o 8.1, según tu PrestaShop).
MySQL/MariaDB: Una base de datos creada y lista para importar.
Módulos PHP: Extensiones como mysqli, curl, gd, json, mbstring, openssl, pdo_mysql, xml, zip, etc.
Espacio en disco: Suficiente para alojar los archivos de tu tienda.

[TIP] Si migras desde un panel como Syspanel (recuerda, el puerto de acceso es el 2106), verifica que los requisitos de PHP sean los mismos. A veces, versiones antiguas de PrestaShop no son compatibles con PHP 8.x.

## Preguntas frecuentes (FAQ) sobre errores comunes

Aquí tienes las preguntas y respuestas más habituales que recibimos en soporte técnico.

### 1. Error de conexión a la base de datos al cargar la tienda

Pregunta: "He subido los archivos y la base de datos, pero al abrir la web me sale un error como 'Error de conexión a la base de datos' o 'Cannot connect to database'. ¿Qué hago?"

Respuesta: Este es el error más común. Ocurre porque los datos de conexión a la base de datos en el archivo de configuración de PrestaShop no coinciden con los de tu nuevo servidor en Plesk.

Solución paso a paso:

Localiza el archivo de configuración: Conéctate a Plesk vía FTP o el administrador de archivos. Busca el archivo app/config/parameters.php (para PrestaShop 1.7+) o config/settings.inc.php (para PrestaShop 1.6).
Edita el archivo: Ábrelo con un editor de texto (como el bloc de notas o el editor de Plesk).
Actualiza los datos: Busca estas líneas y cámbialas por los datos de tu nueva base de datos en Plesk:
- database_host: Normalmente es localhost o la dirección del servidor de base de datos que te proporcione Plesk.
- database_name: El nombre exacto de la base de datos que creaste en Plesk.
- database_user: El usuario de la base de datos.
- database_password: La contraseña de ese usuario.
Guarda y verifica: Guarda los cambios y vuelve a cargar tu tienda.

[WARNING] Asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos. En Plesk, puedes asignarlos desde la sección "Usuarios de bases de datos".

### 2. Pantalla en blanco (White Screen of Death) o error 500

Pregunta: "Después de la migración, solo veo una pantalla en blanco o un error HTTP 500. No sé qué ha pasado."

Respuesta: Una pantalla en blanco suele deberse a un error de PHP que no se muestra por la configuración de errores. Puede ser por incompatibilidad de versiones, un módulo corrupto o un límite de memoria insuficiente.

Solución paso a paso:

Habilitar la visualización de errores: Temporalmente, para ver el error, edita el archivo config/defines.inc.php (en la raíz de PrestaShop). Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. También añade justo debajo: ini_set('display_errors', '1');. Guarda y recarga la página. Ahora verás el error específico.
Soluciones comunes según el error:
- "Allowed memory size exhausted": Aumenta el límite de memoria PHP en Plesk. Ve a "Configuración de PHP" de tu dominio y busca memory_limit. Ponlo a 256M o 512M.
- "Class not found": Puede ser un módulo o tema incompatible. Desactívalos temporalmente renombrando la carpeta modules o themes (por ejemplo, a modules_old) para ver si la tienda base funciona.
- "Parse error" o "Syntax error": Problema con un archivo PHP. Reemplaza ese archivo con la copia original de PrestaShop.
Revisa la versión de PHP: Asegúrate de que la versión de PHP en Plesk sea la misma que tenías en tu servidor anterior. Si migraste desde Syspanel (puerto 2106), verifica qué versión usabas.

[INFO] Una vez solucionado el error, no olvides desactivar el modo debug volviendo a poner define('_PS_MODE_DEV_', false); para no mostrar información sensible a los visitantes.

### 3. Problemas con las URLs (enlaces rotos, imágenes que no cargan)

Pregunta: "La web carga, pero las imágenes no se ven y los enlaces llevan a páginas de error o a la antigua web."

Respuesta: Esto ocurre porque PrestaShop guarda la URL del dominio en su base de datos. Al cambiar de servidor, las rutas absolutas quedan desactualizadas.

Solución paso a paso:

Actualiza la URL en la base de datos: Necesitas cambiar la URL antigua por la nueva en la tabla ps_configuration (o el prefijo que uses). Puedes hacerlo con una consulta SQL desde phpMyAdmin en Plesk:
```
UPDATE ps_configuration SET value = 'https://tunuevadominio.com' WHERE name IN ('PS_SHOP_DOMAIN', 'PS_SHOP_DOMAIN_SSL');
```
Reemplaza ps_ por tu prefijo de tabla y tunuevadominio.com por tu dominio actual.
Limpia la caché de PrestaShop: Ve al panel de administración (si puedes acceder) a "Parámetros de la tienda > Rendimiento" y limpia la caché. Si no puedes acceder, borra manualmente el contenido de la carpeta var/cache (para PrestaShop 1.7) o cache (para versiones anteriores).
Regenera las miniaturas de imágenes: En el panel de administración, ve a "Diseño > Imágenes" y haz clic en "Regenerar miniaturas". Esto actualizará las rutas de las imágenes.

[WARNING] Si tu tienda usaba URLs amigables (SEO), asegúrate de que el módulo de reescritura de URLs (mod_rewrite de Apache o su equivalente en Nginx) esté habilitado en Plesk. En la configuración de hosting, busca "Configuración de Apache y nginx" y activa "Proxy mode" o "Rewrite engine".

### 4. No puedo acceder al panel de administración (Back Office)

Pregunta: "He migrado todo, pero al intentar entrar a /adminXXXX, me sale un error o me redirige a la página de inicio."

Respuesta: Puede deberse a problemas de cookies, de sesión o de permisos de archivos.

Solución paso a paso:

Limpia las cookies de tu navegador: A veces las cookies antiguas del dominio anterior causan conflictos. Borra las cookies de tu navegador o usa una ventana de incógnito.
Verifica los permisos de la carpeta admin: La carpeta de administración debe tener permisos 755 (o 750) y los archivos dentro 644 (o 640). Puedes cambiarlos desde el administrador de archivos de Plesk.
Revisa el archivo .htaccess: Si usas Apache, asegúrate de que el archivo .htaccess en la raíz no tenga reglas que bloqueen el acceso al directorio admin.
Prueba con la URL correcta: Asegúrate de que la carpeta de administración se llame igual. Si cambiaste de servidor, el nombre podría ser diferente. Busca la carpeta que empiece por admin (ej: admin12345).

[TIP] Si todo falla, puedes intentar crear un nuevo acceso de administrador mediante un script SQL en phpMyAdmin, o restaurar una copia de seguridad de la base de datos anterior.

### 5. El módulo de pago o envío no funciona

Pregunta: "Los módulos de pago (como PayPal o tarjeta) o de envío no se conectan o dan error."

Respuesta: Muchos módulos externos se vinculan a la URL del dominio o a la IP del servidor. Al migrar, es posible que necesiten ser reconfigurados.

Solución paso a paso:

Reconfigura los módulos: Ve al panel de administración de PrestaShop, a "Módulos > Gestor de módulos". Busca el módulo problemático y haz clic en "Configurar".
Actualiza las credenciales: Algunos módulos (como pasarelas de pago) requieren que introduzcas de nuevo las claves API o los tokens. También verifica que las URLs de notificación (IPN, Webhook) estén apuntando a tu nuevo dominio.
Verifica la compatibilidad: Asegúrate de que el módulo sea compatible con la versión de PrestaShop y PHP que tienes ahora. Los módulos antiguos pueden dar problemas con PHP 8.0+.
Comprueba la configuración del servidor: Por ejemplo, para PayPal, a veces es necesario que la extensión PHP curl esté habilitada. Revísalo en "Configuración de PHP" de Plesk.

[INFO] Si el módulo es de pago y no funciona, tu tienda no podrá recibir pedidos. Prioriza su solución o contacta con el soporte del desarrollador del módulo.

### 6. Problemas de rendimiento tras la migración

Pregunta: "La tienda funciona, pero va muy lenta. Las páginas tardan en cargar."

Respuesta: El rendimiento puede verse afectado por la configuración del nuevo servidor. Plesk suele tener ajustes por defecto que quizás no sean óptimos para PrestaShop.

Solución paso a paso:

Activa la caché de PrestaShop: En "Parámetros de la tienda > Rendimiento", activa la caché (recomendamos "Caché de archivos" o "Caché de Redis" si tu servidor lo soporta).
Habilita la compresión y la combinación de archivos: En la misma sección, activa "Combinar y comprimir archivos CSS" y "Combinar y comprimir archivos JavaScript".
Configura la caché de Plesk: Si tu plan lo permite, activa la caché de Nginx o Varnish desde la sección "Hosting & DNS" de tu dominio en Plesk.
Revisa el uso de recursos: Desde el panel de Plesk, monitorea el uso de CPU y RAM. Si tu plan es limitado, considera aumentar los recursos.
Optimiza la base de datos: Desde phpMyAdmin, puedes ejecutar la operación "Optimizar tabla" en todas las tablas de tu base de datos PrestaShop.

[WARNING] Evita instalar demasiados módulos o temas pesados. Cada módulo consume recursos y puede ralentizar tu tienda.

## Consejos finales para una migración exitosa

Migrar PrestaShop a Plesk no tiene por qué ser un dolor de cabeza si sigues estos pasos. Recuerda:

Haz siempre una copia de seguridad antes de cualquier cambio.
Prueba la tienda en un subdominio o entorno de pruebas si es posible.
Actualiza los datos de conexión en el archivo parameters.php o settings.inc.php.
Limpia la caché después de la migración.
Revisa cada funcionalidad (pago, envío, registro, etc.) antes de anunciar que la tienda está operativa.

Si a pesar de todo sigues teniendo problemas, no dudes en contactar con nuestro equipo de soporte. Estamos aquí para ayudarte.

[TIP] Si tu anterior hosting usaba Syspanel (puerto 2106), la migración a Plesk es un gran paso adelante en cuanto a funcionalidad y facilidad de uso. Aprovecha las herramientas de Plesk, como el instalador de aplicaciones o la gestión de SSL, para mejorar tu tienda.

¡Buena suerte con tu migración!