Explorer FTP (explorerftp) — Dokumentacja

Explorer FTP (explorerftp) to menedżer plików zintegrowany z back-office PrestaShop. Pozwala przeglądać strukturę katalogów sklepu, edytować pliki tekstowe i kod dzięki wbudowanemu edytorowi, importować i pobierać pliki oraz eksportować foldery do formatu ZIP — bez zewnętrznego klienta FTP. Ta dokumentacja obejmuje instalację, pełne użytkowanie, model bezpieczeństwa i rozwiązywanie problemów.

Prezentacja

Explorer FTP dodaje pozycję w sekcji Zaawansowane back-office. Z tego interfejsu pracownik z odpowiednimi uprawnieniami może nawigować po plikach sklepu, otwierać edytor kodu z kolorowaniem składni, tworzyć foldery, zmieniać nazwy, kopiować, przenosić lub usuwać elementy, importować pliki metodą przeciągnij i upuść oraz generować archiwa ZIP. Wszystkie dostępy są ściśle ograniczone do katalogu głównego PrestaShop.

Wymagania wstępne

• PrestaShop 8.0 lub nowszy (kompatybilny z 9.x).
• PHP 8.0 lub nowszy.
• Rozszerzenie PHP ZipArchive dla funkcji eksportu ZIP.

Instalacja

Z back-office

1. Przejdź do Moduły > Menedżer modułów.
2. Kliknij Wgraj moduł i wybierz archiwum explorerftp.zip.
3. Moduł instaluje się automatycznie i tworzy swoją zakładkę administracyjną.

Przez FTP

1. Rozpakuj archiwum i umieść folder explorerftp w katalogu /modules sklepu.
2. W Moduły > Menedżer modułów wyszukaj „Explorer FTP” i kliknij Zainstaluj.

Dostęp do modułu

Otwórz Zaawansowane > Explorer FTP. Dostęp jest zarezerwowany dla profili z uprawnieniem do zakładki AdminExplorerFtp: możesz ograniczyć jego użycie do wybranych profili pracowników w Zespół > Uprawnienia.

Interfejs

Pasek narzędzi

• Wstecz / Folder nadrzędny / Odśwież: nawigacja po strukturze.
• Okruszki: pokazują bieżącą ścieżkę i pozwalają wrócić na dowolny poziom.
• Wyszukiwanie: wyszukiwanie po nazwie pliku lub folderu w bieżącym katalogu i podkatalogach (ciężkie katalogi jak vendor, var, cache, node_modules i .git są pomijane).
• Wgraj i Nowy folder: dodawanie plików lub tworzenie katalogów.

Drzewo i lista

Panel boczny wyświetla drzewo folderów; panel główny listuje elementy bieżącego folderu z rozmiarem, datą modyfikacji i uprawnieniami. Kolumny są sortowalne (nazwa, rozmiar, data). Prawy klik na elemencie otwiera pełne menu kontekstowe.

Edytor kodu

Kliknięcie ikony edycji (lub Modyfikuj w menu kontekstowym) otwiera plik w pełnoekranowym edytorze opartym na CodeMirror, z kolorowaniem składni dla PHP, HTML, Smarty (.tpl), Twig, CSS/SCSS/LESS, JavaScript, JSON, XML, YAML, SQL i Markdown. Obsługiwane są wyszukiwanie, zwijanie kodu i dopasowywanie nawiasów.

• Edytowalne są tylko typy plików tekstowych i kodu (php, tpl, twig, css, js, json, xml, yml, md, sql itd.).
• Maksymalny rozmiar edycji to 5 MB na plik.
• Kliknij Zapisz, aby zapisać zmiany.

Import plików

Importuj pliki metodą przeciągnij i upuść w dedykowanej strefie lub przyciskiem Wgraj. Pliki trafiają do bieżącego folderu, o ile jest zapisywalny.

Pobieranie i archiwa ZIP

• Pobierz plik: pobiera zaznaczony plik.
• Pobierz ZIP: kompresuje folder i pobiera go jako archiwum ZIP ze znacznikiem czasu.
• Zapisz ZIP na serwerze: generuje archiwum i zapisuje je bezpośrednio w docelowym folderze sklepu, bez pobierania.

Operacje na plikach

Menu kontekstowe (prawy klik) i akcje wiersza pozwalają:

• Zmienić nazwę pliku lub folderu.
• Skopiować lub Przenieść element do innego folderu przez drzewo docelowe.
• Usunąć plik lub folder (rekurencyjnie).
• Właściwości: wyświetla ścieżkę, rozmiar, daty, uprawnienia, właściciela i typ MIME.

Model bezpieczeństwa

Explorer FTP stosuje kilka warstw ochrony:

• Obszar główny: wszystkie operacje są ograniczone do katalogu głównego PrestaShop. Podane ścieżki są normalizowane przez realpath(), a następnie weryfikowane, aby uniemożliwić przejście katalogów („path traversal”).
• Token bezpieczeństwa: każde żądanie AJAX jest walidowane tokenem administracyjnym, porównywanym w czasie stałym.
• Foldery chronione: krytyczne katalogi (app, bin, classes, config, controllers, override, src, tools, var, vendor) nie mogą być usuwane.
• Ograniczony import: biała lista rozszerzeń i blokada typów wykonywalnych (patrz „Import plików”).
• Nagłówki bezpieczeństwa: anty-clickjacking (X-Frame-Options) i anty-sniffing MIME (X-Content-Type-Options) w odpowiedziach kontrolera.

Rozwiązywanie problemów

„Katalog niezapisywalny” przy imporcie lub tworzeniu

Folder docelowy nie ma uprawnień do zapisu. Dostosuj uprawnienia danego folderu na serwerze.

Funkcje ZIP są niedostępne

Rozszerzenie PHP ZipArchive nie jest zainstalowane lub aktywne na serwerze. Aktywuj je u swojego hostingodawcy.

Nie można zaimportować pliku PHP

To oczekiwane zachowanie: import plików wykonywalnych jest zablokowany. Aby zmodyfikować istniejący plik PHP, użyj wbudowanego edytora.

Odinstalowanie

W Moduły > Menedżer modułów kliknij Odinstaluj przy Explorer FTP. Zakładka administracyjna zostaje usunięta. Pliki sklepu i kopie zapasowe w var/explorer_backups nie są usuwane.