Soluciones a problemas frecuentes de PrestaShop en Syspanel

Si estás gestionando tu tienda online con PrestaShop desde el panel Syspanel, es probable que en algún momento te encuentres con algún contratiempo. No te preocupes: la mayoría de los problemas PrestaShop Syspanel tienen una explicación sencilla y una solución aún más sencilla. En esta guía extensa y práctica, vamos a repasar los errores más comunes, por qué ocurren y cómo resolverlos paso a paso.

¿Por qué ocurren estos problemas en Syspanel?

Syspanel (basado en HestiaCP, accesible a través del puerto 2106) es un panel de control potente, pero a veces la configuración predeterminada de PrestaShop puede chocar con algunos parámetros del servidor. La buena noticia es que la mayoría de las soluciones PrestaShop Syspanel se resuelven ajustando permisos de archivos, configurando correctamente los módulos o modificando ligeramente los archivos de configuración del sistema.

Problema 1: Error 500 o página en blanco al acceder a la tienda

Este es uno de los errores PrestaShop Syspanel más frecuentes. La pantalla se queda en blanco o muestra un error 500 sin más detalles.

Causas principales

Archivos con permisos incorrectos.
Falta de memoria PHP asignada.
Módulo conflictivo o mal instalado.

Solución paso a paso

Accede a Syspanel a través de tu navegador usando https://tudominio.com:2106 e inicia sesión.
Ve a la sección "Archivos" o "Administrador de archivos".
Localiza la carpeta raíz de tu PrestaShop (normalmente public_html).
Selecciona todos los archivos y carpetas y haz clic en "Permisos".
Establece los siguientes permisos estándar:
- Carpetas: 755
- Archivos: 644
- Carpeta config y cache: 755
- Archivo settings.inc.php: 644
Guarda los cambios y recarga la tienda.

[TIP] Si el error persiste, desde Syspanel ve a "Ajustes del servidor" > "PHP" y aumenta el límite de memoria a 256M o 512M.

Problema 2: No se pueden instalar o actualizar módulos

Otro clásico entre los problemas PrestaShop Syspanel es que al intentar instalar un módulo desde el backoffice, aparece un mensaje de error como "No se puede descargar el archivo" o "Permiso denegado".

Causas principales

Falta de permisos de escritura en la carpeta modules.
El servidor no permite la conexión externa para descargas.
El módulo requiere extensiones PHP no activadas.

Solución paso a paso

Desde Syspanel, ve a "Administrador de archivos" y navega hasta public_html/modules.
Asegúrate de que la carpeta modules tenga permisos 755.
Si el módulo ya está subido manualmente, comprueba que su carpeta individual también tenga 755.
Ve a "Ajustes del servidor" > "PHP" y activa las extensiones:
- curl
- openssl
- zip
- gd
Guarda y reinicia el servicio PHP desde la misma sección.

[WARNING] Si sigues sin poder instalar módulos, descarga el archivo ZIP del módulo, súbelo manualmente a public_html/modules mediante el administrador de archivos de Syspanel y descomprímelo allí. Luego actívalo desde el backoffice de PrestaShop.

Problema 3: Imágenes no se cargan o muestran error

Las imágenes rotas son un problema visual muy molesto y suelen deberse a configuraciones de URL o permisos.

Causas principales

La URL de la tienda no está bien configurada en la base de datos.
La carpeta img tiene permisos incorrectos.
El servidor no genera las miniaturas correctamente.

Solución paso a paso

