PHPackages jasekz/laradrop - 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 & Storage](/categories/file-storage) 4. / 5. jasekz/laradrop ActiveLibrary[File & Storage](/categories/file-storage) jasekz/laradrop =============== File manager using Dropzone.js for Laravel 5 | 6 | 7 | 8 1.1.2(4y ago)7310.3k20[3 issues](https://github.com/jasekz/laradrop/issues)[2 PRs](https://github.com/jasekz/laradrop/pulls)1MITJavaScriptPHP >=5.4.0 Since Apr 15Pushed 4y ago9 watchersCompare [ Source](https://github.com/jasekz/laradrop)[ Packagist](https://packagist.org/packages/jasekz/laradrop)[ RSS](/packages/jasekz-laradrop/feed)WikiDiscussions v1.1.2 Synced today READMEChangelog (9)Dependencies (5)Versions (13)Used By (1) *This uses SoftDelete* Laradrop ======== [](#laradrop) [![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md) This is a file manager using Dropzone.js for Laravel 5, 6, 7, 8. It provides basic functionality for managing, uploading, and deleting files. Quick Start ----------- [](#quick-start) 1. Follow the **Installation** instructions below. ``` Getting errors? Make sure you have a database set up (https://laravel.com/docs/database). ``` 2. In a view (welcome.blade.php, for example), add: ``` Laradrop Demo jQuery(document).ready(function(){ jQuery('.laradrop').laradrop(); }); ``` 3. In your **.env** file, add: ``` LARADROP_DISK_PUBLIC_URL=/uploads LARADROP_DISK=laradrop ``` 4. In your **config/filesystems.php**, add to your `disks` array: ``` 'laradrop' => [ 'driver' => 'local', 'root' => public_path('uploads'), // will put files in 'public/upload' directory ], ``` That's it. If you have any issues or question, please feel free to open an issue. Installation ------------ [](#installation) NOTE: If you haven't set up a database yet for your app, please do that first as per Laravel docs - . Via composer ``` composer require jasekz/laradrop ``` Then in your `config/app.php` add ``` 'Jasekz\Laradrop\LaradropServiceProvider' ``` to the `providers` array. Then run ``` php artisan vendor:publish ``` followed by ``` php artisan migrate ``` Configuration (.env) -------------------- [](#configuration-env) Laradrop uses Laravel's Filesystem mechanism () and by default will store your files in the `storage/app` directory. If you would like to modify this behavior, along with other default settings, you can set your `.env` file variables: ``` # s3, local, or Rackspace. See 'Other Driver Prerequisites' at https://laravel.com/docs/filesystem. Defaults to 'local' LARADROP_DISK=local # If your files need to be web accessible, set this param. S3, for example, would be 'https://s3.amazonaws.com/my-bucket'. Defaults to the web root (public). LARADROP_DISK_PUBLIC_URL=/img # If a thumbnail can not be generated due to incompatible file or any other reason, what image do you want to use? Defaults to 'vendor/jasekz/laradrop/img/genericThumbs/no-thumb.png' LARADROP_DEFAULT_THUMB=/img/no-thumb.png # Max file upload size in MB. Defaults to 10. LARADROP_MAX_UPLOAD_SIZE=20 # Max file size (in MB) for which thumbnail generation will be attempted. If your server has an issue processing thumbs, you can lower this value. Defaults to 10. LARADROP_MAX_THUMBNAIL_SIZE=10 # Defaults to 150px. LARADROP_THUMB_WIDTH=150 # Defaults to 150px. LARADROP_THUMB_HEIGHT=150 # Run laradrop routes through middlware. Defaults to none. LARADROP_MIDDLEWARE=web ``` Usage ----- [](#usage) This package requires Dropzone.js, jQuery, and jQuery UI. Include these somewhere in your template: ``` ``` By default, Laradrop is designed for Bootstrap, but it's not a requirement. Include Bootstrap and the Laradrop styles if you'd like to use it: ``` ``` Add the html code where you'd like to implement the file manager. Note, that by default, there is no middleware assigned to the Laradrop controller, however, it you assign middleware which contains csrf protection, you must include the `laradrop-csrf-token="{{ csrf_token() }}"` attribute. ``` ``` Finally, bind it using jQuery: ``` jQuery(document).ready(function(){ // Simplest: jQuery('.laradrop').laradrop(); // With custom params: jQuery('.laradrop-custom').laradrop({ breadCrumbRootText: 'My Root', // optional actionConfirmationText: 'Sure about that?', // optional onInsertCallback: function (obj){ // optional // if you need to bind the select button, implement here alert('Thumb src: '+obj.src+'. File ID: '+obj.id+'. Please implement onInsertCallback().'); }, onErrorCallback: function(msg){ // optional // if you need an error status indicator, implement here alert('An error occured: '+msg); }, onSuccessCallback: function(serverRes){ // optional // if you need a success status indicator, implement here } }); }); ``` Events ------ [](#events) Laradrop currently fires two events: 1. **Jasekz\\Laradrop\\Events\\FileWasUploaded** - this is fired after a file has been uploaded and saved. 2. **Jasekz\\Laradrop\\Events\\FileWasDeleted** - this is fired after a file is deleted. Handlers (upload, delete, list, etc) ------------------------------------ [](#handlers-upload-delete-list-etc) If you'd like to implement your own hanldlers (or extend the existing ones with your own controllers), you can do so. All you need to do, is to defined the routes to the appropriate handlers in the button attributes. This also allows you to easily have multiple handlers for different use cases, if so desired. ``` ``` File type validations --------------------- [](#file-type-validations) The default implementation of accept checks the file's mime type or extension against this list. This is a comma separated list of mime types or file extensions. Eg.: image/\*,application/pdf,.psd If the Dropzone is clickable this option will also be used as accept parameter on the hidden file input as well. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 38 — LowBetter than 83% of packages Maintenance19 Infrequent updates — may be unmaintained Popularity36 Limited adoption so far Community22 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 83.8% 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 ~207 days Recently: every ~376 days Total 11 Last Release 1662d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/761324?v=4)[Zig](/maintainers/jasekz)[@jasekz](https://github.com/jasekz) --- Top Contributors [![jasekz](https://avatars.githubusercontent.com/u/761324?v=4)](https://github.com/jasekz "jasekz (57 commits)")[![aurelijussaldauskas](https://avatars.githubusercontent.com/u/38923733?v=4)](https://github.com/aurelijussaldauskas "aurelijussaldauskas (5 commits)")[![phpner](https://avatars.githubusercontent.com/u/21022278?v=4)](https://github.com/phpner "phpner (3 commits)")[![vikashsp](https://avatars.githubusercontent.com/u/19393304?v=4)](https://github.com/vikashsp "vikashsp (2 commits)")[![OlegDemkiv](https://avatars.githubusercontent.com/u/14280711?v=4)](https://github.com/OlegDemkiv "OlegDemkiv (1 commits)") --- Tags bootstrapcomposer-packagedemodropzonejsjavascriptjquerylaravellaravel-5-packagelaravel5media-librarypackagistphpphplaravel 6laravel 7laravel 8laravel 5file managerfile-uploaddropzone.js ### Embed Badge ![Health badge](/badges/jasekz-laradrop/health.svg) ``` [![Health](https://phpackages.com/badges/jasekz-laradrop/health.svg)](https://phpackages.com/packages/jasekz-laradrop) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k15.1M132](/packages/laravel-pulse)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9762.4M131](/packages/roots-acorn)[api-platform/laravel API Platform support for Laravel 58171.6k14](/packages/api-platform-laravel)[fleetbase/core-api Core Framework and Resources for Fleetbase API 1235.9k20](/packages/fleetbase-core-api)[flarum/core Delightfully simple forum software. 201.4M2.3k](/packages/flarum-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)