Explorer FTP (explorerftp) — Dokumentation

Explorer FTP (explorerftp) ist ein in das PrestaShop-Backoffice integrierter Dateimanager. Er ermöglicht es, den Dateibaum des Shops zu durchsuchen, Text- und Codedateien mit einem integrierten Editor zu bearbeiten, Dateien hoch- und herunterzuladen sowie Ordner als ZIP-Archive zu exportieren – ohne externen FTP-Client. Diese Dokumentation behandelt Installation, vollständige Nutzung, Sicherheitsmodell und Fehlerbehebung.

Überblick

Explorer FTP fügt einen Eintrag unter Erweiterte Einstellungen im Backoffice hinzu. Über diese Oberfläche kann ein Mitarbeiter mit den erforderlichen Berechtigungen die Dateien des Shops durchsuchen, einen Code-Editor mit Syntaxhervorhebung öffnen, Ordner erstellen, Elemente umbenennen, kopieren, verschieben oder löschen, Dateien per Drag-and-Drop hochladen und ZIP-Archive erzeugen. Alle Zugriffe sind streng auf das PrestaShop-Stammverzeichnis beschränkt.

Voraussetzungen

• PrestaShop 8.0 oder höher (kompatibel mit 9.x).
• PHP 8.0 oder höher.
• PHP-Erweiterung ZipArchive für die ZIP-Exportfunktionen.

Installation

Über das Backoffice

1. Gehen Sie zu Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und wählen Sie das Archiv explorerftp.zip aus.
3. Das Modul wird automatisch installiert und legt seinen Verwaltungs-Tab an.

Per FTP

1. Entpacken Sie das Archiv und legen Sie den Ordner explorerftp in das Verzeichnis /modules Ihres Shops.
2. Suchen Sie in Module > Modul-Manager nach „Explorer FTP“ und klicken Sie auf Installieren.

Zugriff auf das Modul

Öffnen Sie Erweiterte Einstellungen > Explorer FTP. Der Zugriff ist auf Profile mit Berechtigung für den Tab AdminExplorerFtp beschränkt: Sie können die Nutzung über Team > Berechtigungen auf bestimmte Mitarbeiterprofile einschränken.

Oberfläche

Symbolleiste

• Zurück / Übergeordneter Ordner / Aktualisieren: Navigation im Baum.
• Brotkrümelnavigation: zeigt den aktuellen Pfad an und ermöglicht die Rückkehr zu jeder Ebene.
• Suche: Suche nach Datei- oder Ordnernamen im aktuellen Verzeichnis und seinen Unterordnern (umfangreiche Verzeichnisse wie vendor, var, cache, node_modules und .git werden übersprungen).
• Hochladen und Neuer Ordner: Dateien hinzufügen oder Verzeichnisse erstellen.

Baum und Liste

Das Seitenpanel zeigt den Ordnerbaum; das Hauptpanel listet die Elemente des aktuellen Ordners mit Größe, Änderungsdatum und Berechtigungen auf. Die Spalten sind sortierbar (Name, Größe, Datum). Ein Rechtsklick auf ein Element öffnet das vollständige Kontextmenü.

Code-Editor

Ein Klick auf das Bearbeiten-Symbol (oder auf Bearbeiten im Kontextmenü) öffnet die Datei in einem Vollbild-Editor auf Basis von CodeMirror, mit Syntaxhervorhebung für PHP, HTML, Smarty (.tpl), Twig, CSS/SCSS/LESS, JavaScript, JSON, XML, YAML, SQL und Markdown. Suche, Code-Faltung und Klammer-Abgleich werden unterstützt.

• Nur Text- und Codedateitypen sind bearbeitbar (php, tpl, twig, css, js, json, xml, yml, md, sql usw.).
• Die maximale bearbeitbare Größe beträgt 5 MB pro Datei.
• Klicken Sie auf Speichern, um die Änderungen zu schreiben.

Dateien hochladen

Laden Sie Dateien per Drag-and-Drop in die entsprechende Zone oder über die Schaltfläche Hochladen. Die Dateien werden im aktuellen Ordner abgelegt, sofern dieser beschreibbar ist.

Download und ZIP-Archive

• Datei herunterladen: lädt die ausgewählte Datei herunter.
• ZIP herunterladen: komprimiert einen Ordner und lädt ihn als ZIP-Archiv mit Zeitstempel herunter.
• ZIP auf dem Server speichern: erzeugt das Archiv und speichert es direkt in einem Zielordner des Shops, ohne Download.

Dateioperationen

Das Kontextmenü (Rechtsklick) und die Zeilenaktionen ermöglichen:

• Umbenennen einer Datei oder eines Ordners.
• Kopieren oder Verschieben eines Elements in einen anderen Ordner über den Zielbaum.
• Löschen einer Datei oder eines Ordners (rekursiv).
• Eigenschaften: zeigt Pfad, Größe, Daten, Berechtigungen, Eigentümer und MIME-Typ an.

Sicherheitsmodell

Explorer FTP wendet mehrere Schutzebenen an:

• Stammverzeichnis-Beschränkung: Alle Vorgänge sind auf das PrestaShop-Stammverzeichnis beschränkt. Übergebene Pfade werden mit realpath() normalisiert und anschließend geprüft, um jegliches Directory Traversal („path traversal“) zu verhindern.
• Sicherheitstoken: Jede AJAX-Anfrage wird mit einem Admin-Token validiert, das in konstanter Zeit verglichen wird.
• Geschützte Ordner: Kritische Verzeichnisse (app, bin, classes, config, controllers, override, src, tools, var, vendor) können nicht gelöscht werden.
• Eingeschränkter Upload: Whitelist von Erweiterungen und Blockierung ausführbarer Typen (siehe „Dateien hochladen“).
• Sicherheits-Header: Anti-Clickjacking (X-Frame-Options) und Anti-MIME-Sniffing (X-Content-Type-Options) in den Antworten des Controllers.

Fehlerbehebung

„Verzeichnis ist nicht beschreibbar“ beim Hochladen oder Erstellen

Der Zielordner hat keine Schreibrechte. Passen Sie die Berechtigungen des betreffenden Ordners auf Ihrem Server an.

Die ZIP-Funktionen sind nicht verfügbar

Die PHP-Erweiterung ZipArchive ist auf dem Server nicht installiert oder aktiviert. Bitten Sie Ihren Hoster, sie zu aktivieren.

Eine PHP-Datei kann nicht hochgeladen werden

Das ist das erwartete Verhalten: Das Hochladen ausführbarer Dateien ist blockiert. Verwenden Sie zum Ändern einer vorhandenen PHP-Datei den integrierten Editor.

Deinstallation

Klicken Sie in Module > Modul-Manager neben Explorer FTP auf Deinstallieren. Der Verwaltungs-Tab wird entfernt. Die Dateien des Shops und die Sicherungen in var/explorer_backups werden nicht gelöscht.