Resolver problemas comunes de PrestaShop en Syspanel

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí, es porque tienes una tienda PrestaShop alojada en nuestro panel Syspanel y te has encontrado con algún problema. No te preocupes, es más común de lo que crees. En esta guía extensa y paso a paso, voy a ayudarte a resolver los errores más frecuentes de PrestaShop Syspanel. Vamos a ir desde lo más básico hasta soluciones un poco más técnicas, siempre con un lenguaje claro y sencillo.

Recuerda que tu panel de control es Syspanel, y accedes a él a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Ahora sí, ¡manos a la obra!

1. El error más común: "Error de conexión a la base de datos"

Este es, sin duda, el problema que más veces veo. Tu tienda PrestaShop no puede hablar con su base de datos, y por eso ves una pantalla en blanco o un mensaje de error.

¿Por qué ocurre?

• Cambiaste la contraseña de la base de datos desde Syspanel y no actualizaste el archivo de configuración de PrestaShop.
• La base de datos se llenó (sí, tiene un límite de espacio).
• El servidor de bases de datos (MySQL/MariaDB) se cayó temporalmente.

Cómo solucionarlo paso a paso:

1. Accede a Syspanel: Abre tu navegador y ve a https://tudominio.com:2106. Inicia sesión con tus credenciales de hosting.
2. Revisa el estado de la base de datos: Dentro de Syspanel, busca la sección "Base de datos" o "Bases de datos". Verifica que aparezca tu base de datos y que no esté en estado "caído" o "suspendido".
3. Comprueba el espacio usado: En la misma sección, mira el indicador de uso. Si está al 100%, tendrás que limpiar tablas (por ejemplo, eliminando registros de carritos abandonados muy antiguos) o contratar más espacio.
4. Actualiza la contraseña en PrestaShop: Si cambiaste la contraseña, necesitas editar el archivo config/settings.inc.php que está en la raíz de tu tienda. Conéctate por FTP o desde el administrador de archivos de Syspanel. Busca las líneas:

   define('_DB_SERVER_', 'localhost');
   define('_DB_NAME_', 'nombre_de_tu_bd');
   define('_DB_USER_', 'usuario_de_tu_bd');
   define('_DB_PASSWD_', 'contraseña_antigua');
   

   Cambia _DB_PASSWD_ por la nueva contraseña que pusiste en Syspanel.
5. Reinicia el servicio de base de datos (solo si eres avanzado): En Syspanel, a veces hay una opción para reiniciar MySQL/MariaDB. Si no la ves, contacta con soporte.

[TIP] Si no recuerdas la contraseña actual de la BD, en Syspanel puedes generar una nueva desde la opción "Cambiar contraseña" de la base de datos. Luego, aplica el paso 4.

2. Error de "Permiso denegado" al subir archivos o módulos

Este error aparece cuando intentas instalar un módulo, subir una imagen o actualizar la tienda, y te sale un mensaje como "No se puede escribir en el directorio" o "Permiso denegado".

¿Por qué ocurre?

• Los permisos de archivos y carpetas no son los correctos.
• El usuario del servidor web (www-data, por ejemplo) no tiene acceso a ciertas carpetas.

Solución rápida desde Syspanel:

1. Accede al administrador de archivos de Syspanel: Dentro de tu panel, busca "Archivos" o "File Manager". Navega hasta la raíz de tu PrestaShop (normalmente public_html o www).
2. Corrige permisos de carpetas clave: PrestaShop necesita que ciertas carpetas tengan permisos 755 (lectura y ejecución para todos, escritura solo para el dueño) y los archivos 644. Las carpetas críticas son:
   • /img
   • /modules
   • /themes
   • /var/cache
   • /config
   • /translations
   • /upload
   • /download
3. Cambia permisos recursivamente: En el administrador de archivos, selecciona la carpeta /modules, haz clic derecho y elige "Cambiar permisos". Pon 755 y marca la opción "Aplicar a subcarpetas y archivos". Haz lo mismo con /img y /themes.
4. Verifica el propietario: En Syspanel, a veces los archivos se quedan con un usuario incorrecto. Si ves que el propietario es "root" o alguien extraño, contacta con soporte para que lo reasignen a tu usuario de hosting.

[WARNING] No pongas permisos 777 (todos pueden escribir) en ninguna carpeta. Es un riesgo de seguridad enorme. Si un módulo te pide 777, busca otra alternativa.

3. "Error 500 Internal Server Error" después de una actualización

Este es un error genérico que puede aparecer al actualizar PrestaShop, instalar un módulo o modificar un archivo .htaccess. Es frustrante porque no da detalles.

Pasos para diagnosticar y solucionar:

1. Activa el modo debug de PrestaShop: Para ver el error real, edita el archivo config/defines.inc.php y cambia:

   define('_PS_MODE_DEV_', false);
   

   Por:

   define('_PS_MODE_DEV_', true);
   

   Guarda y recarga la tienda. Ahora verás un mensaje de error específico (por ejemplo, "Class not found" o "Fatal error: Allowed memory size exhausted").
2. Aumenta el límite de memoria PHP: Si el error dice algo de "memory size", necesitas subir el límite. En Syspanel, busca "PHP Settings" o "Configuración PHP". Aumenta memory_limit a 256M o incluso 512M. Guarda los cambios y reinicia el servicio PHP si es necesario.
3. Revisa el archivo .htaccess: A veces una actualización lo corrompe. Renómbralo a .htaccess_old y genera uno nuevo desde el back office de PrestaShop: ve a "Configuración avanzada" -> "Rendimiento" y haz clic en "Generar .htaccess".
4. Desactiva todos los módulos no esenciales: Si el error ocurrió tras instalar un módulo, conéctate por FTP a la carpeta /modules y renombra la carpeta del módulo problemático (por ejemplo, añadiendo _old al final). Esto lo desactivará.

