gomonkey/yii2-easy-uploader

an easy way for make folders and upload images or file everywhere

, _(*1)

Easy uploader extension for yii2

an easy way for make folders and upload images with one simple code line., _(*2)

Installation

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

Either run, _(*4)

php composer.phar require  gomonkey/yii2-easy-uploader "*"

or add, _(*5)

"gomonkey/yii2-easy-uploader": "*"

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

Usage

Parameters

Add in your config file ( common/config/main.php ) for using in frontend and backend, _(*7)

'components' => [
        'uploaders' => [
            'class' => 'gomonkey\uploader\Uploader',
            'baseFrontendUrl' =>   dirname(dirname(__DIR__)) . '/frontend/web/images',
            'baseBackendUrl' => dirname(dirname(__DIR__)) . '/backend/web/images',
            'rename' => true, // Rename file 
            'random' => 12, // random alphanumeric name
            'remove' => true, // Remove original file after upload
            'folders' => [
                [
                    'name' => '1200',
                    'quality' => 70,
                    'width' => 1200
                ],
                [
                    'name' => '800',
                    'quality' => 70,
                    'width' => 800
                ],
                [
                    'name' => '600',
                    'quality' => 70,
                    'width' => 600
                ],
                [
                    'name' => 'avatars',
                    'quality' => 70,
                    'width' => 200
                ]

            ]

        ],
    ],

if you use basic template, you can still use the same code above, just put the code in you config file and change baseFrontendUrl. You can remove or comment baseBackendUrl, _(*8)

Controllers

add UploadFile in your controller, _(*9)

use yii\web\UploadedFile;

single image upload

In your controller action :, _(*10)

$upload = new Yii::$app->uploaders();

/**
If you want to use backend path:
$upload = new Yii::$app->uploaders("backend");
**/

$model->image =  $upload->upload(UploadedFile::getInstance($model, 'image'), "avatars");

$model->image now have the name of the uploaded image, ready to save it in database., _(*11)

multiple uploads

foreach (UploadedFile::getInstances($model, 'image') as $file) {
    $model->image = (new Yii::$app->uploaders())->upload($file, "avatars");

}

upload from url

Now it is possible to upload images from other website, using dynamic or static urls. the same code can be used in a loop, _(*12)

 $model->image = $upload->uploadFromUrl("https://www.website.it/url/to/image/image.jpg",  "myFolder");

N.B. no need upload instance, _(*13)

infinite folders generation

You can make infinite folders. For example with user id: images/user/3/1200/imagename.jpg, _(*14)

$model->image =  $upload->upload(UploadedFile::getInstance($model, 'image'), "users/".Yii::$app->user->id);

in your view

do not forget to use multipart/form-data to your form, _(*15)

<?php $form = ActiveForm::begin([
    'options' => ['enctype'=>'multipart/form-data']
]); ?>

Delete images from folder

If you need to delete one or more images from all folders:, _(*16)

( new Yii::$app->uploaders() )->delete( file, folder );, _(*17)

for example:, _(*18)

 (new Yii::$app->uploaders())->delete($model->name, "/products/".Yii::$app->user->id);

It remove all images in your path/products/user id/others setted folder/file, _(*19)

Paremeters

rename (Type: boolean, Default value: true)

Will rename your uploaded file, set to false if you don't want to change the file name, _(*20)

remove (Type: boolean, Default value: true)

Remove the original file, _(*21)

random (Type: integer, Default value: 10)

Random is the length of the alphanumeric image name, _(*22)

baseFrontendUrl ( Type: string)

Your frontend ( or web path for basic template ) path to image folder, _(*23)

baseBackendUrl ( Type: string)

Your backend path to image folder, _(*24)

folders ( Type: array)

The folders are not the primary, these must be set in controller - name[] = is the name of the folder - quality[] = is the quality of the uploaded image - width[] = is the width of the image, the height will be scaled, _(*25)

, _(*26)