davfervaz/yii2-image-cutter

Yii2 crop image widget modification

Yii2 image cutter

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

Features:

• Upload image
• Crop image
• Use Imagine
• Cache sorting to subdirectories

, _(*2)

Composer

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

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

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

Use

• Add to the model behavior

    use sadovojav\cutter\behaviors\CutterBehavior;

    public function behaviors()
    {
        return [
            'image' => [
                'class' => CutterBehavior::className(),
                'attributes' => 'image',
                // 'attributes' => ['image1', 'image2'],
                '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/array) - 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>
        <?= \sadovojav\cutter\Cutter::widget([
            'model' => $model,
            'attribute' => 'image'
        ]); ?>
    </div>

or, _(*9)

With client validation, _(*10)

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

Widget method options

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

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

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

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

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

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

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

  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']., _(*18)

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

  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., _(*20)