[INFO] Si no puedes acceder al back office, haz los pasos 1 y 4 por FTP o desde el administrador de archivos de Syspanel.

4. La tienda carga muy lenta o da "timeout"

Una tienda lenta es mala para el SEO y para tus clientes. Puede deberse a varias causas.

Diagnóstico y soluciones:

1. Activa la caché de PrestaShop: En el back office, ve a "Configuración avanzada" -> "Rendimiento". Activa la caché (recomiendo "Sistema de archivos" o "Memcached" si tu plan lo soporta). También activa la compresión CCC para CSS, JavaScript y HTML.
2. Optimiza las imágenes: Las imágenes pesadas son el enemigo número uno. Usa un módulo de compresión o, manualmente, reduce el tamaño de las imágenes de producto (máximo 800x800 píxeles) y súbelas en formato WebP si es posible.
3. Revisa los logs de errores: En Syspanel, busca "Logs" o "Registros". Allí verás si hay errores de PHP o de base de datos que estén ralentizando todo. Por ejemplo, consultas lentas a la BD.
4. Actualiza PHP a una versión más rápida: En Syspanel, en "PHP Settings", puedes cambiar la versión de PHP. PrestaShop 1.7 funciona bien con PHP 7.4 o 8.0, y 8.1 es aún más rápido. Asegúrate de que sea compatible con tus módulos.
5. Desactiva módulos que no uses: Cada módulo consume recursos. Ve a "Módulos" -> "Catálogo de módulos" y desinstala los que no necesites.

[TIP] Si tu tienda tiene mucho tráfico, considera contratar un plan con más recursos o activar un CDN (Content Delivery Network) desde Syspanel.

5. Problema con la URL amigable (SEO) que no funciona

Las URLs amigables son clave para el SEO. Si al activarlas te sale un error 404 o la página no carga, aquí tienes la solución.

Pasos para arreglarlo:

1. Asegúrate de que el módulo mod_rewrite esté activo: En Syspanel, ve a "Configuración del servidor" o "Apache Settings". Busca "mod_rewrite" y actívalo. Si no ves la opción, contacta con soporte.
2. Regenera el .htaccess: Como en el punto 3, ve al back office -> "Configuración avanzada" -> "Rendimiento" y haz clic en "Generar .htaccess". Luego, en "Configuración de SEO y URLs", verifica que la opción "URLs amigables" esté activada.
3. Borra la caché de PrestaShop: En el mismo apartado de rendimiento, haz clic en "Limpiar caché".
4. Revisa que el dominio esté bien configurado: En Syspanel, asegúrate de que tu dominio apunte a la carpeta correcta (normalmente public_html). Si tienes subdominios, verifica que no haya conflictos.

6. Error "No se puede conectar al servicio de correo" (SMTP)

Si tus clientes no reciben correos de confirmación de pedido, o tú no recibes notificaciones, el problema suele ser la configuración SMTP.

Solución:

1. Usa el servidor SMTP de Syspanel: La mayoría de los planes incluyen un servidor de correo. En el back office de PrestaShop, ve a "Configuración avanzada" -> "Correo electrónico". Selecciona "Usar SMTP" y configura:
   • Servidor: mail.tudominio.com (o localhost si tu hosting lo permite).
   • Usuario: tu@email.com (el que creaste en Syspanel).
   • Contraseña: la de ese correo.
   • Puerto: 587 (con TLS) o 465 (con SSL).
2. Prueba con Gmail o un servicio externo: Si el correo del hosting no funciona, puedes usar SMTP de Gmail. Necesitarás una cuenta de Gmail y generar una "contraseña de aplicación" (no tu contraseña normal). Configura:
   • Servidor: smtp.gmail.com
   • Puerto: 587
   • Protocolo: TLS
   • Usuario: tucorreo@gmail.com
   • Contraseña: la contraseña de aplicación.
3. Verifica que el puerto no esté bloqueado: En Syspanel, algunos planes bloquean puertos SMTP por seguridad. Pregunta a soporte si puedes usar el puerto 587 o 465.

7. Preguntas frecuentes (FAQ) sobre PrestaShop Syspanel

¿Cómo accedo a Syspanel?

Ve a https://tudominio.com:2106 e inicia sesión con tu usuario y contraseña de hosting.

¿Puedo instalar módulos automáticamente desde Syspanel?

No directamente, pero puedes subir el archivo ZIP del módulo desde el back office de PrestaShop o desde el administrador de archivos de Syspanel.

Mi tienda se cae a ciertas horas, ¿qué hago?

Puede ser por picos de tráfico. Revisa los logs de Syspanel para ver si hay errores de recursos. También activa la caché y considera un plan superior.

¿Cómo hago una copia de seguridad?

En Syspanel, busca "Backup" o "Copias de seguridad". Puedes programar copias automáticas o hacer una manual. Guarda siempre una copia en tu PC.

[WARNING] Nunca subas archivos PHP sin revisarlos. Los módulos piratas o nulled suelen tener malware. Siempre descarga de fuentes oficiales.

Conclusión: No te asustes, todo tiene solución

Los problemas de PrestaShop Syspanel son normales, especialmente cuando haces cambios o actualizaciones. La clave está en ir paso a paso, sin prisas, y siempre teniendo una copia de seguridad antes de tocar nada. Si después de seguir estos pasos el error persiste, no dudes en contactar con nuestro equipo de soporte. Recuerda que estamos aquí para ayudarte, y que tu tienda es importante para nosotros.

Espero que esta guía te haya sido de gran ayuda. ¡Ahora ve y soluciona esos errores! Si tienes más dudas, déjalas en los comentarios o abre un ticket en Syspanel. ¡Feliz ventas!