mitrm/yii2-image-cutter

Yii2 crop image widget

Yii2 image cutter

This is a fork Patroklo//yii2-image-cutter, _(*1)

Features:

• Upload image
• Crop image
• Use Imagine

, _(*2)

Composer

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

Either run php composer.phar require --prefer-dist mitrm/yii2-image-cutter "dev-master", _(*4)

or add "mitrm/yii2-image-cutter": "dev-master" to the require section of your composer.json, _(*5)

Use

• Add to the model behavior

    use mitrm\cutter\behaviors\CutterBehavior;

    public function behaviors()
    {
        return [
            'image' => [
                'class' => CutterBehavior::className(),
                'attributes' => 'image',
                'baseDir' => '/uploads/crop',
                'basePath' => '@webroot',
            ],
        ]
    }

    public function rules()
    {
        return [
            ['image', 'file', 'extensions' => 'jpg, jpeg, png', 'mimeTypes' => 'image/jpeg, image/png'],
        ];
    }

Parameters

• integer attributes required (string) - Image attributes
• integer baseDir required - Base directory
• integer basePath required - Base path

• integer quality = 92 - Crop result quality, _(*6)

• Use in view, _(*7)

  Without client validation, _(*8)

    <div class="form-group">
        <label class="control-label">Image</label>
        <?= \mitrm\cutter\Cutter::widget([
            'model' => $model,
            'attribute' => 'image'
        ]); ?>
    </div>

or, _(*9)

With client validation, _(*10)

    <?= $form->field($model, 'image')->widget(\mitrm\cutter\Cutter::className(), [
        //options
    ]); ?>

• Use in view

Get url to image, _(*11)

    $model->getImg(100);
    $model-> getImgOrigin();

Widget method options

• model (string) (obligatory), _(*12)

  Defines the model that will be used to make the form input field., _(*13)

• attribute (string) (obligatory), _(*14)

  Defines the model attribute that will be used to make de form input field., _(*15)

• useWindowHeight (bool) (optional), _(*16)

  Use the height of the current window for the form image cropping, _(*17)

• imageOptions (array) (optional), _(*18)

  List with options that will be added to the image field that will be used to define the crop data in the modal. The format should be ['option' => 'value']., _(*19)

• cropperOptions (array) (optional), _(*20)

  List with options that will be added in javaScript while creating the crop object. For more information about which options can be added you can read this web., _(*21)