Preguntas frecuentes sobre PrestaShop: solución de errores comunes

Introducción: ¿Por qué aparecen errores en PrestaShop?

Si tienes una tienda online con PrestaShop, es probable que en algún momento te hayas encontrado con algún mensaje de error o un comportamiento inesperado. No te preocupes, es completamente normal. PrestaShop es una plataforma muy potente y flexible, pero como cualquier sistema complejo, puede presentar problemas si no se configura o mantiene adecuadamente.

En esta guía extensa de FAQ PrestaShop, vamos a resolver las dudas PrestaShop más habituales y te daremos soluciones paso a paso para los errores PrestaShop comunes. Nuestro objetivo es que puedas solucionar la mayoría de los problemas por ti mismo, sin necesidad de ser un experto técnico.

Vamos a empezar con los errores más frecuentes, desde problemas de instalación hasta conflictos con módulos y temas.

---

1. Errores durante la instalación de PrestaShop

1.1. "Error 500" o "Página en blanco" al instalar

Este es uno de los errores PrestaShop comunes más frustrantes. Una pantalla en blanco suele indicar un error interno del servidor que no se muestra por seguridad.

Causas principales:

• Límite de memoria PHP insuficiente: PrestaShop necesita un mínimo de 128 MB de memoria PHP.
• Versión de PHP incorrecta: PrestaShop 1.7 requiere PHP 7.1 o superior (recomendado PHP 7.4 o 8.0 para versiones recientes).
• Permisos de archivos incorrectos: Los archivos de instalación deben tener permisos 755 o 644.

Solución paso a paso:

1. Aumenta el límite de memoria PHP:
   • Si usas Syspanel (acceso por puerto 2106), busca la sección de "PHP" o "Configuración de PHP". Allí podrás ajustar el valor de memory_limit a 256M o 512M.
   • Si no tienes acceso a Syspanel, crea un archivo llamado php.ini en la raíz de tu tienda y añade la línea: memory_limit = 256M.
2. Comprueba la versión de PHP:
   • Desde Syspanel (puerto 2106), ve a "Versión de PHP" y selecciona una versión compatible (7.4 o 8.0 suelen ser seguras).
3. Verifica los permisos de archivos:
   • Los directorios deben tener permisos 755 y los archivos 644. Puedes hacerlo desde el administrador de archivos de Syspanel o mediante FTP.

[TIP] Si después de estos pasos sigues viendo la pantalla en blanco, activa la visualización de errores de PHP añadiendo estas líneas al archivo config/defines.inc.php de PrestaShop (antes de la instalación):
define(‘_PS_MODE_DEV_’, true);

1.2. "No se puede conectar con la base de datos"

Este error aparece cuando PrestaShop no logra comunicarse con MySQL.

Causas:

• Datos de conexión incorrectos (usuario, contraseña, nombre de BD).
• El servidor MySQL no está en ejecución.
• El usuario de la BD no tiene permisos sobre la base de datos.

Solución:

1. Verifica los datos de conexión:
   • Revisa el archivo app/config/parameters.php (o config/settings.inc.php en versiones antiguas). Asegúrate de que database_host, database_name, database_user y database_password sean correctos.
2. Crea la base de datos desde Syspanel:
   • Accede a Syspanel (puerto 2106), ve a "Base de datos" y crea una nueva base de datos y un usuario con todos los privilegios.
3. Comprueba el servicio MySQL:
   • En Syspanel, revisa que el servicio MySQL esté activo (verde). Si está apagado, inícialo.

---

2. Errores comunes en el Front Office (tienda visible)

2.1. "Error 404 - Página no encontrada" en categorías o productos

Esto sucede cuando las URL amigables (SEO) no se generan correctamente o hay conflictos con el archivo .htaccess.

Causas:

• Archivo .htaccess corrupto o faltante.
• URLs amigables desactivadas o mal configuradas.
• Módulos de SEO que interfieren.

Solución:

1. Regenera el archivo .htaccess:
   • Ve al Back Office de PrestaShop: Configuración avanzada > Rendimiento.
   • Haz clic en "Limpiar cache" y luego en "Guardar". Esto a menudo regenera el .htaccess.
2. Forzar la regeneración manual:
   • Si el paso anterior no funciona, elimina el archivo .htaccess de la raíz de tu tienda (haz una copia de seguridad primero).
   • Luego, en el Back Office, ve a Configuración de la tienda > Tráfico y SEO > SEO y URLs.
   • Desmarca y vuelve a marcar la opción "Amigable con SEO" y guarda. PrestaShop creará un nuevo .htaccess.
