Explorer FTP (explorerftp) — Documentazione

Explorer FTP (explorerftp) è un file manager integrato nel back office di PrestaShop. Consente di esplorare l’albero dei file del negozio, modificare file di testo e di codice con un editor integrato, caricare e scaricare file ed esportare cartelle in formato ZIP, senza un client FTP esterno. Questa documentazione copre l’installazione, l’utilizzo completo, il modello di sicurezza e la risoluzione dei problemi.

Panoramica

Explorer FTP aggiunge una voce in Parametri avanzati del back office. Da questa interfaccia, un dipendente con i permessi necessari può esplorare i file del negozio, aprire un editor di codice con evidenziazione della sintassi, creare cartelle, rinominare, copiare, spostare o eliminare elementi, caricare file tramite trascinamento e generare archivi ZIP. Tutti gli accessi sono rigorosamente limitati alla directory radice di PrestaShop.

Requisiti

• PrestaShop 8.0 o superiore (compatibile con 9.x).
• PHP 8.0 o superiore.
• Estensione PHP ZipArchive per le funzioni di esportazione ZIP.

Installazione

Dal back office

1. Vai su Moduli > Gestore dei moduli.
2. Fai clic su Carica un modulo e seleziona l’archivio explorerftp.zip.
3. Il modulo si installa automaticamente e crea la sua scheda di amministrazione.

Tramite FTP

1. Decomprimi l’archivio e inserisci la cartella explorerftp nella directory /modules del tuo negozio.
2. In Moduli > Gestore dei moduli, cerca «Explorer FTP» e fai clic su Installa.

Accesso al modulo

Apri Parametri avanzati > Explorer FTP. L’accesso è riservato ai profili che dispongono del permesso sulla scheda AdminExplorerFtp: puoi limitarne l’uso a determinati profili dipendente da Team > Permessi.

Interfaccia

Barra degli strumenti

• Indietro / Cartella superiore / Aggiorna: navigazione nell’albero.
• Percorso di navigazione: mostra il percorso corrente e consente di risalire a qualsiasi livello.
• Ricerca: ricerca per nome di file o cartella nella directory corrente e nelle sue sottocartelle (le directory pesanti come vendor, var, cache, node_modules e .git vengono ignorate).
• Carica e Nuova cartella: aggiungere file o creare directory.

Albero ed elenco

Il pannello laterale mostra l’albero delle cartelle; il pannello principale elenca gli elementi della cartella corrente con dimensione, data di modifica e permessi. Le colonne sono ordinabili (nome, dimensione, data). Un clic destro su un elemento apre il menu contestuale completo.

Editor di codice

Un clic sull’icona di modifica (o su Modifica nel menu contestuale) apre il file in un editor a schermo intero basato su CodeMirror, con evidenziazione della sintassi per PHP, HTML, Smarty (.tpl), Twig, CSS/SCSS/LESS, JavaScript, JSON, XML, YAML, SQL e Markdown. Sono supportati la ricerca, il ripiegamento del codice e l’abbinamento delle parentesi.

• Sono modificabili solo i tipi di file di testo e di codice (php, tpl, twig, css, js, json, xml, yml, md, sql, ecc.).
• La dimensione massima modificabile è di 5 MB per file.
• Fai clic su Salva per scrivere le modifiche.

Caricamento di file

Carica i file trascinandoli nell’apposita zona o tramite il pulsante Carica. I file vengono collocati nella cartella corrente, purché sia scrivibile.

Download e archivi ZIP

• Scaricare un file: scarica il file selezionato.
• Scaricare ZIP: comprime una cartella e la scarica come archivio ZIP con marca temporale.
• Salvare ZIP sul server: genera l’archivio e lo salva direttamente in una cartella di destinazione del negozio, senza download.

Operazioni sui file

Il menu contestuale (clic destro) e le azioni di riga consentono di:

• Rinominare un file o una cartella.
• Copiare o Spostare un elemento in un’altra cartella tramite l’albero di destinazione.
• Eliminare un file o una cartella (in modo ricorsivo).
• Proprietà: mostra il percorso, la dimensione, le date, i permessi, il proprietario e il tipo MIME.

Modello di sicurezza

Explorer FTP applica diversi livelli di protezione:

• Ambito radice: tutte le operazioni sono limitate alla directory radice di PrestaShop. I percorsi forniti vengono normalizzati con realpath() e quindi verificati per impedire qualsiasi attraversamento di directory («path traversal»).
• Token di sicurezza: ogni richiesta AJAX è convalidata con un token di amministrazione, confrontato a tempo costante.
• Cartelle protette: le directory critiche (app, bin, classes, config, controllers, override, src, tools, var, vendor) non possono essere eliminate.
• Caricamento limitato: whitelist di estensioni e blocco dei tipi eseguibili (vedi «Caricamento di file»).
• Intestazioni di sicurezza: anti-clickjacking (X-Frame-Options) e anti-sniffing MIME (X-Content-Type-Options) nelle risposte del controller.

Risoluzione dei problemi

«La directory non è scrivibile» durante il caricamento o la creazione

La cartella di destinazione non dispone dei permessi di scrittura. Regola i permessi della cartella interessata sul tuo server.

Le funzioni ZIP non sono disponibili

L’estensione PHP ZipArchive non è installata o attivata sul server. Chiedi al tuo provider di hosting di attivarla.

Non è possibile caricare un file PHP

È il comportamento previsto: il caricamento di file eseguibili è bloccato. Per modificare un file PHP esistente, utilizza l’editor integrato.

Disinstallazione

Da Moduli > Gestore dei moduli, fai clic su Disinstalla accanto a Explorer FTP. La scheda di amministrazione viene rimossa. I file del negozio e i backup presenti in var/explorer_backups non vengono eliminati.