Cómo Solucionar el Error 'Smarty Exception' en PrestaShop Paso a Paso

¿Qué es el error Smarty Exception en PrestaShop?

El motor de plantillas Smarty es el encargado de compilar y mostrar las vistas en PrestaShop. Cuando se produce una SmartyException, significa que el sistema ha encontrado un fallo crítico en la sintaxis de la plantilla, una variable no definida o problemas graves con la caché de los archivos TPL, lo que suele bloquear el acceso tanto al frontoffice como al backoffice.

Causas principales de la excepción Smarty

• Archivos de plantilla (.tpl) corruptos o con errores de sintaxis tras una modificación manual.
• Incompatibilidad de un módulo recién instalado con la versión actual del tema o de PrestaShop.
• Problemas de permisos de escritura en la carpeta /var/cache/ de tu servidor.
• Caché corrupta debido a interrupciones en procesos de compilación anteriores.

Método 1: Vaciar la caché de PrestaShop manualmente vía FTP

A veces, el panel de administración es inaccesible, por lo que debes purgar la caché directamente desde el servidor.

1. Conéctate a tu servidor utilizando un cliente FTP (como FileZilla).
2. Navega hasta la raíz de instalación de tu tienda PrestaShop.
3. Entra en la carpeta var/cache/.
4. Elimina el contenido de las carpetas prod y dev (asegúrate de no borrar las carpetas principales, solo los archivos y subdirectorios internos).
5. Vuelve a cargar tu tienda web en el navegador para comprobar si el error ha desaparecido.

Método 2: Activar el Modo Depuración (Debug) para identificar el fallo exacto

El modo de depuración te mostrará la traza exacta (stack trace) del error Smarty para saber qué archivo o módulo está fallando.

1. Accede a tu servidor mediante FTP o el Administrador de Archivos de tu hosting.
2. Localiza el archivo config/defines.inc.php.
3. Abre el archivo con un editor de código y busca la siguiente línea:
   define('_PS_MODE_DEV_', false);
4. Cambia el valor false por true:
   define('_PS_MODE_DEV_', true);
5. Guarda los cambios y recarga tu página web. Ahora verás el mensaje detallado de la excepción Smarty indicando la línea de código y el archivo causante del problema.

Método 3: Restaurar la plantilla o el módulo afectado

Una vez que el modo depuración te ha revelado el origen del problema:

1. Si el error proviene de un módulo específico tras una actualización, desactívalo renombrando su carpeta en modules/ vía FTP.
2. Si el fallo proviene de un archivo .tpl modificado recientemente, reemplázalo con una copia de seguridad limpia o con la versión original de tu tema.
3. No olvides volver a desactivar el modo depuración cambiando true por false en el archivo config/defines.inc.php una vez solucionado el problema por seguridad.