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.5(1mo ago)2057.0k↓17.7%22[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 2w ago

READMEChangelog (3)Dependencies (12)Versions (53)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

63

—

FairBetter than 99% of packages

Maintenance85

Actively maintained with recent releases

Popularity42

Moderate usage in the ecosystem

Community32

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 63.1% 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 ~131 days

Total

51

Last Release

50d 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 (154 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

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k555.0M2.8k](/packages/aws-aws-sdk-php)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M430](/packages/easycorp-easyadmin-bundle)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)[terminal42/notification_center

Notification Center extension for Contao Open Source CMS

80419.8k112](/packages/terminal42-notification-center)[metamodels/core

MetaModels core

10156.6k68](/packages/metamodels-core)[contao/manager-bundle

Provides the Contao Managed Edition

181.3M83](/packages/contao-manager-bundle)

PHPackages © 2026

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