Yii2 port of BlueImp jQuery File Upload plugin. File Upload widget with multiple file selection, drag&drop support, progress bars, validation and preview images, audio and video for jQuery.
Supports cross-domain, chunked and resumable file uploads and client-side image resizing., (*1)
One widget, simple configuration, everything works out of the box., (*2)
Inspired by https://github.com/2amigos/yii2-file-upload-widget, (*3)
Installation
From command line, (*4)
$ composer require limion/yii2-jquery-fileupload-widget:~1.0
or add to your composer.json, (*5)
"require": {
"limion/yii2-jquery-fileupload-widget": "~1.0"
}
Usage
UI version
See: https://blueimp.github.io/jQuery-File-Upload/index.html
Please note, in case of using a "UI" version you need to embed the widget to an existing form., (*6)
= JQueryFileUpload::widget([
'model' => $model,
'attribute' => 'img',
'url' => ['upload', 'someparam' => 'somevalue'], // your route for saving images,
'appearance'=>'ui', // available values: 'ui','plus' or 'basic'
'gallery'=>true, // whether to use the Bluimp Gallery on the images or not
'formId'=>$form->id,
'options' => [
'accept' => 'image/*'
],
'clientOptions' => [
'maxFileSize' => 2000000,
'dataType' => 'json',
'acceptFileTypes'=>new yii\web\JsExpression('/(\.|\/)(gif|jpe?g|png)$/i'),
'autoUpload'=>false
]
]);?>
Customizing the UI
You can use your own templates to customize the look and feel of upload,download and main views, (*7)
= JQueryFileUpload::widget([
'model' => $model,
'attribute' => 'img',
'url' => ['upload', 'someparam' => 'somevalue'], // your route for saving images,
'appearance'=>'ui', // available values: 'ui','plus' or 'basic'
'uploadTemplateView'=>'@app/views/jqueryfileupload/upload', // upload template
'downloadTemplateView'=>'@app/views/jqueryfileupload/download', // download template
'mainView'=>'@app/views/jqueryfileupload/main', // main view with buttonbar
'formId'=>$form->id,
'clientOptions' => [
'maxFileSize' => 2000000,
'autoUpload'=>false
]
]);?>
Plus version
See: https://blueimp.github.io/jQuery-File-Upload/basic-plus.html, (*8)
')
.addClass('btn btn-primary')
.prop('disabled', true)
.text('Processing...')
.on('click', function (e) {
e.preventDefault();
var $this = $(this),
data = $this.data();
$this
.off('click')
.text('Abort')
.on('click', function () {
$this.remove();
data.abort();
});
data.submit().always(function () {
$this.remove();
});
});
JS;
$this->registerJs($js);
?>
= JQueryFileUpload::widget([
'name' => 'files[]',
'url' => ['upload', 'someparam' => 'somevalue'], // your route for saving images,
'appearance'=>'plus', // available values: 'ui','plus' or 'basic'
'options' => ['accept' => 'image/*'],
'clientOptions' => [
'maxFileSize' => 2000000,
'acceptFileTypes'=>new yii\web\JsExpression('/(\.|\/)(gif|jpe?g|png)$/i'),
'autoUpload'=>false
],
'clientEvents' => [
'add' => "function (e, data) {
data.context = $('').appendTo('#files');
$.each(data.files, function (index, file) {
var node = $(', (*9)
')
.append($('').text(file.name));
if (!index) {
node
.append('
')
.append(uploadButton.clone(true).data(data));
}
node.appendTo(data.context);
});
}",
'processalways' => "function (e, data) {
var index = data.index,
file = data.files[index],
node = $(data.context.children()[index]);
if (file.preview) {
node
.prepend('
')
.prepend(file.preview);
}
if (file.error) {
node
.append('
')
.append($('').text(file.error));
}
if (index + 1 === data.files.length) {
data.context.find('button')
.text('Upload')
.prop('disabled', !!data.files.error);
}
}",
'progressall' => "function (e, data) {
var progress = parseInt(data.loaded / data.total * 100, 10);
$('#progress .progress-bar').css(
'width',
progress + '%'
);
}",
'done' => "function (e, data) {
$.each(data.result.files, function (index, file) {
if (file.url) {
var link = $('')
.attr('target', '_blank')
.attr('data-gallery','')
.prop('href', file.url);
$(data.context.children()[index])
.wrap(link);
} else if (file.error) {
var error = $('').text(file.error);
$(data.context.children()[index])
.append('
')
.append(error);
}
});
}",
'fail' => "function (e, data) {
$.each(data.files, function (index) {
var error = $('').text('File upload failed.');
$(data.context.children()[index])
.append('
')
.append(error);
});
}"
],
]);?>
Basic version
See: https://blueimp.github.io/jQuery-File-Upload/basic.html, (*10)
['upload', 'someparam' => 'somevalue'], // your route for saving images,
'appearance'=>'basic', // available values: 'ui','plus' or 'basic'
'name' => 'files[]',
'options' => [
'accept' => 'image/*'
],
'clientOptions' => [
'maxFileSize' => 2000000,
'dataType' => 'json',
'acceptFileTypes'=>new yii\web\JsExpression('/(\.|\/)(gif|jpe?g|png)$/i'),
'autoUpload'=>true
],
'clientEvents' => [
'done'=> "function (e, data) {
$.each(data.result.files, function (index, file) {
$(', (*11)
').text(file.name).appendTo('#files');
});
}",
'progressall'=> "function (e, data) {
var progress = parseInt(data.loaded / data.total * 100, 10);
$('#progress .progress-bar').css(
'width',
progress + '%'
);
}"
]
]);?>
Wallogit.com
