mitrm/yii2-image-cutter

There is no license information available for the latest version (dev-master) of this package.

Yii2 crop image widget

dev-master 2018-06-26 18:37 UTC

Requires

• php: >=5.4.0
• yiisoft/yii2: *
• yiisoft/yii2-imagine: *
• yurkinx/yii2-image: *

Unknown License

• Ruslan Mitskevich

• image
• upload
• crop
• yii2
• cutter

README

This is a fork Patroklo//yii2-image-cutter

Features:

• Upload image
• Crop image
• Use Imagine

Composer

The preferred way to install this extension is through Composer.

Either run php composer.phar require --prefer-dist mitrm/yii2-image-cutter "dev-master"

or add "mitrm/yii2-image-cutter": "dev-master" to the require section of your composer.json

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

• Use in view

Without client validation

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

or

With client validation

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

• Use in view

Get url to image

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

Widget method options

• model (string) (obligatory)

Defines the model that will be used to make the form input field.

• attribute (string) (obligatory)

Defines the model attribute that will be used to make de form input field.

• useWindowHeight (bool) (optional)

Use the height of the current window for the form image cropping

• imageOptions (array) (optional)

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'].

• cropperOptions (array) (optional)

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.