Dokumentation

Dateien

Dateiverwaltung, Bildgrößen, Dateilimit und Dateiabruf.

Allgemein

Dateien können in verschiedenen Modulen genutzt werden, zum Beispiel für Artikelbilder, Kursbilder, Website-Medien, Wallet-Grafiken oder Dokumentanhänge. Originaldateien bleiben erhalten; erzeugte Bildvarianten können bei Bedarf neu erstellt werden.

Im Manager

Die globale Konfiguration für Bildgrößen befindet sich unter Einstellungen > Dateien. Die eigentliche Dateiauswahl oder der Upload erscheint zusätzlich in den jeweiligen Modulen, zum Beispiel bei Artikeln, Kursen, Apps, Webseiten oder Wallet-Designs.

Dateilimit und Cloud-Speicher

Jede simplebis-Umgebung hat ein Dateilimit. Dieses Limit beschreibt, wie viel Cloud-Speicher die Umgebung für hochgeladene Dateien verwenden darf. Zum Speicher zählen die in der Umgebung hochgeladenen Dateien aus dem Dateimanager und aus Modulen, die den Dateimanager verwenden.

Den aktuell verwendeten Cloud-Speicher kannst du in Echtzeit auf der Startseite der Umgebungseinstellungen einsehen. Öffne dazu Einstellungen > Allgemeine Einstellungen. Dort gibt es die Kachel Dateien; sie zeigt den momentan belegten Speicher an und verlinkt in die Datei-Einstellungen.

Wenn der Speicherverbrauch nahe am Limit liegt, sollten nicht mehr benötigte Dateien geprüft und gelöscht werden. Besonders große Bilder, PDFs, Dokumente oder mehrfach hochgeladene Medien können den belegten Speicher schnell erhöhen. Generierte Thumbnail- oder Resize-Dateien können zusätzlich über Einstellungen > Dateien neu aufgebaut beziehungsweise bereinigt werden; die Originaldateien bleiben dabei erhalten.

Thumbnails

Thumbnail-Presets erzeugen quadratische oder feste Vorschaubilder. Jedes Preset hat einen eindeutigen Key, eine Breite und eine Höhe. Standardmäßig sind xs mit 300x300, md mit 600x600 und lg mit 800x800 vorgesehen.

Resizes

Resize-Presets erzeugen skalierte Bildvarianten mit einer Zielbreite. Standardmäßig gibt es xs mit 300, md mit 600 und lg mit 800 Pixel Breite. Die Höhe wird passend zum Seitenverhältnis berechnet.

Generierte Bilder löschen

Wenn Thumbnail- oder Resize-Presets geändert werden, können unter Einstellungen > Dateien die generierten Bilder gelöscht werden. Die Originaldateien bleiben dabei erhalten. Danach werden benötigte Varianten wieder neu erzeugt, sobald sie angefordert werden.

Dateien abrufen

Dateien können über /api/files abgerufen werden. Für die Originaldatei wird die Datei-ID übergeben, zum Beispiel /api/files?fileid=DATEI_ID. Für ein Thumbnail wird thumb ergänzt, zum Beispiel /api/files?fileid=DATEI_ID&thumb=md. Für eine skalierte Variante wird resize ergänzt, zum Beispiel /api/files?fileid=DATEI_ID&resize=lg. Mit download=1 kann eine Datei als Download statt inline geöffnet werden.