tiderjian / la-filepond
file upload extension for laravel-admin
Installs: 417
Dependents: 0
Suggesters: 0
Security: 0
Stars: 17
Watchers: 2
Forks: 4
Open Issues: 0
Type:project
Requires
- php: >=7.2.0
- encore/laravel-admin: ~1.6
Requires (Dev)
- laravel/dusk: ~5.0
- laravel/laravel: ~5.7
- mockery/mockery: ^1.0
- phpunit/phpunit: ^7.4
README
中文文档
About
Filepondis a flexible and fun JavaScript file upload library, that can upload anything you throw at it, optimizes images for faster uploads, and offers a great, accessible, silky smooth user experience. Filepond for laravel-admin is laravel-admin extention base on it.
Why
laravel-admin's upload item is hard to use and more complex, and slowly upload while more multiple files, this is a bad user experience. Filepond upload by ajax, suitable for multiple file upload.
Demo
Install
first, install laravel-admin, and run below command.
composer require tiderjian/la-filepond
run laravel-admin extention import.
php artisan admin:import filepond
Config
find out the extensions segment in the config/admin.php，add filepond config
'extensions' => [
'filepond' => [
// enable or disable the extension
'enable' => true,
// atuo delete the uploaded files(default false)
'autodelete' => true
]
]
Usage
//image upload
$form->filepondImage(@database column, @label)
//file upload
$form->filepondFile(@database column, @label)
//multiple images upload
$form->filepondImage(@database column, @label)->multiple()
//multiple files upload
$form->filepondFile(@database column, @label)->multiple()
//ps:multiple upload save to database in json，must set the casts to json on the model.
protected $casts = [
'images' => 'json',
'files' => 'json',
];
//set required
$form->filepondImage(@database column, @label)->rules('required')
//set file type that can be uploaded.
$form->filepondFile(@database column, @label)->mineType(['application/msword', 'application/pdf'])
$form->filepondFile(@database column, @label)->mineType('application/msword')
//set max file size, unit: KB
$form->filepondFile(@database column, @label)->size(30)
extension
You can extend it by youself, here is a sample that extend a image size validate plugin.
-
download filepond-plugin-image-validate-size,add to public/vendor/laravel-admin-ext/la-filepond/js
-
add to app/Admin/bootstrap.php
\Encore\Admin\Admin::booting(function(){
\Qs\La\Filepond\File::extendPluginJs(['/vendor/laravel-admin-ext/la-filepond/js/filepond-plugin-image-validate-size.min.js']);
\Qs\La\Filepond\File::extendPlugin('FilePondPluginImageValidateSize');
//use the \Qs\La\Filepond\File::extendPluginCss function to add css file
});
- find out the pulgin document, and add config as you like
//imageValidateSizeMinWidth、imageValidateSizeMaxWidth is the config keys
$form->filepondImage('images', 'images')->multiple()->options(['imageValidateSizeMinWidth' => 200, 'imageValidateSizeMaxWidth' => 400]);