Permisos de archivos en PrestaShop: errores y cómo solucionarlos

¿Tu tienda PrestaShop muestra errores extraños, no puedes subir imágenes, o las páginas se ven en blanco? Es muy probable que estés enfrentando un problema de permisos de archivos. No te preocupes, es una de las incidencias más comunes en PrestaShop y, por suerte, también una de las más fáciles de solucionar. En esta guía completa, te explicaremos paso a paso cómo diagnosticar y corregir los permisos archivos PrestaShop tanto si usas cPanel como Plesk. Al final, serás capaz de resolver por ti mismo el temido error permisos PrestaShop y dejar tu tienda funcionando como un reloj.

¿Qué son los permisos de archivos y por qué son importantes en PrestaShop?

Imagina que tu servidor es un edificio de oficinas. Cada archivo y carpeta de tu PrestaShop es una puerta con una cerradura que tiene tres tipos de llaves: una para el dueño (tú), otra para el grupo de trabajo (el servidor web) y otra para el público (los visitantes). Los permisos determinan quién puede leer, escribir o ejecutar cada archivo.

En PrestaShop, unos permisos incorrectos pueden provocar desde que no se guarden los cambios en el catálogo hasta que la tienda entera deje de cargar. Los valores recomendados son:

Carpetas (directorios): 755
Archivos (como .php, .tpl, .js): 644
Archivos de configuración especiales (settings.inc.php, .htaccess): 444 o 644

Cuando estos valores se alteran (por ejemplo, después de una actualización, al mover la tienda o por un plugin malicioso), aparece el famoso error permisos PrestaShop.

¿Cómo identificar un problema de permisos?

Antes de lanzarte a cambiar permisos, asegúrate de que ese es el problema. Los síntomas más habituales son:

Pantalla en blanco (White Screen of Death): La tienda no carga nada.
Errores 500 Internal Server Error: Un clásico de permisos incorrectos en archivos críticos.
No se pueden subir imágenes o módulos: El servidor no tiene permiso de escritura en las carpetas img/, modules/ o upload/.
Errores de "No se puede escribir en el archivo de caché".
Mensajes de "Permiso denegado" al instalar o actualizar módulos.

[INFO] Si ves estos síntomas, no entres en pánico. Lo más probable es que solo necesites corregir permisos PrestaShop cPanel o Plesk.

Solución paso a paso en cPanel

cPanel es uno de los paneles de control de hosting más populares. Aquí te mostramos cómo corregir permisos PrestaShop cPanel de forma segura.

Acceder al Administrador de Archivos

Inicia sesión en tu cPanel (normalmente es tudominio.com/cpanel).
Busca la sección Archivos y haz clic en Administrador de Archivos.
Selecciona la raíz del documento de tu tienda (normalmente public_html o www). Asegúrate de marcar "Mostrar archivos ocultos".

Cambiar permisos de forma masiva (la forma más rápida)

Aquí viene el truco para no tener que ir archivo por archivo:

En el Administrador de Archivos, selecciona TODOS los archivos y carpetas de tu PrestaShop. Puedes usar Ctrl + A.
Haz clic derecho sobre la selección y elige Cambiar permisos.
NO marques la opción "Aplicar a subdirectorios" todavía. Primero configuraremos las carpetas.

Para las carpetas (directorios):

Permisos: Marca las casillas así: Propietario: Lectura, Escritura, Ejecución (7). Grupo: Lectura, Ejecución (5). Público: Lectura, Ejecución (5). Esto es 755.
Acción: Marca "Aplicar solo a directorios".
Haz clic en Cambiar permisos.

Para los archivos:

Repite el proceso: selecciona todo otra vez (Ctrl + A), clic derecho > Cambiar permisos.
Permisos: Marca: Propietario: Lectura, Escritura (6). Grupo: Lectura (4). Público: Lectura (4). Esto es 644.
Acción: Marca "Aplicar solo a archivos".
Haz clic en Cambiar permisos.

[TIP] Este método de dos pasos (primero directorios, luego archivos) es la forma más eficiente de corregir permisos PrestaShop cPanel sin romper nada.

Ajustar archivos especiales

Algunos archivos necesitan permisos específicos:

config/settings.inc.php (o app/config/parameters.php en versiones modernas): Este archivo contiene la conexión a la base de datos. Debe estar en 444 (solo lectura para todos) para evitar que nadie lo modifique. Si está en 644, cámbialo a 444.
.htaccess: Normalmente 644 o 444. Si tu tienda da error 500, ponlo a 444.
Carpeta /cache, /log, /upload, /img: Estas carpetas deben ser escribibles. Asegúrate de que tengan permisos 755. Si algún módulo necesita escribir aquí, puede que necesites 777 temporalmente, pero nunca lo dejes así por seguridad.

Verificar desde la línea de comandos (SSH) si tienes acceso

Si tu hosting permite SSH, puedes hacerlo en segundos:

# Ir a la raíz de PrestaShop
cd /home/tuusuario/public_html

# Corregir directorios
find . -type d -exec chmod 755 {} \;

# Corregir archivos
find . -type f -exec chmod 644 {} \;

# Archivo de configuración
chmod 444 config/settings.inc.php

Solución paso a paso en Plesk

Plesk es otro panel muy común, especialmente en servidores Windows o Linux. El proceso es similar pero con una interfaz diferente.

