¿Cómo limpiar la caché avanzada de PrestaShop para solucionar problemas de diseño?

Por qué la caché puede alterar el diseño de una tienda PrestaShop

PrestaShop utiliza varios mecanismos para evitar que cada visita tenga que reconstruir la tienda desde cero. Es sensato. Un comercio electrónico sin caché sería como un restaurante que lava, corta y cocina cada ingrediente solo después de que el cliente se sienta: muy artesanal, muy romántico, y desesperadamente lento.

El problema aparece cuando el sistema sigue sirviendo versiones antiguas de archivos que ya han cambiado. Por ejemplo:

• Modificas un archivo .tpl, pero PrestaShop muestra la plantilla compilada anterior.
• Actualizas un .css, pero el navegador o el CDN entrega una copia vieja.
• Activas la opción CCC y PrestaShop sigue usando un archivo minificado generado antes del cambio.
• Instalas o actualizas un módulo, pero el hook visual no aparece como debería.
• Cambias imágenes, iconos o fuentes, y el diseño carga a medias, como una fachada recién pintada bajo una tormenta.

En estos casos, la tienda no necesariamente está rota. Lo que está roto es el pacto entre lo que tú has cambiado y lo que el visitante está viendo. Esa distancia, pequeña y venenosa, suele llamarse caché obsoleta.

Idea clave 🧠: cuando hay problemas de diseño en PrestaShop después de tocar el tema, actualizar módulos o modificar CSS/JS, la caché debe revisarse en capas. Primero PrestaShop. Luego navegador. Después CDN. Finalmente servidor y PHP.

Las capas de caché en PrestaShop: no hay un solo culpable

Decir “borra la caché” es cómodo. También es impreciso. En PrestaShop pueden coexistir varias cachés, cada una con su propia memoria, sus propias manías y sus propias formas de arruinar una tarde.

Esta superposición explica por qué limpiar la caché desde el panel de PrestaShop puede no ser suficiente. No es que el botón sea inútil; es que está peleando una guerra local mientras el CDN, el navegador o PHP guardan sus propias copias como pequeños archiveros incorruptibles.

Antes de tocar nada: seguridad, método y una pizca de prudencia

Limpiar caché suele ser seguro. Borrar carpetas equivocadas, no. Entre ambas acciones hay la misma diferencia que entre podar un rosal y talar el jardín.

1. Haz copia de seguridad 🛡️

No necesitas respaldar toda la tienda para borrar caché, pero antes de intervenir por FTP, SSH o panel del hosting conviene tener al menos una copia reciente de archivos y base de datos.

2. Activa modo mantenimiento

Si vas a limpiar caché en una tienda con tráfico o a tocar archivos manualmente, activa mantenimiento desde Parámetros de la tienda > Configuración. Añade tu IP para seguir navegando.

3. Identifica la versión

PrestaShop 1.6, 1.7 y 8 no organizan la caché exactamente igual. Una guía seria no trata a todas las versiones como si fueran clones con distinto peinado.

4. No borres lo que no entiendes

La caché se regenera; archivos del tema, módulos, imágenes y configuración no siempre. Ante la duda, renombra una carpeta antes de eliminarla.

Advertencia profesional ⚠️: evita permisos tipo 777 como solución universal. Son el equivalente técnico a dejar la puerta abierta “para que entre el aire”. Usa propietario correcto y permisos razonables: habitualmente 755 para carpetas y 644 para archivos, ajustados al entorno del hosting.

Primer método: limpiar caché desde el Back Office de PrestaShop

La vía más limpia empieza donde debe empezar: en el panel de administración. No siempre resuelve los casos difíciles, pero sí muchos. Además, deja menos margen para convertir un problema visual en una novela negra.

En PrestaShop 1.7 y PrestaShop 8

1. Entra al Back Office.
2. Ve a Parámetros avanzados > Rendimiento.
3. Busca el bloque de caché.
4. Pulsa Limpiar caché.
5. Revisa la tienda en una ventana privada o con recarga forzada.

Ajustes recomendados durante desarrollo

Si estás modificando el tema o trabajando con un desarrollador, revisa la sección de Smarty:

