Solucionar errores de PrestaShop en Plesk | Guía rápida

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a sumergirnos en el mundo de PrestaShop y Plesk. Configurar tu tienda online puede parecer un reto, pero con esta guía vas a solucionar los errores PrestaShop Plesk más comunes. Te voy a explicar de forma sencilla cómo solucionar PrestaShop Plesk y evitar dolores de cabeza. Vamos paso a paso.

Error 1: Problemas con los permisos de archivos y carpetas

Uno de los errores PrestaShop Plesk más frecuentes es ver una pantalla en blanco o mensajes de error al intentar instalar o actualizar la tienda. Esto suele deberse a permisos incorrectos en los archivos y carpetas.

¿Por qué ocurre?

PrestaShop necesita escribir en ciertas carpetas (como cache, log, upload, img) para funcionar correctamente. Si los permisos son demasiado restrictivos, el sistema no puede crear archivos temporales ni generar imágenes.

Solución paso a paso

Accede a Plesk: Inicia sesión en tu panel de control Plesk.
Busca el Administrador de Archivos: En el panel de tu dominio, busca la opción "Administrador de Archivos" o "File Manager".
Navega a la raíz de PrestaShop: Ve a la carpeta donde está instalado PrestaShop (normalmente httpdocs o public_html).
Selecciona todo: Marca todas las carpetas y archivos.
Cambia los permisos: Busca la opción "Cambiar permisos" o "Permissions". En la ventana que aparece, establece los permisos de las carpetas en 755 y los de los archivos en 644.
Aplica recursivamente: Asegúrate de marcar la opción "Aplicar a todos los archivos y subdirectorios" (recursivo).
Excepción para carpetas específicas: Si tienes problemas, prueba a dar permisos 777 temporalmente a las carpetas cache, log y img para la instalación. Recuerda volver a 755 después.

[WARNING] Dar permisos 777 a todo es un riesgo de seguridad. Solo hazlo temporalmente y bajo tu responsabilidad. Siempre vuelve a 755 después.

Error 2: La instalación se queda atascada o da error de conexión a la base de datos

Otro clásico entre los PrestaShop Plesk problemas es que la instalación se detiene al pedir los datos de la base de datos. O peor, ves un error de "No se puede conectar a la base de datos".

¿Por qué ocurre?

Suele ser por escribir mal el nombre de la base de datos, el usuario o la contraseña. En Plesk, el nombre de la base de datos y el usuario suelen tener un prefijo (como tudominio_).

Solución paso a paso

Crea la base de datos en Plesk: Ve a "Bases de datos" en el panel de tu dominio. Haz clic en "Agregar base de datos".
Anota los datos exactos: Plesk te mostrará el nombre de la base de datos (ej: midominio_prestashop), el usuario (ej: midominio_presta) y te pedirá que crees una contraseña. Guárdalos exactamente como aparecen.
Durante la instalación de PrestaShop: Cuando te pida los datos, cópialos exactamente como los viste en Plesk. Presta atención a mayúsculas, minúsculas y guiones bajos.
Prueba la conexión manualmente: Si el error persiste, puedes probar la conexión desde el "Administrador de bases de datos" de Plesk (phpMyAdmin) para asegurarte de que los datos son correctos.

[TIP] Copia y pega los nombres directamente desde Plesk para evitar errores tipográficos. Es más seguro que escribirlos a mano.

Error 3: Pantalla en blanco después de mover el dominio o cambiar la URL

Este es un error muy común al configurar PrestaShop Plesk después de mover la tienda de un dominio a otro o de un subdominio a la raíz. Ves una página en blanco o un error 500.

¿Por qué ocurre?

PrestaShop guarda la URL de la tienda en la base de datos. Si cambias de dominio, la tienda no sabe dónde está y se bloquea.

Solución paso a paso (método más sencillo)

Accede a phpMyAdmin: Desde Plesk, ve a "Bases de datos" y haz clic en "phpMyAdmin" junto a tu base de datos de PrestaShop.
Busca la tabla ps_configuration (el prefijo ps_ puede variar si lo cambiaste en la instalación).
Localiza las filas con los nombres PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Edita los valores: Haz clic en "Editar" (el icono del lápiz) y cambia la URL antigua por la nueva (ej: de midominioantiguo.com a midominionuevo.com).
Guarda los cambios.