3. Verifica la configuración de URL:
   • En la misma sección, asegúrate de que la URL base de tu tienda sea correcta (sin barras al final).

2.2. "El carrito está vacío" o "No se pueden añadir productos"

Este es un error frustrante para los clientes y suele deberse a problemas con las cookies o el módulo de carrito.

Causas:

• Problemas con las cookies del navegador.
• Módulo de carrito desactivado o conflictivo.
• Configuración incorrecta de la sesión PHP.

Solución:

1. Limpia las cookies del navegador: Pide al cliente que borre las cookies de tu tienda y recargue la página.
2. Verifica el módulo de carrito:
   • En el Back Office, ve a Módulos > Gestor de módulos.
   • Busca "Carrito" y asegúrate de que el módulo "Bloque carrito" o "Carrito" esté instalado y activado.
3. Ajusta la configuración de la sesión:
   • En Configuración avanzada > Rendimiento, busca la opción "Guardar sesiones en la base de datos" y actívala. Esto suele resolver problemas de sesión en servidores compartidos.

[WARNING] Si el error persiste, desactiva todos los módulos no esenciales y cambia temporalmente al tema predeterminado (por ejemplo, "Classic") para descartar conflictos.

---

3. Errores en el Back Office (panel de administración)

3.1. "El Back Office está muy lento" o "No carga completamente"

La lentitud en el panel de administración es una queja muy común.

Causas:

• Demasiados módulos activos.
• Cache deshabilitada.
• Servidor con recursos limitados.
• Versión de PrestaShop desactualizada.

Solución:

1. Activa la cache de Smarty:
   • Ve a Configuración avanzada > Rendimiento.
   • En "Cache de Smarty", selecciona "Recompilar los archivos de plantilla si se han modificado".
   • Activa "Cache de la plantilla" y "Cache de la base de datos".
2. Reduce el número de módulos activos:
   • Desactiva los módulos que no uses. Cada módulo consume recursos.
3. Optimiza el servidor:
   • Desde Syspanel (puerto 2106), activa "OPcache" y "Memcached" si están disponibles.
   • Aumenta el límite de memoria PHP a 256M o 512M.
4. Actualiza PrestaShop: Las versiones antiguas suelen ser más lentas. Mantén tu tienda actualizada.

3.2. "Error al subir una imagen" o "El producto no se guarda"

Esto suele ocurrir por límites de tamaño de archivo o configuraciones de PHP.

Causas:

• El tamaño de la imagen supera el límite permitido por PHP (upload_max_filesize).
• El tiempo de ejecución de PHP es demasiado corto (max_execution_time).

Solución:

1. Aumenta los límites de PHP:
   • En Syspanel (puerto 2106), busca la configuración de PHP y aumenta:
     • upload_max_filesize a 20M o 50M.
     • post_max_size a 20M o 50M.
     • max_execution_time a 300 segundos.
2. Comprime las imágenes antes de subirlas: Usa herramientas online o Photoshop para reducir el peso de las imágenes a menos de 1 MB.

---

4. Problemas con módulos y temas

4.1. "El módulo no se puede instalar" o "Da error al activar"

Los módulos de terceros son una fuente frecuente de errores PrestaShop comunes.

Causas:

• El módulo no es compatible con tu versión de PrestaShop.
• Conflicto con otro módulo o tema.
• El módulo requiere una extensión PHP específica (ej. cURL, JSON, GD).

Solución:

1. Verifica la compatibilidad: Revisa la ficha del módulo para asegurarte de que es compatible con tu versión de PrestaShop (1.6, 1.7, 8.x).
2. Activa el modo de depuración:
   • Abre el archivo config/defines.inc.php y cambia define(‘_PS_MODE_DEV_’, false); a define(‘_PS_MODE_DEV_’, true);.
   • Así verás el error exacto que impide la instalación.
3. Desactiva otros módulos: Temporalmente, desactiva todos los módulos excepto el que quieres instalar. Si funciona, reactívalos uno por uno para encontrar el conflicto.
4. Comprueba las extensiones PHP:
   • En Syspanel (puerto 2106), ve a "PHP" y asegúrate de que extensiones como curl, json, gd, mbstring estén habilitadas.

4.2. "El tema se ve roto" o "Aparecen errores visuales"

Un tema mal diseñado o incompatible puede romper la tienda.

Causas:

• El tema no está actualizado para tu versión de PrestaShop.
• El tema usa características no compatibles con tu configuración de PHP.
• Archivos CSS o JS no se cargan correctamente.

Solución:

1. Cambia al tema predeterminado: Temporalmente, activa el tema "Classic" (o el que venga por defecto). Si el problema desaparece, el fallo es del tema.
2. Actualiza el tema: Contacta al desarrollador para obtener una versión compatible.
3. Limpia la cache del tema:
   • En el Back Office: Configuración avanzada > Rendimiento.
   • Haz clic en "Limpiar cache" y luego en "Guardar".
4. Desactiva la compresión CSS/JS:
   • En la misma sección, desmarca las opciones "Comprimir CSS" y "Comprimir JavaScript". A veces la compresión causa errores visuales.

---

5. Errores de SEO y URLs

5.1. "Las URLs de mis productos no se ven bien" o "Tienen números extraños"

Esto se debe a que las URLs amigables no están configuradas correctamente.

Causa:

• La opción "Amigable con SEO" está desactivada o mal configurada.

Solución:

1. Activa las URLs amigables:
   • Ve a Configuración de la tienda > Tráfico y SEO > SEO y URLs.
   • Marca la opción "Amigable con SEO".
2. Configura las rutas de URL:
   • En la misma sección, en "Esquema de URL", puedes personalizar cómo se ven las URLs de productos, categorías y páginas. Por ejemplo, para productos: {category:/}{id}-{rewrite}.

5.2. "Google no indexa mis páginas" (Problemas de SEO)

Un error común es que los motores de búsqueda no encuentren tu tienda.

Causas:

• El archivo robots.txt bloquea a los bots de Google.
• El módulo de SEO no está bien configurado.
• Hay páginas con contenido duplicado.

Solución:

1. Revisa el archivo robots.txt:
   • Ve a la raíz de tu tienda y abre robots.txt. Asegúrate de que no tenga líneas como Disallow: / (eso bloquearía todo).
2. Configura las meta etiquetas:
   • En cada producto y categoría, ve a la pestaña "SEO" y rellena los campos "Meta título" y "Meta descripción" con texto único y relevante.
3. Activa el módulo de Google Analytics/Google Search Console:
   • Instala el módulo oficial de Google y enlaza tu tienda a Search Console para monitorear errores de rastreo.

---

6. Problemas de rendimiento y velocidad

6.1. "Mi tienda carga muy lento"

La velocidad es clave para las ventas. Unos segundos de retraso pueden hacer perder clientes.

Causas:

• Imágenes sin optimizar.
• Demasiados módulos activos.
• Servidor con poca memoria.
• Cache desactivada.

Solución:

1. Optimiza las imágenes:
   • Usa herramientas como TinyPNG o Imagify para comprimir las imágenes sin perder calidad.
   • En PrestaShop, ve a Configuración avanzada > Rendimiento > Imágenes y ajusta la calidad al 80%.
2. Activa la cache de página:
   • En Configuración avanzada > Rendimiento, activa "Cache de página" y selecciona "Sistema de archivos".
3. Usa una CDN (Red de Distribución de Contenidos):
   • Muchos hosts ofrecen CDN gratuita. Actívala desde Syspanel (puerto 2106) o desde el módulo de tu hosting.
4. Reduce los módulos activos: Desactiva todo lo que no sea esencial.

6.2. "La base de datos se ha vuelto enorme"

Con el tiempo, la base de datos puede acumular datos innecesarios (logs, carritos abandonados, etc.).

Causa:

• PrestaShop guarda muchos registros por defecto.

Solución:

1. Limpia la base de datos:
   • Ve al Back Office: Configuración avanzada > Base de datos > SQL Manager.
   • Ejecuta consultas para eliminar datos viejos (por ejemplo, DELETE FROM ps_connections WHERE date_add < DATE_SUB(NOW(), INTERVAL 30 DAY)).
2. Usa un módulo de limpieza: Existen módulos gratuitos como "Advanced Database Cleaner" que automatizan esta tarea.

---

7. Errores de seguridad

7.1. "Mi tienda ha sido hackeada" o "Aparecen archivos extraños"

La seguridad es crítica en el comercio electrónico.

Causas:

• Versión de PrestaShop desactualizada.
• Contraseñas débiles.
• Módulos o temas de fuentes no confiables.

Solución:

1. Actualiza PrestaShop inmediatamente: Siempre a la última versión estable.
2. Cambia todas las contraseñas: Incluyendo la del Back Office, FTP, base de datos y Syspanel.
3. Escanea tu tienda:
   • Desde Syspanel (puerto 2106), muchos paneles tienen un escáner de malware. Ejecútalo.
   • Instala un módulo de seguridad como "PrestaShop Security" o "Wordfence" (si es compatible).
4. Revisa los archivos modificados:
   • Compara los archivos de tu tienda con los originales de PrestaShop. Puedes descargar una copia limpia de la