• Compilación de plantillas: usa Forzar compilación durante desarrollo si los cambios no aparecen.
• Caché: desactívala temporalmente mientras ajustas diseño.
• Después de terminar: vuelve a una configuración de producción para no sacrificar rendimiento.

En producción, lo habitual es usar una opción equilibrada como “Recompilar plantillas si los archivos han sido actualizados”, junto con la caché activada cuando la tienda ya está estable. El comercio necesita velocidad; el diseñador necesita frescura. La administración sensata consiste en no permitir que uno estrangule al otro.

Prueba rápida 🔎: después de limpiar desde el Back Office, abre la página con Ctrl + F5 en Windows/Linux o Cmd + Shift + R en macOS. Si el diseño aparece bien, probablemente era caché del navegador o de assets.

Limpieza avanzada: carpetas de caché por FTP, SFTP o SSH

Cuando el Back Office no carga, el botón no responde o los cambios siguen sin verse, toca bajar al sótano. No hay música dramática, pero casi.

PrestaShop 1.7 y 8: limpiar var/cache

En PrestaShop 1.7 y 8, buena parte de la caché vive en:

/var/cache/prod
/var/cache/dev

La carpeta prod corresponde al entorno de producción; dev, al entorno de desarrollo. En una tienda normal, la que más importa es prod.

Método seguro por FTP/SFTP:

1. Accede al servidor con SFTP o el administrador de archivos del hosting.
2. Entra en la carpeta raíz de PrestaShop.
3. Ve a var/cache/.
4. Elimina el contenido de prod y, si existe y procede, de dev.
5. No elimines carpetas ajenas ni archivos del núcleo.
6. Recarga la tienda: PrestaShop regenerará la caché.

Método por SSH:

