phuongdev89/yii2-cropper

Yii-Framework widget for uploading and cropping images

Installs: 22

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 62

Type:yii2-extension

2.3.0 2023-01-10 15:43 UTC

This package is auto-updated.

Last update: 2024-11-10 19:33:35 UTC


README

Yii-Framework extension for uploading and cropping images

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist phuongdev89/yii2-cropper "@dev"

or add

"phuongdev89/yii2-cropper": "@dev"

to the require section of your composer.json file.

Usage

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

use phuongdev89\cropper\Widget;
<?php $form = ActiveForm::begin(['id' => 'form-profile']); ?>
    <?php echo $form->field($model, 'photo')->widget(Widget::className(), [
        'uploadUrl' => Url::toRoute('/user/user/uploadPhoto'),
    ]) ?>
    <div class="form-group">
        <?php echo Html::submitButton('Save', ['class' => 'btn btn-primary']) ?>
    </div>
<?php ActiveForm::end(); ?>

Widget has following properties:

In UserController:

public function actions()
{
    return [
        'uploadPhoto' => [
            'class' => 'phuongdev89\cropper\actions\UploadAction',
            'url' => 'http://your_domain.com/uploads/user/photo',
            'path' => '@frontend/web/uploads/user/photo',
        ]
    ];
}

Action has following parameters:

You can use this widget on frontend and backend. For example: user can change his userpic and administrator can change users userpic.

Operates as follows:

User click on new photo area or drag file

g4n7fva

The picture is loaded by JavaScript FileAPI.

yeul3gy

This picture is displayed in the widget and users have the ability to crop it or upload another picture

jaungjk

When the user clicks "Crop image", a request with file and coordinates is sent to the server. This picture is displayed in the form, and user can save it, or change crop area, or upload another photo.

0ejh55q