# 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…

- Strona: <https://www.datafirefly.com/pl/documentation/explorerftp/>
- Język: pl
- Zaktualizowano: 2026-08-12
- Inne języki: [fr](https://www.datafirefly.com/documentation/explorerftp/index.md), [en](https://www.datafirefly.com/en/documentation/explorerftp/index.md), [es](https://www.datafirefly.com/es/documentation/explorerftp/index.md), [de](https://www.datafirefly.com/de/documentation/explorerftp/index.md), [it](https://www.datafirefly.com/it/documentation/explorerftp/index.md), [pt](https://www.datafirefly.com/pt/documentation/explorerftp/index.md), [nl](https://www.datafirefly.com/nl/documentation/explorerftp/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

**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_.

Po instalacji pozycja **Explorer FTP** pojawia się w menu _Zaawansowane_.

## 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.

Przy każdym zapisie tworzona jest kopia zapasowa pliku ze znacznikiem czasu w `var/explorer_backups`. Zachowywanych jest 50 najnowszych kopii; starsze są automatycznie usuwane.

## 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.

Ze względów bezpieczeństwa typy plików wykonywalnych po stronie serwera (`php`, `phtml`, `phar`, `cgi`, `sh` itd.) są odrzucane przy imporcie. Akceptowane są tylko bezpieczne formaty (dokumenty, obrazy, czcionki, archiwa, pliki tekstowe i webowe). Istniejące pliki PHP pozostają edytowalne przez edytor.

## 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.

Explorer FTP to potężne narzędzie administracyjne. Zarezerwuj dostęp dla zaufanych profili pracowników i upewnij się, że back-office jest serwowany przez HTTPS.

## 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.

W razie niefortunnej modyfikacji pliku odzyskaj poprzednią wersję z `var/explorer_backups`.

## 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.