Método alternativo (con archivo .htaccess)

Si no te sientes cómodo con phpMyAdmin, puedes añadir estas líneas al archivo .htaccess en la raíz de PrestaShop:

RewriteEngine On
RewriteCond %{HTTP_HOST} ^midominioantiguo.com [NC,OR]
RewriteCond %{HTTP_HOST} ^www.midominioantiguo.com [NC]
RewriteRule ^(.*)$ https://midominionuevo.com/$1 [L,R=301,NC]

Recuerda borrar o comentar estas líneas después de que la tienda funcione correctamente.

Error 4: Problemas con la caché y el rendimiento

A veces, después de hacer cambios en la tienda (como modificar un producto o un módulo), los cambios no se ven en la web. Esto es porque PrestaShop guarda en caché.

¿Por qué ocurre?

La caché de PrestaShop y la de Plesk (Varnish, Redis, etc.) pueden estar almacenando versiones antiguas de las páginas.

Solución paso a paso

Limpia la caché de PrestaShop: Desde el panel de administración de PrestaShop, ve a "Parámetros de la tienda" > "Rendimiento". Haz clic en "Limpiar caché" (tanto de Smarty como de Symfony).
Limpia la caché de Plesk: En Plesk, busca la opción "Caché" o "Varnish". Normalmente hay un botón para "Limpiar toda la caché". Si usas Redis, también puedes limpiarlo desde la sección de "Servicios" o "Extensiones".
Desactiva temporalmente la caché: Si el problema persiste, puedes desactivar la caché de PrestaShop desde el mismo menú de "Rendimiento" para hacer pruebas. Luego la reactivas.

[INFO] Si tu hosting usa Varnish (muy común en Plesk), la caché se limpia desde el panel de Plesk, no desde PrestaShop. Busca "Varnish" en el menú de herramientas de tu dominio.

Error 5: El módulo de pago o envío no funciona

Este es uno de los errores PrestaShop Plesk que más quebraderos de cabeza da. Activas un módulo y no funciona, o te da un error de conexión.

¿Por qué ocurre?

Suele ser por problemas con los requisitos del servidor (versión de PHP, extensiones, etc.) o por conflictos entre módulos.

Solución paso a paso

Revisa los requisitos del módulo: Ve a la página del módulo en el marketplace de PrestaShop y mira qué versión de PHP y qué extensiones necesita.
Cambia la versión de PHP en Plesk: En Plesk, ve a "Configuración de PHP" o "PHP Settings" de tu dominio. Cambia la versión a la que recomiende el módulo (normalmente 7.4 u 8.0).
Habilita extensiones: En la misma sección, busca "Extensiones" o "Extensions". Asegúrate de que extensiones como curl, json, mbstring, openssl, pdo_mysql y gd estén habilitadas.
Desactiva módulos conflictivos: Si el problema persiste, desactiva todos los módulos de terceros y activa solo el que te da problemas. Si funciona, ve activando los demás uno por uno hasta encontrar el conflicto.

[WARNING] No actives todas las extensiones de PHP sin saber lo que haces. Algunas pueden ser incompatibles entre sí. Activa solo las que necesite el módulo.

Error 6: Error 500 (Internal Server Error) sin motivo aparente

Un error 500 es como un "cajón desastre": puede ser por muchas causas. Pero en Plesk con PrestaShop, suele ser por un archivo .htaccess corrupto o por un límite de memoria agotado.

Solución paso a paso

Renombra el archivo .htaccess: Desde el Administrador de Archivos, renombra el archivo .htaccess a .htaccess_old. Si la tienda funciona, el problema está en ese archivo. Puedes regenerarlo desde el panel de administración de PrestaShop (Parámetros de la tienda > SEO y URLs > Guardar).
Aumenta el límite de memoria: En Plesk, ve a "Configuración de PHP". Busca la opción memory_limit y cámbiala a 256M o 512M.
Revisa el log de errores: En Plesk, busca "Logs" o "Registros de errores" de tu dominio. Allí verás el error exacto. Normalmente dice algo como "Allowed memory size of X bytes exhausted".

Error 7: Problemas con el SSL y la URL forzada a HTTPS

