Gestionar archivos y permisos en PrestaShop con Syspanel

¿Por qué es importante gestionar archivos y permisos en PrestaShop?

Cuando trabajas con PrestaShop, una de las tareas más habituales (y a veces más frustrantes) es la gestión de archivos y permisos. Si alguna vez has visto un error como "No se puede escribir en el archivo de configuración" o "Permiso denegado" al intentar instalar un módulo, ya sabes de lo que hablamos.

La buena noticia es que, a través de Syspanel, el panel de control que incluye tu hosting, puedes gestionar todo esto de forma visual y sin necesidad de usar comandos complejos. En este tutorial extenso te explicaré paso a paso cómo gestionar archivos y permisos en PrestaShop usando Syspanel, con un enfoque muy práctico y pensado para que lo entiendas aunque no tengas experiencia técnica previa.

[INFO] Syspanel es el nombre que recibe el panel de control (basado en HestiaCP) en muchos alojamientos. Para acceder a él, normalmente usas la URL https://tu-dominio.com:2106 e introduces tus credenciales de acceso al hosting.

Primeros pasos: Acceder a Syspanel y entender su interfaz

Antes de empezar a tocar archivos, necesitas saber cómo moverte por Syspanel. Es más sencillo de lo que parece, pero conviene que conozcas las secciones clave.

Cómo acceder a Syspanel

Abre tu navegador favorito (Chrome, Firefox, Edge, etc.).
Escribe en la barra de direcciones: https://tu-dominio.com:2106 (sustituye tu-dominio.com por tu dominio real).
Introduce tu usuario y contraseña de hosting. Si no los recuerdas, revisa el correo de bienvenida de tu proveedor o contacta con soporte.

Una vez dentro, verás un panel con varias secciones. Las que más te interesan para este tutorial son:

Administrador de archivos: Te permite navegar, subir, editar, eliminar y cambiar permisos de archivos y carpetas.
Base de datos: Aunque no lo usaremos hoy, es bueno saber que está ahí.
Dominios: Para gestionar tus sitios web.

¿Qué son los permisos de archivos y por qué PrestaShop es tan exigente?

Los permisos en un servidor Linux (que es lo que usa la mayoría de hostings) determinan quién puede leer, escribir o ejecutar un archivo o carpeta. Se representan con números como 755, 644 o 775.

755: El propietario puede leer, escribir y ejecutar. Los demás solo pueden leer y ejecutar. Es el típico para carpetas.
644: El propietario puede leer y escribir. Los demás solo pueden leer. Es el típico para archivos.
775: Como el 755, pero también permite al grupo escribir. A veces necesario para que PrestaShop funcione bien con ciertos módulos.

PrestaShop necesita escribir en determinadas carpetas para generar cachés, subir imágenes de productos o instalar módulos. Si los permisos no son los correctos, te aparecerán errores. Por eso es fundamental saber cambiar permisos archivos PrestaShop desde Syspanel.

Cómo gestionar archivos en PrestaShop con el Administrador de archivos de Syspanel

Vamos a lo práctico. La gestión de archivos es pan comido con Syspanel.

Navegar por la estructura de PrestaShop

En Syspanel, busca y haz clic en "Administrador de archivos" (puede aparecer como "File Manager" o "Gestor de archivos").
Se abrirá una ventana con la estructura de directorios de tu hosting. Busca la carpeta public_html (o web según el hosting). Ahí es donde está instalado tu PrestaShop.
Haz clic en public_html y verás todos los archivos de tu tienda: config, img, modules, themes, var, etc.

Subir archivos a tu PrestaShop

¿Necesitas subir un módulo, una plantilla o un archivo de configuración? Sigue estos pasos:

En el Administrador de archivos, navega hasta la carpeta donde quieres subir el archivo (por ejemplo, modules para un módulo).
Haz clic en el botón "Subir" (normalmente un icono con una flecha hacia arriba).
Selecciona el archivo desde tu ordenador y espera a que termine la subida.
Una vez subido, si es un módulo comprimido en .zip, deberás descomprimirlo. Syspanel suele tener una opción de "Extraer" al hacer clic derecho sobre el archivo.

