Download the PHP package heimrichhannot/contao-multifileupload-bundle without Composer
On this page you can find all versions of the php package heimrichhannot/contao-multifileupload-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download heimrichhannot/contao-multifileupload-bundle
More information about heimrichhannot/contao-multifileupload-bundle
Files in heimrichhannot/contao-multifileupload-bundle
Package contao-multifileupload-bundle
Short Description Contao front end widget that provides dropzonejs.com functionality.
License LGPL-3.0-or-later
Homepage https://github.com/heimrichhannot/contao-multifileupload-bundle
Informations about the package contao-multifileupload-bundle
Contao Multi File Upload Bundle
Contao front end widget that provides dropzonejs.com functionality to both back and front end.
Features
- javascript written in native javascript
- support for jquery ajaxComplete and mootools ajax_change events
- support for Contao Form Generator
- support for Encore Bundle
- support for Formhybrid Compatibility Bundle Bundle formhybrid_ajax_complete event
Usage
Install
-
Install heimrichhannot/contao-multifileupload-bundle via composer or contao manager
- Update your database
Form Generator
Create your form and use the File-Upload (Multi File Upload)
field type.
DCA
Create a widget of inputType multifileupload
. It is usable in the contao backend or in the contao frontend in combination with Formhybrid.
Example for simple single image file upload:
Example for simple multiple image file upload:
Example for multi image upload with additional config (maximum 5 files with custom image size):
Documentation
Supported dropzone config options
The bundles support most dropzone config options. Just pass them as eval attribute. See Dropzone Documentation for more information. Some additional node:
addRemoveLinks
(boolean, default true): If true, this will add a link to every file preview to remove or cancel (if already uploading) the file.maxFilesize
: Is set bymaxUploadSize
eval property
Flow chart
A flowchart with description of the full upload procedure with callback injection can be found here: Flowchart.
Additional eval properties
Additional properties can be set in your fields eval section.
Name | Default | Description |
---|---|---|
minImageWidthErrorText | $GLOBALS['TL_LANG']['ERR']['minWidth'] | Custom error message for minimum image width. (arguments provided: 1 - minimum width from config, 2 - current image width) |
minImageHeightErrorText | $GLOBALS['TL_LANG']['ERR']['minHeight'] | Custom error message for minimum image height. (arguments provided: 1 - minimum height from config, 2 - current image height) |
maxImageWidthErrorText | $GLOBALS['TL_LANG']['ERR']['maxWidth'] | Custom error message for maximum image width. (arguments provided: 1 - maximum width from config, 2 - current image width) |
maxImageHeightErrorText | $GLOBALS['TL_LANG']['ERR']['maxHeight'] | Custom error message for maximum image height. (arguments provided: 1 - maximum height from config, 2 - current image height) |
createImageThumbnails | boolean(true) | Set to false if you dont want to preview thumbnails. |
mimeFolder | system/modules/multifileupload/assets/img/mimetypes/Numix-uTouch | The relative path from contao root to custom mimetype folder, mimetypes.json and images must lie inside. (example: system/modules/multifileupload/assets/img/mimetypes/Numix-uTouch) |
mimeThumbnailsOnly | boolean(false) | Set to true if you want to show mime image thumbnails only, and no image preview at all. (performance improvement) |
thumbnailWidth | 90 | The thumbnail width (in px) of the uploaded file preview within the dropzone preview container. |
thumbnailHeight | 90 | The thumbnail height (in px) of the uploaded file preview within the dropzone preview container. |
hideLabel | false | Hide widget label (Frontend) |
mimeTypes | null |
A comma separated list of allowed mime types (e.g. 'application/x-compressed,application/x-zip-compressed,application/zip,multipart/x-zip' ). Set to empty string '' if you don't want to restrict mime types. Set to null if you just want to restrict mime types if they differ while automatic detection. |
timeout | null | Dropzone Request timeout in milliseconds. See Documentation |
Field Callbacks
Type | Arguments | Expected return value | Description |
---|---|---|---|
uploadPathCallback | $strTarget, \File $objFile, \DataContainer $dc | $strTarget | Manipulate the upload path after form submission (run within onsubmit_callback). |
validateUploadCallback | \File $objFile, \Widget $objWidget | boolean(false) or string with frontend error message | Validate the uploaded file and add an error message if file does not pass validation, otherwise boolean(false) is expected. |
Developers
PHP Events
Events dispatched by symfony event dispatcher.
Event | Description |
---|---|
PostUploadEvent | Allows working with the files after upload to upload destination. |
All versions of contao-multifileupload-bundle with dependencies
contao/core-bundle Version ^4.9
heimrichhannot/contao-ajax-bundle Version ^1.0
heimrichhannot/contao-encore-contracts Version ^1.0
heimrichhannot/contao-utils-bundle Version ^2.238
psr/log Version ^1.0 || ^2.0 || ^3.0
symfony/http-foundation Version ^4.4 || ^5.4 || ^6.0
symfony/polyfill-php80 Version ^1.26
symfony/service-contracts Version ^1.0 || ^2.0 || ^3.0