Desde Syspanel, ve a "Base de datos" y accede a phpMyAdmin.
Busca la tabla ps_configuration (o el prefijo que uses).
Localiza las filas PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Asegúrate de que contengan tu dominio exacto (sin http:// ni https://), por ejemplo: tutienda.com.
Guarda los cambios.
Vuelve a Syspanel y en "Administrador de archivos" ve a public_html/img.
Cambia los permisos de toda la carpeta img a 755.
Regenera las miniaturas desde el backoffice de PrestaShop: "Parámetros de la tienda" > "Imágenes" > "Regenerar miniaturas".

[INFO] Si el problema persiste, verifica que el módulo de redimensionamiento de imágenes de PHP (GD) esté activado en los ajustes de PHP de Syspanel.

Problema 4: La tienda está muy lenta o se cae con frecuencia

La lentitud es uno de los errores PrestaShop Syspanel que más afectan a las ventas. Puede deberse a varios factores del servidor.

Causas principales

Poco límite de procesos PHP.
Sin caché activada.
Base de datos sin optimizar.

Solución paso a paso

En Syspanel, ve a "Ajustes del servidor" > "PHP".
Aumenta el límite de ejecución a 120 segundos y el límite de memoria a 512M.
Activa el caché de PrestaShop desde el backoffice: "Parámetros avanzados" > "Rendimiento" > "Caché" y elige "Sistema de archivos".
Desde Syspanel, en "Base de datos", selecciona tu base de datos y haz clic en "Optimizar".
Si tienes muchos productos, considera activar "Combinar y comprimir CSS y JavaScript" en la misma sección de rendimiento.

[TIP] Si tu tienda recibe mucho tráfico, desde Syspanel puedes activar "Modo de producción" en la configuración de PrestaShop para deshabilitar logs innecesarios.

Problema 5: Error de conexión a la base de datos

Este error aparece de repente y bloquea toda la tienda. Es uno de los problemas PrestaShop Syspanel que más asustan, pero tiene solución.

Causas principales

Cambio de contraseña de la base de datos desde Syspanel.
Archivo settings.inc.php dañado o con datos incorrectos.
La base de datos ha superado el límite de conexiones.

Solución paso a paso

Desde Syspanel, ve a "Base de datos" y anota el nombre de usuario y la contraseña actual de tu base de datos.
Accede al "Administrador de archivos" y navega a public_html/config/settings.inc.php.
Abre el archivo y busca las líneas:
- define('_DB_SERVER_', 'localhost');
- define('_DB_NAME_', 'nombre_base');
- define('_DB_USER_', 'usuario_base');
- define('_DB_PASSWD_', 'contraseña');
Verifica que coincidan exactamente con los datos de Syspanel.
Si la contraseña ha cambiado, actualízala.
Guarda el archivo y recarga la tienda.

[WARNING] Si el error persiste, desde Syspanel ve a "Ajustes del servidor" > "Base de datos" y aumenta el límite de conexiones simultáneas a 100 o más.

Problema 6: El certificado SSL no funciona correctamente

Muchas tiendas necesitan HTTPS para funcionar bien, pero a veces aparecen errores de contenido mixto o el candado no aparece.

Causas principales

La URL de la tienda no está actualizada a HTTPS.
Hay imágenes o scripts cargados con HTTP.
El certificado SSL no está bien instalado en Syspanel.

Solución paso a paso

En Syspanel, ve a "Dominios" y selecciona tu dominio.
En la pestaña "SSL", asegúrate de que el certificado esté activo y marcado como "Forzar HTTPS".
Desde el backoffice de PrestaShop, ve a "Parámetros de la tienda" > "Tráfico y SEO".
Cambia la URL de la tienda a https://tudominio.com.
Activa la opción "Redirigir a HTTPS".
Para solucionar contenido mixto, instala el módulo gratuito "SSL Redirect" desde el backoffice o edita manualmente el archivo .htaccess en la raíz añadiendo:
```
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
```

[INFO] Si el certificado SSL no se instala automáticamente en Syspanel, puedes solicitar uno gratuito desde la sección "SSL" del dominio o subir uno manualmente.

Problema 7: Error al enviar correos (contacto, pedidos, etc.)

Los correos son vitales para una tienda, pero a veces fallan sin previo aviso.

Causas principales

El servidor no permite envío de correos SMTP.
Configuración incorrecta en PrestaShop.
Puerto SMTP bloqueado.

Solución paso a paso

Desde el backoffice de PrestaShop, ve a "Parámetros avanzados" > "Email".
Cambia el método de envío a "SMTP".
Introduce los datos de tu servidor SMTP (puedes usar Gmail, SendGrid o el servidor local).
Si usas el servidor local de Syspanel, los datos suelen ser:
- Servidor: localhost
- Puerto: 25
- Sin autenticación (o con tu usuario de Syspanel)
Haz clic en "Enviar un email de prueba" para verificar.
Si falla, desde Syspanel ve a "Ajustes del servidor" > "Servicios" y asegúrate de que el servicio "Exim" (o el servidor de correo) esté activo.

[TIP] Para mayor fiabilidad, te recomiendo usar un servicio SMTP externo como SendGrid o Mailgun. Desde Syspanel puedes configurar las credenciales en los ajustes de correo.

Preguntas frecuentes (FAQ)

¿Cómo accedo a Syspanel?

Solo tienes que escribir en tu navegador https://tudominio.com:2106 y usar las credenciales que te proporcionó tu proveedor de hosting.

¿Puedo cambiar la versión de PHP desde Syspanel?

Sí, en "Ajustes del servidor" > "PHP" puedes seleccionar la versión de PHP que necesites. PrestaShop 1.7 requiere PHP 7.1 o superior, y PrestaShop 8 necesita PHP 8.0 o superior.

¿Qué hago si no recuerdo la contraseña de la base de datos?

En Syspanel, ve a "Base de datos" y selecciona tu base de datos. Allí puedes ver el usuario y restablecer la contraseña. Luego actualiza el archivo settings.inc.php.

¿Es seguro usar Syspanel para gestionar PrestaShop?

Sí, siempre que mantengas tu panel actualizado y uses contraseñas seguras. Además, Syspanel incluye herramientas de seguridad como firewall y backups automáticos.

¿Puedo hacer una copia de seguridad desde Syspanel?

Por supuesto. Ve a "Backups" y programa copias automáticas diarias o semanales. También puedes descargar un backup manual en cualquier momento.

Consejos finales para evitar errores PrestaShop Syspanel

Para minimizar los problemas PrestaShop Syspanel en el futuro, sigue estas buenas prácticas:

Actualiza PrestaShop y los módulos regularmente desde el backoffice.
Revisa los permisos de archivos después de cada actualización.
Mantén la versión de PHP que recomiende PrestaShop (consulta la documentación oficial).
Realiza backups semanales desde Syspanel.
No instales módulos de fuentes no confiables, ya que suelen ser la causa de muchos errores.

Recuerda que Syspanel es una herramienta muy completa y, con un poco de práctica, podrás resolver la mayoría de los errores PrestaShop Syspanel por ti mismo. Si algún problema se complica, no dudes en contactar con tu proveedor de hosting o con el soporte técnico de Syspanel, proporcionando siempre una descripción detallada del error y los pasos que ya has intentado.

Esperamos que esta guía te haya sido de gran ayuda. ¡Tu tienda online volverá a funcionar como un reloj!