elgorm/yii2-uploadable-cropable-image

Yii2 extension for upload and crop images

This package's canonical repository appears to be gone and the package has been frozen as a result.

v2.2.4 2015-10-20 07:25 UTC

Requires

• bower-asset/jcrop: 0.9.*
• yiisoft/yii2: 2.0.*
• yiisoft/yii2-bootstrap: 2.*
• yiisoft/yii2-imagine: 2.*

MIT

• Maxim Kolokolnikov

• image
• extension
• Image upload
• yii2
• jcrop
• image crop

README

Yii2 extension for upload and crop images

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist elgorm/yii2-uploadable-cropable-image "*"

or add

"elgorm/yii2-uploadable-cropable-image": "*"

to the require section of your composer.json file.

Usage

Once the extension is installed, simply use it in your code by :

In your model:

public function behaviors()
{
    return [
        [
            'class' => \elgorm\image\Behavior::className(),
            'savePathAlias' => '@web/images/',
            'urlPrefix' => '/images/',
            'crop' => true,
            'attributes' => [
                'avatar' => [
                    'savePathAlias' => '@web/images/avatars/',
                    'urlPrefix' => '/images/avatars/',
                    'width' => 100,
                    'height' => 100,
                ],
                'logo' => [
                    'crop' => false,
                    'thumbnails' => [
                        'mini' => [
                            'width' => 50,
                        ],
                    ],
                ],
            ],
        ],
    //other behaviors
    ];
}

Use rules for validate attribute.

In your view file:

echo $form->field($model, 'avatar')->widget('elgorm\image\Widget');

After, in your view:

echo Html::img($model->getImageUrl('avatar'));
echo Html::img($model->getImageUrl('logo', 'mini')); //get url of thumbnail named 'mini' for 'logo' attribute

If you use Advanced App Template and this behavior attached in backend model, then in frontend model add trait

use \elgorm\image\GetImageUrlTrait

and use getImageUrl() method for frontend model too.