https://github.com/friendsofredaxo/yform_dropzone
Erweitert YForm für REDAXO um Multiuploads mit Drag & Drop
https://github.com/friendsofredaxo/yform_dropzone
dropzone dropzonejs php redaxo redaxo-addon upload uploader yform
Last synced: 12 months ago
JSON representation
Erweitert YForm für REDAXO um Multiuploads mit Drag & Drop
- Host: GitHub
- URL: https://github.com/friendsofredaxo/yform_dropzone
- Owner: FriendsOfREDAXO
- License: mit
- Created: 2019-02-22T16:38:40.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-09-09T22:17:40.000Z (almost 2 years ago)
- Last Synced: 2025-04-06T17:12:05.930Z (about 1 year ago)
- Topics: dropzone, dropzonejs, php, redaxo, redaxo-addon, upload, uploader, yform
- Language: JavaScript
- Homepage:
- Size: 111 KB
- Stars: 24
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dropzone Multi-Upload-Feld mit Drag & Drop für YForm 4
## Übersicht
Dieses Addon bindet [dropzone.js](https://github.com/enyo/dropzone/) ein und fügt YForm die Value `dropzone` hinzu. Diese bietet eine Möglichkeit, mehrere Dateien auf einmal hochzuladen.
## Features
* Mehrere Dateien in ein YForm-Value hochladen
* Drag & Drop Upload im Frontend und im Table Manager
* Download der Dateien direkt aus der Tabellenübersicht des Table Managers
* Einschränkung maximale Dateigröße je Datei
* Einschränkung des Dateityps (Dateiendungen) sowohl clientseitig (Datei-Auswahl-Dialog des Betriebssystems), als auch serverseitig (Validierung)
> **Hinweis:** Es sollte sichergestellt sein, dass der Webspace genügend Speicherplatz hat, um größere Mengen an Uploads problemlos abzuspeichern.
## Erste Schritte
### Setup
Nach der Installation ist das Feld in YForm verfügbar.
### Feld hinzufügen (Table Manager)
1. In REDAXO auf `YForm` > `Table Manager` klicken
2. In der gewünschten Tabelle die Felddefinition editieren
3. Das Feld `dropzone` hinzufügen und den Instruktionen folgen
4. Lang-Parameter hinzufügen:
```
{
"add":"Dateien hinzufügen",
"start":"Upload starten",
"clear":"zurücksetzen",
"dictDefaultMessage":"Dateien auf dieses Feld ziehen",
"dictFallbackMessage":"Ihr Browser untersützt leider keine Drag\'n\'Drop Datei Uploads",
"dictFallbackText":"",
"dictFileTooBig":"Datei ist zu groß",
"dictInvalidFileType":"Dateityp wird nicht unterstützt",
"dictResponseError":"Ein Fehler ist aufgetreten. Ein oder mehrere Dateien konnten nicht hochgeladen werden.",
"dictCancelUpload":"abbrechen",
"dictUploadCanceled":"Upload wurde abgebrochen",
"dictCancelUploadConfirmation":"Upload wird abgebrochen",
"dictRemoveFile":"entfernen",
"dictRemoveFileConfirmation":"Datei wird entfernt",
"dictMaxFilesExceeded":"Zuviele Dateien",
"dictFileSizeUnits":"mb"
}
```
Anschließend kann das Feld verwendet werden.
## Links und Hilfe
### Hinweise und bekannte Probleme in dieser Version
> **ACHTUNG:** Im Moment muss eine hidden-Value namens `order_id` im Formular vorhanden sein, das einen einmaligen Key generiert. Beteilige dich am Addon, um dieses Problem zu lösen. z.B.: `$yform->setValueField('hidden', array('order_id',bin2hex(openssl_random_pseudo_bytes(16))));`
> Es wird jQuery benötigt.
> Die Einstellung "Pflichtfeld" ist ohne Funktion
## Debugging
Wenn was mit der Dropzone clientseitig schief läuft, ist das Problem entweder in der mitgelieferten JS-Datei in `/assets/addons/yform_dropzone/js/`, oder serverseitig in der API unter `/redaxo/src/addons/yform_dropzone/lib/`.
Erster Ansatz: Browser-Developer-Console liefert beim Fehler zusätzliche Infos als JSON in der Response, z.B. bei der Validierung (Dateigröße, Formate, oder, ob die Datei bereits vorhanden war).
Meist stimmt einfach was mit den Parametern der Validierung nicht.
## Bugmeldungen Hilfe und Links
* Auf Github: https://github.com/FriendsOfREDAXO/yform_dropzone/issues
* im Forum: https://www.REDAXO.org/forum/
* im Slack-Channel: https://friendsofREDAXO.slack.com/