Cómo solucionar el problema de imágenes que no cargan en PrestaShop

¿Por qué no se ven las imágenes en tu tienda PrestaShop?

Es una de las consultas más habituales: entras a tu tienda, actualizas un producto o simplemente navegas por el catálogo y, de repente, te encuentras con ese molesto recuadro gris con un icono de imagen rota. Las imágenes prestashop no cargan y esto, además de feo, puede hacer que tus clientes desconfíen de tu tienda y abandonen la compra.

Antes de que te agobies, respira. En la gran mayoría de los casos, este problema tiene una solución sencilla que no requiere ser un programador experto. En esta guía completa, vamos a desglosar, paso a paso y en un lenguaje claro, todas las causas posibles y cómo arreglarlas. Desde problemas de permisos hasta conflictos con la caché, pasando por errores de configuración de servidor.

Vamos a ello.

Primeros pasos: Diagnóstico rápido del error

Cuando te encuentras con prestashop imágenes rotas, lo primero que debes hacer es identificar el alcance del problema. No es lo mismo que fallen todas las imágenes del sitio a que solo fallen las de una categoría o producto concreto.

Para hacer un diagnóstico visual, haz clic derecho sobre la imagen rota y selecciona "Abrir imagen en una pestaña nueva". Observa la URL que aparece. Si ves algo como http://tutienda.com/img/p/1/2/3/123.jpg, anota esa ruta. Si la URL te lleva a un error 404, el archivo no existe en el servidor. Si te da un error 403, es un problema de permisos. Si la imagen se ve borrosa o a medias, puede ser un problema de caché o de regeneración.

Este pequeño truco te dará pistas sobre cuál de las soluciones siguientes necesitas aplicar.

Solución 1: Activar el modo de mantenimiento y limpiar la caché

Esta es la solución más común y la primera que debes probar. PrestaShop almacena una copia de las imágenes en una caché para que el sitio cargue más rápido. A veces, esa caché se corrompe o guarda versiones antiguas que ya no existen, lo que provoca que las imágenes no se muestren.

Sigue estos pasos:

1. Accede al panel de administración de tu PrestaShop (tuenda.com/admin).
2. Ve al menú Parámetros avanzados > Rendimiento.
3. En la parte superior, verás la opción Vaciar la caché. Haz clic en el botón "Vaciar la caché" (el icono de la papelera).
4. También puedes activar la opción Forzar la compilación (en la sección "Plantillas"). Déjala activa temporalmente y luego desactívala.
5. Guarda los cambios y recarga tu tienda para ver si las imágenes aparecen.

[TIP] Si usas una caché de terceros como Memcached o Redis, también deberías limpiarla desde su propio panel de control. A veces, la caché de PrestaShop se limpia, pero la del servidor sigue mostrando los datos antiguos.

Solución 2: Regenerar las miniaturas de las imágenes

Si la caché no ha funcionado, es probable que las miniaturas estén corruptas o no se hayan generado correctamente. Esto es muy común después de actualizar la versión de PrestaShop o de cambiar la plantilla (tema) de la tienda.

Para regenerar las imágenes, ve a:

1. Parámetros avanzados > Rendimiento.
2. Busca la pestaña o sección llamada Regenerar miniaturas.
3. Verás una lista de opciones. Lo más seguro es seleccionar la primera, que suele decir "Todas las imágenes". Si tienes muchas imágenes (más de 10,000), puede que esta opción dé error por tiempo de ejecución. En ese caso, selecciona solo las opciones de "Productos" y "Categorías".
4. Haz clic en el botón Regenerar y espera a que el proceso termine. Puede tardar varios minutos, así que ten paciencia.

[WARNING] Este proceso puede consumir muchos recursos del servidor. Si tu tienda tiene mucho tráfico, es recomendable hacerlo en horas de baja actividad o, si es posible, activar el modo de mantenimiento para evitar que los clientes vean errores temporales.

Solución 3: Comprobar los permisos de archivos y carpetas

Otra causa muy frecuente de error imágenes es que los permisos de las carpetas donde se guardan las imágenes no sean los correctos. PrestaShop necesita poder leer y, en ocasiones, escribir en estas carpetas para mostrar y generar las imágenes.

Las imágenes se guardan en la carpeta img en la raíz de tu instalación. Dentro de esta, hay subcarpetas como p (para productos), c (para categorías), m (para marcas), etc.

Debes asegurarte de que los permisos de estas carpetas sean 755 y que los archivos dentro de ellas sean 644. Si no sabes cómo cambiar esto, tienes dos opciones:

• Desde el Panel de Control (Syspanel): Accede a tu panel de control. Si tu hosting usa Syspanel, recuerda que el puerto de acceso es el 2106. Una vez dentro, busca el administrador de archivos. Selecciona la carpeta img, haz clic derecho y busca la opción "Permisos" o "Chmod". Introduce el valor 755 y aplica los cambios a todas las subcarpetas y archivos.
• Desde un cliente FTP (como FileZilla): Conéctate a tu servidor, navega hasta la carpeta img, haz clic derecho sobre ella y selecciona "Permisos de archivo". Marca la casilla que dice "Recursivo en subcarpetas" y establece el valor en 755. Aplica los cambios y repite el proceso, pero esta vez selecciona la opción "Recursivo en archivos" y pon el valor 644.