Editar archivos directamente

Si necesitas modificar un archivo de configuración (por ejemplo, config/settings.inc.php o algún archivo de tu tema):

Localiza el archivo en el Administrador de archivos.
Haz clic derecho sobre él y selecciona "Editar" (o "Edit").
Se abrirá un editor de texto básico. Realiza los cambios con cuidado.
Guarda los cambios con el botón "Guardar" (o Ctrl+S).

[WARNING] Antes de editar cualquier archivo importante, te recomiendo hacer una copia de seguridad. Puedes descargar el archivo original a tu ordenador o copiar su contenido en un bloc de notas. Un error en settings.inc.php puede dejar tu tienda inaccesible.

Cambiar permisos de archivos y carpetas en PrestaShop (el paso crítico)

Aquí es donde la mayoría de la gente se pierde, pero con Syspanel es muy visual y sencillo. Vamos a ver cómo cambiar permisos archivos PrestaShop de forma segura.

Paso a paso para cambiar permisos

En el Administrador de archivos, navega hasta el archivo o carpeta que quieres modificar.
Haz clic derecho sobre él y selecciona "Permisos" o "Cambiar permisos" (también puede aparecer como "CHMOD").
Se abrirá una ventana con casillas de verificación para "Leer", "Escribir" y "Ejecutar", y valores numéricos (como 755, 644, etc.).
Para carpetas en PrestaShop, el valor recomendado suele ser 755 (a veces 775 si tienes problemas).
Para archivos estáticos (como imágenes, CSS, JS), el valor recomendado es 644.
Para archivos que necesitan ser escritos por PrestaShop (como los de configuración o caché), a veces necesitas 644 o 664, dependiendo de la configuración de tu hosting.
Marca las casillas o escribe el valor numérico directamente.
Haz clic en "Aceptar" o "Guardar".

¿Qué permisos necesita PrestaShop específicamente?

Aquí tienes una guía rápida para no equivocarte:

Carpetas (directorios): 755 (o 775 si tu hosting usa un grupo de usuarios diferente).
Archivos normales: 644.
Archivos de configuración (config/settings.inc.php): 644 (debe ser legible, pero no siempre escribible).
Carpeta var/cache y var/logs: 755 (a veces 775).
Carpeta img (para subir imágenes): 755.
Carpeta modules (para instalar/actualizar módulos): 755.
Carpeta themes (para modificar plantillas): 755.

[TIP] Si tienes problemas para instalar un módulo o tema, prueba a poner la carpeta modules o themes en 755 y los archivos dentro en 644. Si aún así falla, prueba con 775 en las carpetas y 664 en los archivos.

Casos prácticos: Errores comunes y cómo solucionarlos con Syspanel

Veamos situaciones reales donde necesitarás gestionar archivos y permisos en PrestaShop.

Caso 1: "No se puede escribir en el archivo .htaccess"

Este es un error muy típico al activar la URL amigable o al cambiar la configuración de SEO.

Solución:

Ve al Administrador de archivos de Syspanel.
Busca el archivo .htaccess en la raíz de public_html. Si no lo ves, activa la opción de "Mostrar archivos ocultos" en el Administrador de archivos.
Haz clic derecho sobre .htaccess y selecciona "Permisos".
Cámbialo a 644 y guarda.
Si el error persiste, cámbialo temporalmente a 666 (esto permite que cualquiera escriba), guarda, realiza el cambio en PrestaShop (por ejemplo, activar la URL amigable) y luego vuelve a ponerlo en 644.

[WARNING] No dejes nunca el .htaccess en 666 de forma permanente, ya que es un riesgo de seguridad. Siempre revierte a 644 después de hacer el cambio.

Caso 2: No puedo subir imágenes de productos

Si al subir una imagen en el backoffice de PrestaShop te da error, es casi seguro que la carpeta img/p no tiene permisos de escritura.

Solución:

