PHPackages                             terminal42/contao-fineuploader - 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. [File &amp; Storage](/categories/file-storage)
4. /
5. terminal42/contao-fineuploader

ActiveContao-bundle[File &amp; Storage](/categories/file-storage)

terminal42/contao-fineuploader
==============================

FineUploader bundle for Contao Open Source CMS

3.5.4(1mo ago)2052.9k↓15.6%23[5 issues](https://github.com/terminal42/contao-fineuploader/issues)3MITPHPPHP ^7.4 || ^8.0

Since Aug 18Pushed 1mo ago5 watchersCompare

[ Source](https://github.com/terminal42/contao-fineuploader)[ Packagist](https://packagist.org/packages/terminal42/contao-fineuploader)[ GitHub Sponsors](https://github.com/terminal42)[ Fund](https://ko-fi.com/terminal42)[ RSS](/packages/terminal42-contao-fineuploader/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (8)Versions (52)Used By (3)

FineUploader Bundle for Contao Open Source CMS
==============================================

[](#fineuploader-bundle-for-contao-open-source-cms)

This extension integrates the [Fine Uploader](http://fineuploader.com/) by Widen with Contao Open Source CMS.

Important

Please be aware that the FineUploader script [is not being developed anymore](https://github.com/FineUploader/fine-uploader/issues/2073), we are therefore not planning to add new features or continue to support this extension.

Installation
------------

[](#installation)

Choose the installation method that matches your workflow!

### Installation via Contao Manager

[](#installation-via-contao-manager)

Search for `terminal42/contao-fineuploader` in the Contao Manager and add it to your installation. Apply changes to update the packages.

### Manual installation

[](#manual-installation)

Add a composer dependency for this bundle. Therefore, change in the project root and run the following:

```
composer require terminal42/fineuploader
```

Depending on your environment, the command can differ, i.e. starting with `php composer.phar …` if you do not have composer installed globally.

Usage
-----

[](#usage)

Define the form field as follows:

```
$GLOBALS['TL_DCA']['tl_table']['fields']['myupload'] = [
    'label'     => &$GLOBALS['TL_LANG']['tl_table']['myupload'],
    'exclude'   => true,
    'inputType' => 'fineUploader',
    'eval'      => [
        'multiple'          => true,                        // Allow multiple files to be uploaded
        'storeFile'         => true,                        // Store the files on the server
        'uploadFolder'      => 'files/uploads',             // Upload target directory (can also be a Contao file system UUID)
        'useHomeDir'        => true,                        // Upload to the current logged in member home directory (overrides "uploadFolder", can also be a Contao file system UUID)
        'uploaderLimit'     => 4,                           // Maximum files that can be uploaded
        'maxConnections'    => 3                            // Maximum allowable concurrent requests
        'addToDbafs'        => true,                        // Add files to the database assisted file system
        'doNotOverwrite'    => true,                        // Do not overwrite files in destination folder
        'debug'             => true                         // Enable the debug mode (always true in development environment)

        // Validation
        'extensions'        => 'pdf,zip',                   // Allowed extension types
        'minlength'         => 1048000,                     // Minimum file size
        'maxlength'         => 2048000,                     // Maximum file size (ignored if you use chunking!)
        'minWidth'          => 400,                         // Minimum image width
        'maxWidth'          => 800,                         // Maximum image width
        'minHeight'         => 300,                         // Minimum image height
        'maxHeight'         => 600,                         // Maximum image height

        // Chunking
        'chunking'          => true,                        // Enable chunking
        'chunkSize'         => 2000000,                     // Chunk size in bytes
        'concurrent'        => true                         // Allow multiple chunks to be uploaded simultaneously per file

        // Rendering
        'imageSize'         => [160, 120, 'center_center'], // Thumbnail image size that is generated upon image upload
        'isGallery'         => true,                        // Display the widget as image gallery
        'isDownloads'       => true,                        // Display the widget as file list
        'sortable'          => true,                        // Make the uploaded files sortable
        'uploadButtonTitle' => 'Upload',                    // Custom upload button title

        // Upload the files directly to the destination folder. If not set, then the files are first uploaded
        // to the temporary folder and moved to the destination folder only when the form is submitted
        'directUpload'      => true,
    ],
    'sql' => "blob NULL"
];
```

License
-------

[](#license)

This bundle is released under the [MIT license](LICENSE)

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance84

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community31

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 63% 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 ~86 days

Recently: every ~117 days

Total

50

Last Release

56d ago

Major Versions

1.0.1 → 2.0.02016-07-06

2.1.3 → 3.0.02020-05-18

PHP version history (5 changes)1.0.0PHP &gt;=5.3.2

3.0.0PHP &gt;=7.1

3.1.5PHP ^7.1 || ^8.0

3.2.0PHP ^7.2 || ^8.0

3.4.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1073273?v=4)[Andreas Schempp](/maintainers/aschempp)[@aschempp](https://github.com/aschempp)

![](https://avatars.githubusercontent.com/u/481937?v=4)[Yanick Witschi](/maintainers/Toflar)[@Toflar](https://github.com/Toflar)

---

Top Contributors

[![qzminski](https://avatars.githubusercontent.com/u/193483?v=4)](https://github.com/qzminski "qzminski (153 commits)")[![Toflar](https://avatars.githubusercontent.com/u/481937?v=4)](https://github.com/Toflar "Toflar (32 commits)")[![aschempp](https://avatars.githubusercontent.com/u/1073273?v=4)](https://github.com/aschempp "aschempp (29 commits)")[![fritzmg](https://avatars.githubusercontent.com/u/4970961?v=4)](https://github.com/fritzmg "fritzmg (19 commits)")[![grbodo](https://avatars.githubusercontent.com/u/50199511?v=4)](https://github.com/grbodo "grbodo (1 commits)")[![jdwiese](https://avatars.githubusercontent.com/u/39191658?v=4)](https://github.com/jdwiese "jdwiese (1 commits)")[![markocupic](https://avatars.githubusercontent.com/u/1525166?v=4)](https://github.com/markocupic "markocupic (1 commits)")[![PaoloB](https://avatars.githubusercontent.com/u/1219959?v=4)](https://github.com/PaoloB "PaoloB (1 commits)")[![theDyingMountain](https://avatars.githubusercontent.com/u/4446224?v=4)](https://github.com/theDyingMountain "theDyingMountain (1 commits)")[![ameotoko](https://avatars.githubusercontent.com/u/10257912?v=4)](https://github.com/ameotoko "ameotoko (1 commits)")[![zonky2](https://avatars.githubusercontent.com/u/1045318?v=4)](https://github.com/zonky2 "zonky2 (1 commits)")[![bildschirmartist](https://avatars.githubusercontent.com/u/2776658?v=4)](https://github.com/bildschirmartist "bildschirmartist (1 commits)")[![doishub](https://avatars.githubusercontent.com/u/48379929?v=4)](https://github.com/doishub "doishub (1 commits)")[![gmpf](https://avatars.githubusercontent.com/u/13484650?v=4)](https://github.com/gmpf "gmpf (1 commits)")

---

Tags

contaoFineUploaderuploaderchunking

### Embed Badge

![Health badge](/badges/terminal42-contao-fineuploader/health.svg)

```
[![Health](https://phpackages.com/badges/terminal42-contao-fineuploader/health.svg)](https://phpackages.com/packages/terminal42-contao-fineuploader)
```

###  Alternatives

[oneup/uploader-bundle

This Symfony bundle provides a server implementation for handling single and multiple file uploads using either FineUploader, jQuery File Uploader, YUI3 Uploader, Uploadify, FancyUpload, MooUpload, Plupload or Dropzone. Features include chunked uploads, orphanages, Gaufrette and Flysystem support.

6066.3M27](/packages/oneup-uploader-bundle)[codefog/contao-haste

haste extension for Contao Open Source CMS

42650.8k139](/packages/codefog-contao-haste)[terminal42/contao-mp_forms

An extension for Contao Open Source CMS to create multi steps forms using the form generator

2633.7k5](/packages/terminal42-contao-mp-forms)[christianbarkowsky/contao-tiny-compress-images

This plugin automatically optimizes your images (JPG, PNG, WebP) by integrating with the popular image compression services TinyJPG and TinyPNG.

2719.0k](/packages/christianbarkowsky-contao-tiny-compress-images)[do-while/contao-backupdb-bundle

Backup of the Contao database, automatic backup, creation of website templates for the Install Tool

10107.0k1](/packages/do-while-contao-backupdb-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