[INFO] Si tu tienda está en un servidor compartido, es posible que no puedas cambiar los permisos de forma recursiva. En ese caso, contacta con tu proveedor de hosting para que lo hagan ellos.

Solución 4: El problema del nombre de dominio y los enlaces permanentes

A veces, el problema no está en los archivos, sino en cómo PrestaShop genera las URL de las imágenes. Esto suele pasar si has cambiado el dominio de tu tienda recientemente o si has movido la instalación a un nuevo servidor.

PrestaShop guarda la URL absoluta de tu tienda en la base de datos. Si esa URL es incorrecta, las imágenes se buscarán en un lugar equivocado.

Para solucionarlo:

1. Ve a Parámetros avanzados > Rendimiento y en la parte inferior encontrarás el apartado URLs. Asegúrate de que el campo "Dominio de la tienda" y "Dominio SSL" sean correctos (sin http:// ni https://).
2. También revisa que la opción "Mantener las URLs amigables" esté activada y que el archivo .htaccess exista en la raíz de tu tienda. Si no existe, ve a Parámetros avanzados > Herramientas y haz clic en "Generar el archivo .htaccess".

Solución 5: Conflictos con módulos o plantillas (temas)

En ocasiones, un módulo de terceros o un tema mal configurado puede interferir con la carga de las imágenes. Para descartar esta posibilidad, debes hacer una prueba.

1. Ve a Parámetros avanzados > Rendimiento y en la sección "Plantillas", cambia temporalmente tu tema actual por el tema predeterminado de PrestaShop (por ejemplo, "classic").
2. Guarda los cambios y revisa tu tienda. Si las imágenes ahora cargan, el problema está en tu tema.
3. Si el problema persiste, ve a Módulos > Gestor de módulos y desactiva todos los módulos que no sean de PrestaShop (los que no son de la casa). Ve activándolos de uno en uno y refrescando la página para identificar al culpable.

[WARNING] Al cambiar de tema, es posible que la apariencia de tu tienda cambie temporalmente. No te preocupes, es solo una prueba. Una vez identificado el problema, puedes volver a tu tema original.

Solución 6: Problemas con el servidor (mod_rewrite, PHP y memoria)

Si has probado todo lo anterior y sigues con prestashop sin imágenes, el problema puede estar en la configuración del servidor.

• Mod_rewrite: Este módulo de Apache es esencial para las URLs amigables y, por tanto, para que las imágenes se sirvan correctamente. Puedes comprobarlo en Parámetros avanzados > Herramientas > Información y ver si "mod_rewrite" aparece como "Sí". Si no es así, contacta con tu hosting para activarlo.
• Límite de memoria PHP: Si tu tienda tiene muchas imágenes, el proceso de regeneración puede necesitar más memoria de la que PHP tiene asignada. Puedes aumentar el límite de memoria editando el archivo config/defines.inc.php en la raíz de tu instalación. Busca la línea que dice define('_PS_MEMORY_LIMIT_', '256M'); y cámbiala a 512M o 1024M. También puedes hacerlo desde el panel de control de tu hosting, en la sección de "PHP Configuration".

Solución 7: Reinstalar las imágenes desde la copia de seguridad

Si has llegado hasta aquí y nada funciona, es posible que los archivos de imagen se hayan borrado o corrompido en el servidor. La solución definitiva es restaurar las imágenes desde una copia de seguridad.

1. Accede a tu panel de control (Syspanel, puerto 2106) o a tu cliente FTP.
2. Descarga una copia de seguridad reciente de tu tienda. Esta copia debe incluir la carpeta img.
3. Sube el contenido de la carpeta img de la copia de seguridad a tu servidor, reemplazando los archivos existentes.

[TIP] Si no tienes una copia de seguridad, contacta con tu proveedor de hosting. Es posible que ellos tengan una copia reciente de tu sitio y puedan restaurarla.

Preguntas Frecuentes (FAQ)

¿Por qué solo se ven algunas imágenes rotas y otras no?
Esto suele indicar que el problema es específico de ciertos archivos o carpetas. Revisa los permisos de las subcarpetas dentro de img y prueba a regenerar solo las miniaturas de productos.

He regenerado las imágenes y ahora el sitio carga muy lento. ¿Qué hago?
La regeneración consume muchos recursos. Es normal que el sitio vaya más lento durante el proceso. Una vez terminado, la velocidad debería volver a la normalidad. Si no es así, es posible que necesites activar la caché de PrestaShop o contratar un plan de hosting con más recursos.

¿Puedo evitar que esto vuelva a pasar?
Sí. Realiza copias de seguridad periódicas de tu tienda, mantén PrestaShop y sus módulos actualizados y evita instalar módulos o temas de fuentes no confiables. También es recomendable revisar los permisos de las carpetas después de cualquier actualización.

¿El problema puede deberse a un ataque de malware?
En casos raros, sí. Un malware puede modificar o eliminar archivos de imagen. Si sospechas de un ataque, ejecuta un escaneo de seguridad en tu hosting y revisa los archivos de tu instalación.

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Ve probando las soluciones en el orden presentado, ya que van de las más simples y comunes a las más complejas. Con un poco de dedicación, tu tienda volverá a lucir perfecta con todas sus imágenes en su sitio.