En Syspanel, navega a public_html/img.
Haz clic derecho en la carpeta p y selecciona "Permisos".
Cambia los permisos a 755 (o 775 si el problema persiste).
Aplica los mismos permisos a las subcarpetas dentro de img/p (puedes usar la opción de "aplicar a subcarpetas" si Syspanel lo permite).

Caso 3: El módulo no se instala o no se actualiza

Los módulos de PrestaShop necesitan escribir en la carpeta modules y, a veces, en var/cache.

Solución:

Limpia la caché de PrestaShop desde el backoffice (Parámetros avanzados > Rendimiento > Vaciar caché).
En Syspanel, ve a public_html/var/cache.
Cambia los permisos de la carpeta cache y sus subcarpetas a 755.
Ve a public_html/modules y cambia los permisos de la carpeta del módulo específico que te da problemas a 755.
Intenta de nuevo la instalación.

Buenas prácticas de seguridad al gestionar permisos

Cambiar permisos es necesario, pero también puede ser un riesgo si no se hace bien. Sigue estas reglas:

Nunca uses 777 (permisos totales para todos) en ningún archivo o carpeta. Es una puerta abierta para los hackers.
Reverte los permisos a 644/755 después de hacer una instalación o actualización.
No cambies permisos de todos los archivos a la vez. Hazlo solo en las carpetas o archivos que lo necesiten.
Mantén actualizado tu PrestaShop para evitar vulnerabilidades que se aprovechen de permisos incorrectos.

[INFO] Si tu tienda tiene un certificado SSL (debería tenerlo), asegúrate de que los archivos de la carpeta config tengan permisos restrictivos (644) para que no puedan ser leídos por terceros.

Preguntas frecuentes (FAQ) sobre archivos y permisos en PrestaShop

¿Por qué PrestaShop me pide permisos 775 en algunas carpetas?

Algunos hostings configuran el servidor para que el grupo de usuarios tenga más privilegios. Si tu hosting usa "mod_ruid2" o "FastCGI", es posible que necesites 775 en las carpetas para que PrestaShop pueda escribir. Prueba primero con 755 y si falla, sube a 775.

¿Cómo sé qué permisos tiene un archivo actualmente?

En el Administrador de archivos de Syspanel, haz clic derecho sobre el archivo y selecciona "Permisos". Verás el valor numérico actual (por ejemplo, 644) y las casillas marcadas.

¿Puedo cambiar permisos de varios archivos a la vez?

Sí, en Syspanel puedes seleccionar varios archivos manteniendo pulsada la tecla Ctrl (o Cmd en Mac) y haciendo clic en cada uno. Luego haz clic derecho y selecciona "Cambiar permisos" para aplicar el mismo valor a todos.

¿Qué pasa si no veo el archivo .htaccess en Syspanel?

Debes activar la opción de "Mostrar archivos ocultos" en el Administrador de archivos. Normalmente hay un icono de ojo o una casilla en la parte superior derecha.

¿Syspanel tiene un acceso directo a la carpeta de PrestaShop?

Sí, normalmente la carpeta public_html es la raíz de tu dominio. Si PrestaShop está instalado en una subcarpeta (por ejemplo, public_html/tienda), navega hasta ella.

Conclusión: Domina la gestión de archivos y permisos con Syspanel

Gestionar archivos y permisos en PrestaShop puede parecer complicado, pero con Syspanel se convierte en una tarea visual y accesible. Recuerda siempre:

Usa el Administrador de archivos para subir, editar y organizar tus archivos.
Cambia los permisos solo cuando sea necesario y con los valores correctos (755 para carpetas, 644 para archivos).
Nunca uses 777 y revierte los permisos después de hacer cambios.
Si tienes dudas, consulta esta guía o busca en la documentación oficial de PrestaShop.

Con esta base, podrás resolver la mayoría de los problemas de escritura y permisos que te encuentres en tu tienda. Y si algo falla, recuerda que Syspanel está a un clic de distancia para que puedas inspeccionar y corregir lo que necesites.

[TIP] Guarda esta guía en favoritos. La necesitarás más de una vez, sobre todo cuando instales módulos o cambies de tema en tu PrestaShop.