Acceder al Administrador de Archivos

Ingresa a Plesk (normalmente tudominio.com:8443).
Ve a Sitios web y dominios.
Busca tu dominio y haz clic en Administrador de archivos (o File Manager).

Cambiar permisos de forma masiva

En Plesk, no hay una opción tan directa como en cPanel para aplicar solo a archivos o solo a directorios, pero puedes hacerlo manualmente o usando la herramienta de "Cambiar permisos" por lotes.

Dentro del Administrador de archivos, navega hasta la carpeta raíz de tu PrestaShop.
Opción 1 (Manual pero segura): Selecciona una carpeta, haz clic en Cambiar permisos, pon 755 y marca "Aplicar a subdirectorios". Luego, selecciona todos los archivos (puedes filtrar por tipo) y cámbialos a 644.
Opción 2 (Usando la herramienta de permisos): Algunas versiones de Plesk tienen un botón "Reparar permisos" o "Permisos recomendados" para CMS como PrestaShop. Búscalo en la sección de Herramientas y configuraciones o en el menú del dominio.

[WARNING] En Plesk, ten cuidado con los archivos de configuración. El archivo config/settings.inc.php debe tener permisos 400 o 444 (solo lectura). Si lo pones a 644, el sistema de seguridad de Plesk podría detectarlo como una vulnerabilidad.

Usar la línea de comandos en Plesk (para usuarios avanzados)

Si tu hosting con Plesk ofrece acceso SSH (lo cual es común en servidores dedicados o VPS), puedes usar los mismos comandos que en cPanel.

Solución para Syspanel (antes conocido como HestiaCP)

Si tu hosting usa Syspanel (recuerda que el puerto de acceso es el 2106), el proceso es bastante similar a cPanel, pero con una interfaz más moderna.

Accede a tu Syspanel: https://tudominio.com:2106.
Ve a Archivos > Administrador de archivos.
Navega hasta la carpeta web de tu dominio.
Selecciona todo (Ctrl + A), haz clic derecho y elige Permisos.
Al igual que en cPanel, primero cambia los directorios a 755 y luego los archivos a 644.
No olvides el archivo de configuración: búscalo y ponlo en 444.

[INFO] Syspanel (HestiaCP) suele tener un botón de "Reparar permisos" automático para PrestaShop. Búscalo en la sección de Herramientas o Ajustes avanzados de tu dominio.

Preguntas Frecuentes (FAQ) sobre permisos en PrestaShop

¿Qué permisos debe tener la carpeta /cache en PrestaShop?

La carpeta /cache y sus subcarpetas (/cache/smarty, /cache/tcpdf, etc.) deben tener permisos 755 o 777 si tu hosting es muy restrictivo. El servidor web necesita escribir aquí para generar las páginas en caché. Si ves errores de "no se puede escribir en el archivo de caché", este es el culpable.

¿Por qué mi PrestaShop se vuelve lento después de cambiar permisos?

Esto suele ocurrir si pusiste permisos 777 en muchas carpetas. El servidor tarda más en verificar los permisos. Mantén las carpetas en 755 y solo usa 777 temporalmente para solucionar un error concreto.

¿Cómo sé si los permisos se aplicaron correctamente?

Puedes usar la función de Diagnóstico de PrestaShop. Ve a Parámetros de la tienda > Rendimiento y haz clic en el botón "Probar permisos de archivos y carpetas". Te mostrará en verde o rojo el estado de cada carpeta.

¿Puedo usar un plugin para corregir los permisos?

Sí, existen módulos como "PrestaShop File Permissions Fixer" que pueden automatizar el proceso. Sin embargo, es mejor aprender a hacerlo manualmente para entender qué está pasando. Si usas un plugin, asegúrate de que sea de confianza.

Después de corregir permisos, sigo viendo un error 500. ¿Qué hago?

Prueba a regenerar el archivo .htaccess. Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs, y sin cambiar nada, haz clic en Guardar. También puedes borrar el archivo .htaccess manualmente y luego regenerarlo desde el panel.

Consejos finales para evitar futuros problemas de permisos

Actualiza PrestaShop con cuidado: Después de cada actualización, verifica los permisos. A veces el proceso de actualización los cambia.
No uses 777 por defecto: Es una puerta abierta a los hackers. Solo úsalo temporalmente y luego vuelve a 755.
Haz copias de seguridad: Antes de cambiar permisos masivamente, ten un backup de tu tienda. Si algo sale mal, puedes restaurarlo.
Revisa los logs de error: En cPanel, busca la sección Errores > Registro de errores. Los mensajes como "Permission denied" te indicarán exactamente qué archivo o carpeta está causando el problema.

[WARNING] Nunca cambies los permisos de la carpeta admin (tu panel de administración) a 777. Esto expondría todo el control de tu tienda. Déjala en 755 o incluso 750 para mayor seguridad.

Ahora ya tienes todo lo necesario para diagnosticar y solucionar los problemas de permisos archivos PrestaShop tanto en cPanel como en Plesk. Recuerda que la paciencia es clave: ve paso a paso, verifica cada cambio y no dudes en consultar los logs de tu servidor. Con esta guía, tu tienda volverá a funcionar sin esos molestos errores. ¡Manos a la obra!