Add-On: FTP-Cloud
noneBeschreibung
Verfügbar ab Release 8.26.0
Das FTP-Cloud-Modul ermöglicht es, Dateien und Ordner von einem externen SFTP-Server direkt im Shop für angemeldete Benutzer bereitzustellen. Kunden können ihre Dateien in einer interaktiven Baumansicht durchsuchen, einzelne Dateien oder ganze Ordner herunterladen und bei Bedarf auch mehrere Dateien gleichzeitig als ZIP-Archiv herunterladen.
Typischer Einsatzzweck: Ein Unternehmen stellt seinen Kunden individuelle Druckdaten, Rechnungen oder andere Dokumente auf einem SFTP-Server bereit. Über das FTP-Cloud-Modul können die Kunden diese Dateien bequem im Shop abrufen -- ohne direkten SFTP-Zugang.
Funktionsumfang
Anbindung an einen oder mehrere SFTP-Server pro Shop
Benutzerspezifische Unterordner (z.B. pro Kundennummer)
Optionale Verschleierung des Benutzer-Unterpfades (DigitObfuscator)
Interaktive Baumansicht mit Ordnernavigation
Einzel- und Mehrfach-Download (auch als ZIP)
Konfigurierbares Caching der Verzeichnislisten
Mehrsprachig (Deutsch / Englisch)
Keine Zusatzkosten -- das Modul ist für alle Kunden kostenlos verfügbar
Backend-Konfiguration
Das Modul wird im Sitemanager unter Add-Ons > FTP-Cloud konfiguriert.
Ftp-Cloud Add-On Gesamtübersicht
Schritt 1: Shop auswählen
Oben auf der Seite befindet sich eine Shop-Auswahl. Die gesamte Konfiguration ist pro Shop -- jeder Shop kann unterschiedliche Verbindungen und Einstellungen haben.
Schritt 2: FTP-Cloud für Shop aktivieren
Feld | Beschreibung |
|---|---|
FTP-Cloud für Shop aktivieren | Aktiviert oder deaktiviert das gesamte Modul für den ausgewählten Shop. Wenn deaktiviert, wird im Shop nichts angezeigt. |
Schritt 3: Verbindungen konfigurieren
Über den Button "Neue Verbindung hinzufügen" wird eine neue Cloud-Verbindung angelegt. Es können mehrere Verbindungen pro Shop konfiguriert werden (z.B. für verschiedene SFTP-Server oder verschiedene Bereiche auf einem Server).
Jede Verbindung hat folgende Einstellungen:
Feld | Beschreibung |
|---|---|
Verbindung | Auswahl der SFTP-Zugangsdaten. Die Zugangsdaten werden zentral unter "Externe Verbindungen" verwaltet und hier referenziert. Über den Button "Neue Zugangsdaten" kann direkt eine neue SFTP-Verbindung erstellt werden. |
Anzuzeigender Name im Shop | Der Name, der im Shop als Titel für diese Verbindung angezeigt wird. |
Aktiv | Aktiviert oder deaktiviert diese einzelne Verbindung. Nur aktive Verbindungen werden im Shop angezeigt. |
Einstiegspunkt | Der Basispfad auf dem SFTP-Server, ab dem Dateien angezeigt werden (z.B. |
Dynamischer Benutzer-Unterpfad | Ermöglicht benutzerspezifische Unterordner. Wenn aktiviert, wird ein Benutzerfeld (z.B. Kundennummer) als Unterordner an den Einstiegspunkt angehängt. So sieht jeder Benutzer nur seine eigenen Dateien. |
Benutzer-Unterpfad verschleiern | Wenn aktiv, wird der dynamische Unterpfad verschleiert, sodass der tatsächliche Ordnername auf dem Server nicht direkt der Kundennummer o.ä. entspricht (siehe Abschnitt "Pfadverschleierung"). |
Cache TTL (Sekunden) | Wie lange eine geladene Verzeichnisliste zwischengespeichert wird (Standard: 300 Sekunden = 5 Minuten). Ein höherer Wert reduziert die Serverlast, Änderungen auf dem SFTP-Server werden aber erst nach Ablauf des Caches automatisch sichtbar. |
Die Reihenfolge der Verbindungen kann per Drag & Drop (am Griff-Symbol links) angepasst werden.
Dynamischer Benutzer-Unterpfad
Wenn ein Benutzerfeld als dynamischer Unterpfad ausgewählt wird, wird der Wert dieses Feldes automatisch als Unterordner an den Einstiegspunkt angehängt.
Beispiel:
Einstellung | Wert |
|---|---|
Einstiegspunkt |
|
Dynamischer Benutzer-Unterpfad |
|
Kundennummer des angemeldeten Benutzers |
|
Resultierender Pfad |
|
Verfügbare Benutzerfelder sind unter anderem:
id(Benutzer-ID)customer_user_kundennummer(Kundennummer)customer_user_costcenter(Kostenstelle)customer_user_company1(Firma)customer_user_code(Benutzercode)und weitere SSO-Benutzerfelder
Pfadverschleierung (DigitObfuscator)
Wenn die Option "Benutzer-Unterpfad verschleiern" aktiviert ist, wird der Unterpfad so umgewandelt, dass er auf dem SFTP-Server nicht direkt der Kundennummer entspricht. Dies bietet eine zusätzliche Ebene der Verschleierung.
Dies folgt aktuell einem sehr spezifischen Muster und kann nur nach Rücksprache mit dem Support verwendet werden.
Hinweis: In den meisten Fällen ist die Pfadverschleierung nicht notwendig. Die Dateien werden über eine authentifizierte Verbindung vom SFTP-Server geladen und sind nur für den jeweils angemeldeten Benutzer sichtbar. Der Ordnerpfad auf dem Server ist für Shop-Benutzer nicht einsehbar.
Die Verschleierung ist nur dann relevant, wenn die gleiche Ordnerstruktur auf dem SFTP-Server auch über einen anderen, öffentlich zugänglichen Weg erreichbar ist (z.B. über einen zusätzlichen HTTP-Zugang oder ein öffentliches Verzeichnis). In diesem Fall verhindert die Verschleierung, dass aus einer bekannten Kundennummer direkt auf den zugehörigen Ordnernamen geschlossen werden kann.
Shop-Ansicht
Im Shop sehen angemeldete Benutzer die Dateien der konfigurierten Verbindung in einer interaktiven Baumansicht.
Funktionen in der Shop-Ansicht
Funktion | Beschreibung |
|---|---|
Ordnernavigation | Ordner können auf- und zugeklappt werden. Unterordner werden bei Bedarf nachgeladen. |
Einzel-Download | Jede Datei und jeder Ordner hat einen Download-Button. Bei Ordnern wird automatisch ein ZIP-Archiv erstellt. |
Mehrfach-Download | Über Checkboxen können mehrere Dateien und Ordner ausgewählt und gemeinsam als ZIP heruntergeladen werden. Die Download-Leiste erscheint automatisch, sobald mindestens eine Datei ausgewählt ist. |
Cache-Anzeige | Unterhalb des Titels wird angezeigt, wann die Verzeichnisliste zuletzt aktualisiert wurde (z.B. "Stand: 06.03.2026, 14:30"). |
Aktualisieren | Über den Refresh-Button (neben der Cache-Anzeige) kann die Verzeichnisliste manuell neu vom SFTP-Server geladen werden, ohne auf den Cache-Ablauf zu warten. Auch einzelne Ordner haben einen Refresh-Button. |
Datei-Informationen
Für jede Datei werden angezeigt:
Dateiname
Dateigröße (automatisch formatiert, z.B. "1.95 MB")
Icon basierend auf dem Dateityp (PDF, Word, Excel, Bilder, ZIP-Archive etc.)
Änderungsdatum (als Tooltip beim Hovern)
Sprachvariablen
Alle Texte in der Shop-Ansicht sind übersetzbar und können pro Shop im Backend unter den Spracheinstellungen angepasst werden:
Sprachvariable | Deutsch (Standard) | Englisch (Standard) |
|---|---|---|
| Dateien werden geladen... | Loading files... |
| Keine Dateien vorhanden. | No files available. |
| Dateien herunterladen | Download files |
| Laden... | Loading... |
| Fehler beim Laden | Error loading |
| Verbindung fehlgeschlagen. | Connection failed. |
| Erneut versuchen | Try again |
| Ordner aktualisieren | Refresh folder |
| Download | Download |
| Stand: | Last updated: |
Häufige Fragen (FAQ)
Warum sehe ich "Keine Dateien vorhanden"?
Mögliche Ursachen:
Der Ordner auf dem SFTP-Server existiert noch nicht -- Prüfen Sie, ob der konfigurierte Einstiegspunkt (und ggf. der benutzerspezifische Unterordner) auf dem Server vorhanden ist.
Cache -- Klicken Sie auf den Refresh-Button neben der Cache-Anzeige, um die Verzeichnisliste neu vom Server zu laden.
Pfadverschleierung aktiv -- Wenn "Benutzer-Unterpfad verschleiern" aktiviert ist, muss der Ordner auf dem Server mit dem verschleierten Namen angelegt sein (siehe Abschnitt "Pfadverschleierung").
Wie oft wird die Dateiliste aktualisiert?
Die Dateiliste wird entsprechend der konfigurierten Cache TTL zwischengespeichert (Standard: 5 Minuten). Innerhalb dieses Zeitraums werden keine neuen Anfragen an den SFTP-Server gesendet. Benutzer können die Liste jederzeit manuell über den Refresh-Button aktualisieren.
Können verschiedene Benutzer unterschiedliche Dateien sehen?
Ja, wenn ein dynamischer Benutzer-Unterpfad konfiguriert ist. Jeder Benutzer sieht dann nur die Dateien in seinem persönlichen Unterordner auf dem SFTP-Server.
Welche Dateitypen werden unterstützt?
Es gibt keine Einschränkung bei den Dateitypen. Alle Dateien auf dem SFTP-Server werden angezeigt und können heruntergeladen werden. Bestimmte Dateitypen (PDF, Word, Excel, Bilder, ZIP) erhalten ein passendes Icon.
Kann ich mehrere SFTP-Server pro Shop anbinden?
Ja, über den Button "Neue Verbindung hinzufügen" können beliebig viele Verbindungen konfiguriert werden. Jede Verbindung kann auf einen anderen SFTP-Server oder einen anderen Bereich auf demselben Server zeigen.