Explorer FTP (explorerftp) — Documentación

Explorer FTP (explorerftp) es un gestor de archivos integrado en el back office de PrestaShop. Permite explorar el árbol de archivos de la tienda, editar archivos de texto y de código con un editor integrado, subir y descargar archivos, y exportar carpetas en formato ZIP, sin necesidad de un cliente FTP externo. Esta documentación cubre la instalación, el uso completo, el modelo de seguridad y la resolución de problemas.

Presentación

Explorer FTP añade una entrada en Parámetros avanzados del back office. Desde esta interfaz, un empleado con los permisos necesarios puede explorar los archivos de la tienda, abrir un editor de código con resaltado de sintaxis, crear carpetas, renombrar, copiar, mover o eliminar elementos, subir archivos mediante arrastrar y soltar, y generar archivos ZIP. Todos los accesos se limitan estrictamente al directorio raíz de PrestaShop.

Requisitos

• PrestaShop 8.0 o superior (compatible con 9.x).
• PHP 8.0 o superior.
• Extensión PHP ZipArchive para las funciones de exportación ZIP.

Instalación

Desde el back office

1. Ve a Módulos > Gestor de módulos.
2. Haz clic en Subir un módulo y selecciona el archivo explorerftp.zip.
3. El módulo se instala automáticamente y crea su pestaña de administración.

Mediante FTP

1. Descomprime el archivo y coloca la carpeta explorerftp en el directorio /modules de la tienda.
2. En Módulos > Gestor de módulos, busca «Explorer FTP» y haz clic en Instalar.

Acceso al módulo

Abre Parámetros avanzados > Explorer FTP. El acceso está reservado a los perfiles con permiso sobre la pestaña AdminExplorerFtp: puedes restringir su uso a determinados perfiles de empleado desde Equipo > Permisos.

Interfaz

Barra de herramientas

• Atrás / Carpeta superior / Actualizar: navegación por el árbol.
• Ruta de navegación: muestra la ruta actual y permite volver a cualquier nivel.
• Búsqueda: busca por nombre de archivo o carpeta en el directorio actual y sus subcarpetas (se omiten los directorios pesados como vendor, var, cache, node_modules y .git).
• Subir y Nueva carpeta: añadir archivos o crear directorios.

Árbol y lista

El panel lateral muestra el árbol de carpetas; el panel principal lista los elementos de la carpeta actual con su tamaño, fecha de modificación y permisos. Las columnas se pueden ordenar (nombre, tamaño, fecha). Al hacer clic derecho sobre un elemento se abre el menú contextual completo.

Editor de código

Al hacer clic en el icono de edición (o en Editar del menú contextual) se abre el archivo en un editor a pantalla completa basado en CodeMirror, con resaltado de sintaxis para PHP, HTML, Smarty (.tpl), Twig, CSS/SCSS/LESS, JavaScript, JSON, XML, YAML, SQL y Markdown. Se admiten la búsqueda, el plegado de código y el emparejamiento de llaves.

• Solo son editables los tipos de archivo de texto y código (php, tpl, twig, css, js, json, xml, yml, md, sql, etc.).
• El tamaño máximo editable es de 5 MB por archivo.
• Haz clic en Guardar para escribir los cambios.

Subida de archivos

Sube archivos arrastrándolos a la zona correspondiente o mediante el botón Subir. Los archivos se colocan en la carpeta actual, siempre que tenga permisos de escritura.

Descarga y archivos ZIP

• Descargar un archivo: descarga el archivo seleccionado.
• Descargar ZIP: comprime una carpeta y la descarga como archivo ZIP con marca de tiempo.
• Guardar ZIP en el servidor: genera el archivo y lo guarda directamente en una carpeta de destino de la tienda, sin descargarlo.

Operaciones con archivos

El menú contextual (clic derecho) y las acciones de fila permiten:

• Renombrar un archivo o una carpeta.
• Copiar o Mover un elemento a otra carpeta mediante el árbol de destino.
• Eliminar un archivo o una carpeta (de forma recursiva).
• Propiedades: muestra la ruta, el tamaño, las fechas, los permisos, el propietario y el tipo MIME.

Modelo de seguridad

Explorer FTP aplica varias capas de protección:

• Ámbito raíz: todas las operaciones se limitan al directorio raíz de PrestaShop. Las rutas proporcionadas se normalizan con realpath() y se verifican para impedir cualquier salto de directorio («path traversal»).
• Token de seguridad: cada solicitud AJAX se valida con un token de administración, comparado en tiempo constante.
• Carpetas protegidas: los directorios críticos (app, bin, classes, config, controllers, override, src, tools, var, vendor) no se pueden eliminar.
• Subida restringida: lista blanca de extensiones y bloqueo de los tipos ejecutables (ver «Subida de archivos»).
• Cabeceras de seguridad: anti-clickjacking (X-Frame-Options) y anti-sniffing MIME (X-Content-Type-Options) en las respuestas del controlador.

Resolución de problemas

«El directorio no tiene permisos de escritura» al subir o crear

La carpeta de destino no tiene permisos de escritura. Ajusta los permisos de la carpeta correspondiente en tu servidor.

Las funciones ZIP no están disponibles

La extensión PHP ZipArchive no está instalada o activada en el servidor. Solicita a tu proveedor de alojamiento que la active.

No se puede subir un archivo PHP

Es el comportamiento esperado: la subida de archivos ejecutables está bloqueada. Para modificar un archivo PHP existente, utiliza el editor integrado.

Desinstalación

Desde Módulos > Gestor de módulos, haz clic en Desinstalar junto a Explorer FTP. Se elimina la pestaña de administración. Los archivos de la tienda y las copias de seguridad presentes en var/explorer_backups no se eliminan.