joni-jones/yii2-fuploader

BlueImp file upload widget for Yii2

File Uploader

File uploader. Yii2 extension based on jQuery File Upload Plugin., _(*1)

, _(*2)

Installation

The preferred way to install this extension is through composer., _(*3)

Either run, _(*4)

php composer.phar require --prefer-dist joni-jones/yii2-fuploader "*"

or add, _(*5)

"joni-jones/yii2-fuploader": "*"

to the require section of your composer.json file., _(*6)

Usage

Once the extension is installed, simply use it in your code by :, _(*7)

<?= \jones\fuploader\FileUpload::widget();?>

1. Specify action property for uploading url:, _(*8)

   FileUpload::widget([
       'action' => Url::to(['some_action'])
   ]);
   

2. Specify any jquery file upload options:, _(*9)

   FileUpload::widget([
       'options' => [
           'plugin' => [
               'formData' => 'some data',
           ],
       ],
       'content' => 'Select image',
   ]);
   

3. To setup plugin events or callbacks - use clientEvents option for widget:, _(*10)

   FileUpload::widget([
           'clientEvents' => [
               'done' => 'function(e, data){console.log(data);}',
               'fail' => 'function(e, data){console.log(data);}'
           ]
   ]);
   

4. Also you can use extension actions to store some file details after uploading. For example, update user avatar attribute in database., _(*11)

   public function actions()
   {
           return[
               'some_action' => [
                   'class' => 'jones\fuploader\actions\UploadAction',
                   'path' => 'some path for uploading',
                   'url' => 'some url for uploaded file', //this url will be accessable in action response
                   'callback' => [$this, 'someCallback'] //any callable function
               ]
           ];
   }
   

5. If callback was specified it will be triggered after uploading:, _(*12)

   public function someCallback($request, $files)
   {
       // some code
   }
   

   UploadAction() return response in json format. This is structure of response:, _(*13)

   {"message": "some success message", "files": [{"name": "", "ext": ""}], "url": "url to files directory"}
   

   {"reason": "message with reason why file does not uploaded"}
   

   Also, status codes of response will be returned in headers., _(*14)

License

MIT, _(*15)