simialbi/yii2-widget-crop

Yii2 wrapper for Image Cropper javascript library

1.1.1 2022-09-12 07:06 UTC

Requires

• php: >=7.3
• bower-asset/cropperjs: ^1.5.7
• bower-asset/jquery-cropper: ^1.0.1
• yiisoft/yii2: ~2.0

Suggests

• yiisoft/yii2-bootstrap: Use cropper in a modal
• yiisoft/yii2-bootstrap4: Use cropper in a modal
• yiisoft/yii2-bootstrap5: Use cropper in a modal

MIT

• Ivan Orlov
• Simon Karlen

• image
• crop
• widget
• yii2
• cropper
• yii2-widgets

README

Wrapper for Image Cropper javascript library based on demisang/yii2-cropper.

Resources

• yii2 framework
• demisang/yii2-cropper.
• Image Cropper

Installation

The preferred way to install this extension is through composer.

Either run

$ php composer.phar require --prefer-dist "simialbi/yii2-crop"

or add

{
	"require": {
  		"simialbi/yii2-crop": "~1.0"
	}
}

to the require section of your composer.json

Example Usage

<?php
/* @var $this yii\web\View */
/* @var $image stdClass */

use simialbi\yii2\crop\Cropper;

$this->title = 'my example';
$this->params['breadcrumbs'][] = $this->title;

?>
<div class="my-example">
<?php
echo Cropper::widget([
	'type' => Cropper::TYPE_MODAL,
	'cropUrl' => ['my-module/image/crop', 'id' => $image->id],
	'image' => $image->src,
	'aspectRatio' => 16 / 9,
	'clientOptions' => [
		//see https://github.com/fengyuanchen/cropper/blob/master/README.md#options
		'minCropBoxWidth' => 1600,
		'minCropBoxHeight' => 900
	],
	'options' => [],
	'imageOptions' => [],
	'modalOptions' => [],
	'buttonOptions' => [
		'class' => ['btn', 'btn-default']
	],
	'buttonContent' => 'Crop {icon}',
	'buttonIcon' => '<span class="glyphicon glyphicon-scissors"></span>',
	'ajaxOptions' => [] //$.ajax properties
]);
?>
</div>

License

yii2-widget-crop is released under MIT license. See bundled LICENSE for details.