PHPackages heimrichhannot/contao-multifileupload-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. heimrichhannot/contao-multifileupload-bundle ActiveContao-bundle[Utility & Helpers](/categories/utility) heimrichhannot/contao-multifileupload-bundle ============================================ Contao front end widget that provides dropzonejs.com functionality. 1.10.0(5mo ago)07.2k[3 issues](https://github.com/heimrichhannot/contao-multifileupload-bundle/issues)[3 PRs](https://github.com/heimrichhannot/contao-multifileupload-bundle/pulls)LGPL-3.0-or-laterPHPPHP ^7.4 || ^8.0CI failing Since Apr 3Pushed 2mo ago4 watchersCompare [ Source](https://github.com/heimrichhannot/contao-multifileupload-bundle)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-multifileupload-bundle)[ Docs](https://github.com/heimrichhannot/contao-multifileupload-bundle)[ RSS](/packages/heimrichhannot-contao-multifileupload-bundle/feed)WikiDiscussions master Synced yesterday READMEChangelog (10)Dependencies (16)Versions (59)Used By (0) [![](https://camo.githubusercontent.com/b73f54b62d2f74decdc8bf715b9edf5ba7442d9af39df0931222fc38717a22a6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6865696d7269636868616e6e6f742f636f6e74616f2d6d756c746966696c6575706c6f61642d62756e646c652e737667)](https://packagist.org/packages/heimrichhannot/contao-multifileupload-bundle)[![](https://camo.githubusercontent.com/164ebe7dbddb62f0464875067e8b6ccb8a291ccdb98e7dc59fa9ba07247c8f1c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6865696d7269636868616e6e6f742f636f6e74616f2d6d756c746966696c6575706c6f61642d62756e646c652e737667)](https://packagist.org/packages/heimrichhannot/contao-multifileupload-bundle)[![](https://camo.githubusercontent.com/2708e006d23cf6e140a7915a1b03f34c3fac15220d012066284b8b25153a8607/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6865696d7269636868616e6e6f742f636f6e74616f2d6d756c746966696c6575706c6f61642d62756e646c652e737667)](https://packagist.org/packages/heimrichhannot/contao-multifileupload-bundle) Contao Multi File Upload Bundle =============================== [](#contao-multi-file-upload-bundle) Contao front end widget that provides [dropzonejs.com](http://www.dropzonejs.com/) functionality to both back and front end. [![alt text](/doc/multifileupload-demo.jpg "Multifileupload demo within contao backend")](/doc/multifileupload-demo.jpg) Features -------- [](#features) - javascript written in native javascript - support for jquery ajaxComplete and mootools ajax\_change events - support for Contao Form Generator - support for [Encore Bundle](https://github.com/heimrichhannot/contao-encore-bundle) - support for [Formhybrid Compatibility Bundle Bundle](https://github.com/heimrichhannot/contao-formhybrid-compatibility-bundle) formhybrid\_ajax\_complete event Usage ----- [](#usage) ### Install [](#install) 1. Install heimrichhannot/contao-multifileupload-bundle via composer or contao manager ``` composer require heimrichhannot/contao-multifileupload-bundle ``` 2. Update your database ### Form Generator [](#form-generator) Create your form and use the `File-Upload (Multi File Upload)` field type. [![Screenshot of the multi column editor field type in the contao form generator backend.](doc/img/screenshot_backend_formgenerator.png)](doc/img/screenshot_backend_formgenerator.png) ### DCA [](#dca) Create a widget of inputType `multifileupload`. It is usable in the contao backend or in the contao frontend in combination with [Formhybrid](https://github.com/heimrichhannot/contao-formhybrid). ``` $GLOBALS['TL_DCA']['tl_example']['fields']['example_upload'] = [ 'inputType' => 'multifileupload', 'eval' => [ 'extensions' => string, # A comma-seperated list of allowed file types (e.g. "jpg,png"). Default: 'Config::get('uploadTypes')' 'fieldType' => 'radio'|'checkbox', # Use radio for single file upload, checkbox for multi file upload 'uploadFolder' => array|string|callable, # Set the folder where uploaded files are stored after submission. Can be a static string (e.g. 'files/upload') or a callback function. 'maxFiles' => int, # Maximum number of files that can be uploaded. Works only if multi file upload is allowed (see fieldType). Default: 10 'maxUploadSize' => int|string, # Maximum upload size in byte, KiB ("100K"), MiB ("4M") or GiB ("1G"). Default: minimum from Config::get('maxFileSize') and ini_get('upload_max_filesize') 'minImageWidth' => int, # Minimum image width in pixel. Default: 0 'minImageHeight' => int, # Minimum image height in pixel. Default: 0 'maxImageWidth' => int, # Maximum image width in pixel. Default: Config::get('imageWidth') 'maxImageHeight' => int, # Maximum image height in pixel. Default: Config::get('imageHeight') 'labels' => [ # Optional. Custom text that will be placed in the dropzone field. Typically a reference to the global language array. 'head' => string, 'body' => string , ], 'skipDeleteAfterSubmit' => boolean, # Prevent file removal from filesystem. Default false ], 'uploadPathCallback' => [[MyUploadCallback::class, 'onUploadPathCallback']], 'validateUploadCallback' => [[MyUploadCallback::class, 'onValidateUploadCallback']], 'sql' => "blob NULL", ]; ``` Example for simple single image file upload: ``` $GLOBALS['TL_DCA']['tl_example']['fields']['example_upload'] = [ 'inputType' => 'multifileupload', 'eval' => [ 'tl_class' => 'clr', 'extensions' => Config::get('validImageTypes'), 'fieldType' => 'radio', 'uploadFolder' => 'files/uploads' ], 'sql' => "blob NULL", ]; ``` Example for simple multiple image file upload: ``` $GLOBALS['TL_DCA']['tl_example']['fields']['example_upload'] = [ 'inputType' => 'multifileupload', 'eval' => [ 'tl_class' => 'clr', 'extensions' => Config::get('validImageTypes'), 'fieldType' => 'checkbox', 'uploadFolder' => 'files/uploads' ], 'sql' => "blob NULL", ]; ``` Example for multi image upload with additional config (maximum 5 files with custom image size): ``` $GLOBALS['TL_DCA']['tl_example']['fields']['example_upload'] = [ 'inputType' => 'multifileupload', 'eval' => [ 'tl_class' => 'clr', 'extensions' => Config::get('validImageTypes'), 'fieldType' => 'checkbox', 'maxFiles' => 5, 'minImageWidth' => 600, 'minImageHeight' => 300, 'maxImageWidth' => 1600, 'maxImageHeight' => 1200, 'uploadFolder' => 'files/uploads' ], 'sql' => "blob NULL", ]; ``` Documentation ------------- [](#documentation) ### Supported dropzone config options [](#supported-dropzone-config-options) The bundles support most dropzone config options. Just pass them as eval attribute. See [Dropzone Documentation](https://docs.dropzone.dev/configuration/basics/configuration-options) 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 by `maxUploadSize` eval property ### Flow chart [](#flow-chart) A flowchart with description of the full upload procedure with callback injection can be found here: [Flowchart](http://htmlpreview.github.io/?https://github.com/heimrichhannot/contao-multifileupload-bundle/blob/master/doc/upload-flow-chart.html). ### Additional eval properties [](#additional-eval-properties) Additional properties can be set in your fields eval section. NameDefaultDescriptionminImageWidthErrorText$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)createImageThumbnailsboolean(true)Set to false if you dont want to preview thumbnails.mimeFoldersystem/modules/multifileupload/assets/img/mimetypes/Numix-uTouchThe 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)mimeThumbnailsOnlyboolean(false)Set to true if you want to show mime image thumbnails only, and no image preview at all. (performance improvement)thumbnailWidth90The thumbnail width (in px) of the uploaded file preview within the dropzone preview container.thumbnailHeight90The thumbnail height (in px) of the uploaded file preview within the dropzone preview container.hideLabelfalseHide 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.timeoutnullDropzone Request timeout in milliseconds. See [Documentation](https://docs.dropzone.dev/configuration/basics/configuration-options)### Field Callbacks [](#field-callbacks) TypeArgumentsExpected return valueDescriptionuploadPathCallback$strTarget, \\File $objFile, \\DataContainer $dc$strTargetManipulate the upload path after form submission (run within onsubmit\_callback).validateUploadCallback\\File $objFile, \\Widget $objWidgetboolean(false) or string with frontend error messageValidate the uploaded file and add an error message if file does not pass validation, otherwise boolean(false) is expected.Developers ---------- [](#developers) ### PHP Events [](#php-events) Events dispatched by symfony event dispatcher. EventDescriptionPostUploadEventAllows working with the files after upload to upload destination. ### Health Score 53 — FairBetter than 96% of packages Maintenance79 Regular maintenance activity Popularity21 Limited adoption so far Community14 Small or concentrated contributor base Maturity82 Battle-tested with a long release history Bus Factor1 Top contributor holds 85.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~54 days Recently: every ~176 days Total 53 Last Release 171d ago PHP version history (3 changes)1.0.0PHP ^7.1 1.4.0PHP ^7.1||^8.0 1.6.0PHP ^7.4 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/28ad3224d8727b622ebd229840eea6b9dbcb83eb0bd609e6ce65b614830ff538?d=identicon)[digitales@heimrich-hannot.de](/maintainers/digitales@heimrich-hannot.de) --- Top Contributors [![koertho](https://avatars.githubusercontent.com/u/12064642?v=4)](https://github.com/koertho "koertho (54 commits)")[![vvohh](https://avatars.githubusercontent.com/u/75325799?v=4)](https://github.com/vvohh "vvohh (3 commits)")[![ericges](https://avatars.githubusercontent.com/u/25957923?v=4)](https://github.com/ericges "ericges (2 commits)")[![rabauss](https://avatars.githubusercontent.com/u/14016098?v=4)](https://github.com/rabauss "rabauss (2 commits)")[![davidsky7](https://avatars.githubusercontent.com/u/89909249?v=4)](https://github.com/davidsky7 "davidsky7 (1 commits)")[![K0NZ1](https://avatars.githubusercontent.com/u/16319351?v=4)](https://github.com/K0NZ1 "K0NZ1 (1 commits)") --- Tags contaoupload ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/heimrichhannot-contao-multifileupload-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/heimrichhannot-contao-multifileupload-bundle/health.svg)](https://phpackages.com/packages/heimrichhannot-contao-multifileupload-bundle) ``` ### Alternatives [symfony/http-kernel Provides a structured process for converting a Request into a Response 8.1k869.4M8.8k](/packages/symfony-http-kernel)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 751291.4k43](/packages/civicrm-civicrm-core)[symfony/security-bundle Provides a tight integration of the Security component into the Symfony full-stack framework 2.5k185.6M2.4k](/packages/symfony-security-bundle)[metamodels/core MetaModels core 10156.4k66](/packages/metamodels-core)[symfony/security-http Symfony Security Component - HTTP Integration 1.7k177.2M383](/packages/symfony-security-http)[terminal42/contao-node Node bundle for Contao Open Source CMS 3177.0k6](/packages/terminal42-contao-node) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)