haunt-jonathan / image-cropper
CitaNZ's image cropper for SilverStripe 4, with versioning
Installs: 106
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Type:silverstripe-vendormodule
Requires
- silverstripe/framework: ^4.0
This package is not auto-updated.
Last update: 2025-03-10 06:29:41 UTC
README
It's a continious development of Salted Herring's Cropper Field for SilverStripe - 4 (https://github.com/salted-herring/salted-cropper)
Usage
- Install
composer require haunt-jonathan/image-cropper
-
/dev/build?flush=all
-
Sample code:
... use Cita\ImageCropper\Model\CitaCroppableImage; use Cita\ImageCropper\Fields\CroppableImageField; ... private static $has_one = array( 'Photo' => CitaCroppableImage::class ); public function getCMSFields() { $fields = parent::getCMSFields(); ... // adding a free cropper $fields->addFieldToTab(TAB_NAME, CroppableImageField::create('PhotoID', A_TITLE_TO_THE_FILED)); // adding cropper with ratio $fields->addFieldToTab(TAB_NAME, CroppableImageField::create('PhotoID', A_TITLE_TO_THE_FILED)->setCropperRatio(16/9)); ... return $fields; }
-
Add image > upload/select > save > edit > do your cropping > save
-
Output
$Photo $Photo.Cropped $Photo.Cropped.SetWidth(100)
AWS support
If you are using SS's S3 assets module to store your images, you may also want to add this into your site's config yaml
SilverStripe\Admin\LeftAndMain:
extra_requirements_javascript:
- 'resources/vendor/haunt-jonathan/image-cropper/client/js/s3-workaround.js'