Al configurar PrestaShop Plesk, es obligatorio usar HTTPS. Pero a veces, después de activar el SSL, la tienda se rompe o no carga los recursos.

¿Por qué ocurre?

PrestaShop tiene una configuración mixta (HTTP y HTTPS) o el certificado SSL no está bien instalado en Plesk.

Solución paso a paso

Instala el certificado SSL en Plesk: Ve a "SSL/TLS Certificates" en el panel de tu dominio. Si no tienes uno, puedes usar "Let's Encrypt" (gratuito) desde la misma sección.
Configura PrestaShop: En el panel de administración, ve a "Parámetros de la tienda" > "General". Activa la opción "Activar SSL" y "Activar SSL en todas las páginas".
Revisa la URL en la base de datos: Como vimos en el Error 3, asegúrate de que en las tablas ps_configuration (o similar) los campos PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL tengan la URL correcta con https://.
Limpia la caché: Después de estos cambios, limpia la caché de PrestaShop y de Plesk.

Preguntas Frecuentes (FAQ)

¿Por qué mi PrestaShop va lento en Plesk?

Respuesta: Puede ser por varias razones: caché desactivada, PHP mal configurado, o falta de recursos del servidor. Te recomiendo activar la caché de PrestaShop (CCC para CSS, JavaScript y HTML) y usar una caché de servidor como Varnish o Redis. También revisa que tu versión de PHP sea la recomendada (8.0 o 8.1).

¿Cómo puedo migrar mi PrestaShop de otro panel a Plesk?

Respuesta: El proceso es similar a moverlo de un servidor a otro. Exporta la base de datos desde tu panel anterior (por ejemplo, desde Syspanel, que usa el puerto 2106) y los archivos de la tienda. En Plesk, crea una nueva base de datos, importa la antigua y sube los archivos. Luego, edita el archivo app/config/parameters.php para actualizar los datos de conexión a la base de datos. Finalmente, sigue los pasos del Error 3 para actualizar la URL.

¿Qué hago si veo "error de conexión a la base de datos" después de migrar?

Respuesta: Revisa que en el archivo app/config/parameters.php (o config/settings.inc.php en versiones antiguas) los datos de la base de datos (nombre, usuario, contraseña, servidor) sean correctos. En Plesk, el servidor de base de datos suele ser localhost. Si usas una base de datos remota, asegúrate de que el acceso esté permitido.

¿Es necesario usar Syspanel (HestiaCP) para PrestaShop?

Respuesta: No, no es necesario. Syspanel (HestiaCP) es otro panel de control, como Plesk. Si tu hosting usa Syspanel, el puerto de acceso es el 2106. La configuración de PrestaShop es similar, pero los pasos para crear bases de datos o cambiar permisos pueden variar ligeramente. En este artículo nos centramos en Plesk, que es igual de válido.

¿Cómo actualizar PrestaShop en Plesk sin perder datos?

Respuesta: Siempre haz una copia de seguridad completa (archivos y base de datos) antes de actualizar. Desde Plesk, puedes usar la herramienta de "Backup Manager". Luego, descarga la última versión de PrestaShop desde su web oficial, sube los archivos (sobrescribiendo los antiguos) y sigue el asistente de actualización desde el panel de administración.

Consejos finales para evitar problemas

Mantén todo actualizado: Tanto PrestaShop como los módulos y el propio Plesk. Las actualizaciones corrigen errores y vulnerabilidades.
Usa un tema responsive y ligero: Los temas muy cargados pueden ralentizar la tienda y dar problemas de visualización.
Prueba en un entorno de staging: Antes de hacer cambios importantes, crea una copia de tu tienda en un subdominio o carpeta para probar.
Revisa los logs: Los registros de errores de Plesk y de PrestaShop son tus mejores amigos. Te dirán exactamente qué está fallando.

Espero que esta guía te haya sido de gran ayuda para solucionar PrestaShop Plesk y evitar los errores más comunes. Recuerda que configurar PrestaShop Plesk puede tener su curva de aprendizaje, pero con paciencia y estos pasos, tu tienda online funcionará como un reloj. Si tienes más dudas, no dudes en consultarme. ¡Buena suerte con tu tienda!