cd /ruta/a/tu/prestashop
rm -rf var/cache/prod/*
rm -rf var/cache/dev/*

Algunos administradores prefieren borrar directamente la carpeta prod completa para que se regenere. Puede funcionar, pero en entornos compartidos es más prudente borrar el contenido. Si hay archivos ocultos relevantes, revisa antes con ls -la.

Limpiar caché con consola en PrestaShop 1.7/8

Si tienes acceso SSH y la instalación lo permite, puedes usar la consola de PrestaShop basada en Symfony:

cd /ruta/a/tu/prestashop
php bin/console cache:clear --env=prod --no-debug

Si estás trabajando en entorno de desarrollo:

php bin/console cache:clear --env=dev

En servidores con poca memoria, el comando puede fallar. No es raro. A veces limpiar manualmente var/cache/prod resulta más directo. La tecnología moderna, por supuesto, siempre encuentra formas sofisticadas de tropezar con una piedra muy antigua: la memoria insuficiente.

PrestaShop 1.6: rutas habituales

En PrestaShop 1.6, la estructura es diferente. Las rutas más comunes son:

/cache/smarty/compile
/cache/smarty/cache
/cache/class_index.php
/themes/tu_tema/cache

En general, puedes vaciar el contenido de cache/smarty/compile y cache/smarty/cache, manteniendo archivos de seguridad como index.php si existen. También se suele eliminar cache/class_index.php, que PrestaShop regenera automáticamente.

Cuidado 🚨: no borres la carpeta /img, /modules, /themes/tu_tema ni /override pensando que “todo es caché”. No lo es. Y la tienda no agradecerá tu entusiasmo.

Permisos después de limpiar

Tras borrar caché, PrestaShop necesita escribir de nuevo en ciertas carpetas. Si aparecen errores 500, pantallas blancas o mensajes de permisos, revisa propiedad y permisos:

find var/cache -type d -exec chmod 755 {} \;
find var/cache -type f -exec chmod 644 {} \;

En servidores dedicados o VPS, también puede ser necesario ajustar el propietario al usuario que ejecuta PHP, por ejemplo:

chown -R www-data:www-data var/cache var/logs

El usuario real puede variar: www-data, apache, nginx, el usuario de cPanel o uno específico del hosting. No copies este comando como quien copia una receta de tarta; confirma primero tu entorno.

CCC en PrestaShop: cuando optimizar rompe el escaparate

CCC significa Combinación, Compresión y Caché. Su función es mejorar el rendimiento reduciendo y optimizando archivos CSS y JavaScript. En teoría, es un mayordomo eficiente. En la práctica, a veces esconde los cubiertos.

Lo encontrarás en Parámetros avanzados > Rendimiento. Sus opciones pueden incluir:

• Smart cache para CSS.
• Smart cache para JavaScript.
• Minificación de HTML.
• Compresión de JavaScript en HTML.
• Mover JavaScript al final.
• Optimización de Apache mediante reglas específicas, según el entorno.

Cuándo sospechar de CCC

CCC suele estar implicado cuando:

• El sitio se ve bien con CCC desactivado, pero se rompe al activarlo.
• Los estilos cargan en orden incorrecto.
• Un slider, menú, buscador o módulo visual deja de funcionar.
• Los iconos de Font Awesome u otra librería aparecen como cuadrados vacíos.
• Hay errores en la consola del navegador relacionados con archivos .js minificados.

Procedimiento recomendado con CCC

1. Desactiva temporalmente las opciones CCC.
2. Limpia la caché desde el Back Office.
3. Limpia caché del navegador o prueba en incógnito.
4. Comprueba si el diseño vuelve a la normalidad.
5. Activa las opciones una por una, no todas a la vez.
6. Cuando detectes cuál rompe el diseño, revisa el módulo o archivo responsable.

Este enfoque es menos espectacular que pulsar todos los interruptores con fe heroica, pero mucho más útil. El diagnóstico web se parece a escuchar un motor: si aceleras, frenas, apagas la radio y prestas atención, tarde o temprano oyes la pieza que chirría.

Archivos generados por el tema

Según versión, tema y configuración, PrestaShop puede generar archivos optimizados en rutas como:

/themes/tu_tema/assets/cache
/themes/tu_tema/cache

Si los estilos no actualizan pese a limpiar var/cache, revisa estas carpetas. De nuevo: borra archivos generados, no archivos fuente del tema. Si ves ficheros minificados con nombres largos, hashes o combinaciones de CSS/JS, probablemente son candidatos. Si ves theme.css, custom.css o archivos originales del tema, piensa dos veces.

Consejo de desarrollo 🎨: si editas CSS, trabaja preferiblemente sobre el archivo fuente adecuado del tema o sobre custom.css cuando el tema lo contemple. Evita modificar archivos minificados generados por CCC: se perderán al regenerar la caché.

Más allá de PrestaShop: navegador, CDN, OPCache y caché del servidor

A veces limpias PrestaShop con impecable disciplina y el diseño sigue igual. Es ahí cuando uno recuerda que la web no es una línea recta, sino una cadena de intermediarios: navegador, DNS, CDN, proxy, servidor web, PHP, aplicación. Cada uno guarda algo. Cada uno olvida cuando quiere.

1. Caché del navegador

Antes de culpar al servidor, prueba lo elemental:

• Recarga forzada con Ctrl + F5.
• Abre la tienda en modo incógnito.
• Prueba otro navegador.
• Usa las herramientas de desarrollador y marca Disable cache mientras estén abiertas.

En Chrome, Edge o Firefox, abre DevTools con F12, ve a la pestaña Network y revisa si los CSS y JS se cargan con estado 200, 304, desde memory cache o desde disk cache. Un 304 Not Modified no es malo por sí mismo, pero puede revelar que el navegador está reutilizando recursos.

2. CDN: Cloudflare y compañía

Si usas Cloudflare u otro CDN, recuerda que puede servir archivos antiguos aunque PrestaShop ya haya generado los nuevos. Para cambios de diseño, lo ideal es purgar solo las URL afectadas. Si no sabes cuáles son, puedes hacer una purga completa, aunque no conviene convertirla en costumbre diaria.

En Cloudflare, por ejemplo, revisa:

• Caching > Configuration > Purge Cache.
• Purge Custom URLs para CSS, JS o imágenes concretas.
• Development Mode durante cambios intensivos, sabiendo que se desactiva automáticamente tras unas horas.

También verifica reglas de caché demasiado agresivas. Cachear HTML dinámico de una tienda sin cuidado puede provocar escenas curiosas: carritos cruzados, precios desactualizados, sesiones extrañas. La velocidad es una virtud; la velocidad sin contexto, una travesura peligrosa.

3. Caché de servidor: LiteSpeed, Varnish, Nginx FastCGI, Redis o Memcached

Muchos hostings modernos incluyen capas de caché adicionales. Algunas son excelentes. Otras son excelentes hasta que necesitas ver un cambio ahora.

Revisa si tu servidor utiliza:

• LiteSpeed Cache, habitual en hostings con LiteSpeed Web Server.
• Varnish, proxy inverso muy potente para cachear respuestas HTTP.
• Nginx FastCGI cache, frecuente en stacks optimizados.
• Redis o Memcached, usados para objetos, sesiones o capas específicas.
• Caché del panel de hosting, como herramientas propias de cPanel, Plesk o proveedores gestionados.

Si existe una opción “Purge cache”, “Flush cache” o similar en el hosting, úsala después de limpiar PrestaShop. Si administras un VPS, el procedimiento dependerá de tu configuración; no hay un comando universal y honesto para todos los casos.

4. PHP OPCache

OPCache no cachea CSS ni plantillas directamente como un navegador, sino código PHP compilado. Aun así, puede influir tras actualizaciones de módulos, cambios en overrides o despliegues de código.

Soluciones habituales:

• Reiniciar PHP-FPM si tienes permisos.
• Reiniciar Apache si PHP corre como módulo.
• Usar la opción del panel de hosting para limpiar OPCache.
• Configurar correctamente opcache.validate_timestamps en entornos donde se actualizan archivos.

En producción, OPCache mejora mucho el rendimiento PHP. Desactivarlo porque “molesta” suele ser una mala decisión. Mejor entenderlo que mutilarlo.

Diagnóstico rápido: síntoma, causa probable y solución

Cuando el diseño falla, conviene abandonar la superstición y entrar en modo detective. La siguiente tabla resume escenarios frecuentes en mantenimiento PrestaShop.

Usa los logs: la tienda suele hablar, aunque en voz baja

En PrestaShop 1.7 y 8, revisa especialmente:

/var/logs

También puedes activar el modo debug si la tienda está en mantenimiento y necesitas ver errores con más detalle. En PrestaShop moderno, suele hacerse desde el Back Office o modificando configuración en archivos según el caso. No lo dejes activo en producción abierta: mostrar errores internos al público es una cortesía que los atacantes aprecian demasiado. 🔐

Procedimiento profesional paso a paso para limpiar caché avanzada

Si necesitas una secuencia práctica, usa esta. No es la única, pero evita saltar directamente a soluciones destructivas.

Paso 1: confirma el problema

1. Abre la página afectada en modo incógnito.
2. Haz recarga forzada.
3. Comprueba desde otro dispositivo o red.
4. Revisa si el problema ocurre en una sola página, en una categoría, en producto o en toda la tienda.

Paso 2: limpia desde el Back Office

1. Ve a Parámetros avanzados > Rendimiento.
2. Pulsa Limpiar caché.
3. Si estás desarrollando, activa temporalmente Forzar compilación.
4. Desactiva caché Smarty mientras pruebas, pero reactívala al finalizar.

Paso 3: desactiva CCC temporalmente

1. Desactiva Smart cache para CSS.
2. Desactiva Smart cache para JavaScript.
3. Limpia caché otra vez.
4. Comprueba el diseño.

Si al desactivar CCC todo funciona, no has terminado: has encontrado una pista. Revisa orden de carga, dependencias de módulos, archivos duplicados, errores JS y rutas a fuentes o imágenes.

Paso 4: limpia caché por archivos

Para PrestaShop 1.7/8:

rm -rf var/cache/prod/*
rm -rf var/cache/dev/*

Para PrestaShop 1.6, revisa:

cache/smarty/compile
cache/smarty/cache
cache/class_index.php

Si no tienes SSH, hazlo con SFTP. Más lento, sí. Pero a veces la lentitud prudente salva más tiendas que la rapidez temeraria.

Paso 5: purga CDN y caché del hosting

1. Purga la caché del CDN si existe.
2. Limpia caché del servidor desde el panel de hosting.
3. Si usas LiteSpeed, Varnish o Nginx FastCGI, purga la capa correspondiente.
4. Reinicia PHP-FPM o limpia OPCache si hubo cambios PHP o actualización de módulos.

Paso 6: revisa con herramientas de navegador

Abre DevTools y observa:

• Errores en Console.
• Archivos CSS/JS con 404 o 403.
• Recursos servidos desde caché.
• Orden de carga de hojas de estilo.
• Errores CORS en fuentes, imágenes o scripts externos.

Una vez, revisando una tienda de moda, el “gran fallo de diseño” resultó ser una fuente bloqueada por CORS desde un subdominio mal configurado. Dos horas de sospechas sobre Smarty, módulos y CCC para acabar mirando una cabecera HTTP. La web tiene ese humor seco: te lleva por un laberinto barroco y la llave está debajo del felpudo.

Casos habituales después de cambiar el tema o actualizar módulos

El tema nuevo se mezcla con estilos del anterior

Esto puede ocurrir si hay caché de CSS combinada, archivos antiguos en el navegador o módulos que siguen inyectando hojas de estilo previas. Limpia CCC, revisa themes/tu_tema/assets/cache y comprueba en DevTools qué archivos CSS se están cargando realmente.

El diseño móvil se ve mal, pero escritorio está bien

No siempre es caché. Puede ser una media query rota, un CSS cargado en orden incorrecto o una minificación que eliminó algo importante. Aun así, limpia caché y prueba con dispositivo real. Los emuladores ayudan, pero el móvil físico tiene la mala costumbre de decir la verdad.

Los iconos desaparecen

Los iconos tipo Font Awesome pueden fallar por rutas incorrectas, caché CDN, archivos de fuente no encontrados, MIME types mal servidos o problemas CORS. Revisa la pestaña Network filtrando por font. Si ves 404, 403 o errores CORS, no es un misterio estético: es una ruta o cabecera mal servida.

El botón de compra o el checkout pierden estilos

Procede con especial cuidado. El checkout no es una página cualquiera; es donde el diseño se convierte en dinero. Desactiva CCC temporalmente, limpia caché, revisa errores JS y comprueba compatibilidad del módulo de pago, transportistas y tema. Un JavaScript roto en el checkout puede no verse como un incendio, pero quemar conversiones en silencio.

Después de actualizar PrestaShop, todo parece descolocado

Tras una actualización mayor, limpia var/cache/prod, revisa compatibilidad de tema y módulos, recompila assets si tu flujo de trabajo lo requiere y verifica la versión de PHP. PrestaShop 8, por ejemplo, tiene requisitos distintos a instalaciones antiguas; arrastrar un tema viejo a una versión moderna puede ser como poner ruedas de madera a un coche eléctrico.

Buenas prácticas para evitar problemas de caché y diseño

Limpiar caché soluciona. Diseñar un flujo de trabajo correcto previene. Y prevenir, aunque menos heroico, factura menos horas de urgencia.

1. Trabaja en un entorno de staging

Una copia de pruebas permite modificar temas, módulos y configuraciones sin que cada error se convierta en espectáculo público. Idealmente, staging debe replicar versión PHP, configuración de servidor, tema, módulos y caché del entorno real.

2. Versiona archivos CSS y JS

Cuando sea posible, usa versionado de assets. Añadir parámetros de versión o hashes ayuda a que navegador y CDN descarguen archivos nuevos:

theme.css?v=2025-01-actualizacion

Muchos temas y flujos modernos ya gestionan esto mediante compiladores o nombres con hash. La idea es simple: si el archivo cambia, su identidad pública también debería cambiar.

3. Documenta cambios

Anota qué se modificó, cuándo, en qué archivo y por quién. Parece burocracia hasta que algo se rompe tres semanas después. Entonces esa nota breve se convierte en linterna.

4. No edites archivos generados

Los archivos minificados, combinados o cacheados pueden desaparecer al limpiar caché. Editarlos es escribir una carta en la arena durante la marea alta: muy expresivo, poco duradero.

5. Revisa módulos que inyectan CSS o JS

Muchos problemas de diseño no nacen en el tema, sino en módulos que agregan estilos o scripts en hooks concretos. Si el fallo apareció tras instalar o actualizar un módulo, ahí tienes un sospechoso con coartada débil.

6. Limpia en orden

Un orden razonable sería:

1. Caché de PrestaShop.
2. CCC y assets del tema.
3. Navegador.
4. CDN.
5. Caché del hosting o servidor.
6. OPCache si hay cambios PHP.

7. Mide rendimiento después

Tras desactivar CCC o cachés para resolver un problema, no olvides restaurar una configuración adecuada. Usa Lighthouse, WebPageTest, PageSpeed Insights o mediciones reales del servidor para confirmar que la tienda no queda innecesariamente lenta. Una tienda hermosa pero lenta es un escaparate iluminado en una calle desierta.

Seguridad al limpiar caché: detalles que importan

La caché puede contener rutas, fragmentos compilados y datos técnicos. Normalmente no debería exponer información sensible al público, pero una mala configuración del servidor sí puede hacerlo. Revisa que carpetas como var, app, cache o archivos internos no sean navegables desde el exterior.

• Comprueba que el servidor impida listar directorios.
• No subas copias de seguridad dentro de la raíz pública.
• No dejes scripts improvisados para limpiar OPCache accesibles sin protección.
• Desactiva el modo debug al terminar.
• Mantén PrestaShop, módulos y tema actualizados.

Un script llamado clear-cache.php sin autenticación puede parecer útil durante cinco minutos y lamentable durante meses. La comodidad, en seguridad, suele cobrar intereses.

Preguntas frecuentes sobre la caché avanzada de PrestaShop

¿Es seguro borrar var/cache/prod?

En PrestaShop 1.7 y 8, normalmente sí: es caché regenerable. Aun así, conviene borrar el contenido y no tocar otras carpetas si no estás seguro. Después de eliminarla, la primera carga puede ser más lenta porque PrestaShop reconstruye archivos.

¿Por qué limpio caché y sigo viendo el diseño anterior?

Porque quizá estás viendo caché del navegador, CDN o servidor. También puede ocurrir que hayas editado un archivo que no es el que realmente carga el tema. DevTools te dirá la verdad con más precisión que la intuición.

¿Debo dejar “Forzar compilación” activado?

No en producción. Es útil durante desarrollo, pero puede penalizar rendimiento. Al terminar los cambios, vuelve a una configuración optimizada.

¿CCC mejora siempre la velocidad?

No siempre. Puede reducir peticiones y tamaño de archivos, pero también romper dependencias o ser menos útil bajo HTTP/2/HTTP/3 si está mal configurado. Hay que probar, medir y observar errores.

¿Puedo limpiar caché sin acceso al Back Office?

Sí. Puedes hacerlo por SFTP/FTP eliminando contenidos de carpetas de caché o por SSH con comandos. Es especialmente útil si el Back Office muestra error 500 o pantalla blanca.

¿Cada cuánto conviene limpiar la caché?

No hace falta hacerlo a diario sin motivo. Límpiala después de modificar tema, CSS, JS, plantillas, instalar o actualizar módulos, cambiar configuración de rendimiento, migrar hosting o actualizar PrestaShop.

Cierre: limpiar caché no es borrar memoria, es recuperar coherencia

La caché de PrestaShop existe para que la tienda respire mejor: menos carga, menos espera, más velocidad. Pero cuando el diseño se queda atrapado en una versión antigua, esa ayuda se convierte en espejismo. Lo nuevo existe en el servidor, lo viejo aparece en pantalla; el presente trabaja, el pasado cobra.

La solución profesional no consiste en borrar carpetas con furia, sino en entender las capas: Smarty, Symfony, CCC, navegador, CDN, servidor y OPCache. Cada una guarda una pieza del relato. Cada una puede mentir un poco.

Si sigues un orden —Back Office, assets, archivos, CDN, servidor, diagnóstico con DevTools— podrás resolver la mayoría de problemas de diseño en PrestaShop sin improvisar ni comprometer la tienda. Y cuando el botón vuelva a su sitio, el CSS cargue limpio y la portada recupere su forma, habrá una satisfacción modesta pero real: la de haber vencido no a un gran monstruo, sino a algo más cotidiano y persistente. Una copia vieja.

Que, en el mundo web, a veces es el enemigo más educado y más terco. 🚀