Skip to content

Adds the ability to crop images from within the Silverstripe file section.

License

Notifications You must be signed in to change notification settings

webbuilders-group/silverstripe-image-cropper-field

Repository files navigation

Image Cropper Field

Adds the ability to crop images from within the SilverStripe file section.

Requirements

  • SilverStripe 4.4.x

Installation

Installation is supported via composer only

composer require webbuilders-group/silverstripe-image-cropper-field
  • Run dev/build?flush=all to regenerate the manifest

Setup

There is nothing to configure. Once you install and run dev/build?flush=all, you can begin cropping images right away from within the file section of the CMS.

Features and Overview

Image Cropper Field has a wide array of tools that will help any CMS Admin crop their images and limit the need to use external tools like Photoshop.

Overview of Image Cropper Field Overview of Image Cropper Field with aspect dropdown shown Overview of Image Cropper Field with dimension editing shown

The tools:

  • cropper dimensions tool

cropper dimensions tool

  • move tool

move tool

  • cropper tool

cropper tool

  • zoom tools

zoom in zoom out

  • image rotating tools

rotate left rotate right

  • reset tool

reset tool

  • aspect ratio setting tool

reset tool

Image Cropper Field will not overwrite the current image and instead will create a new image. The filename of the new image is determined by the filename of the current image. The new image is saved into the Cropped subfolder. The name of the new image can be changed before you click the Crop Image button.

Crop Preview window

Once it has created the new image, a green alert will be shown along with a link to your new image; However, this link will, currently, not be shown when you are using this field from the file Insert Form.

Overview of Image Cropper Field

Once the link is clicked, you will be taken to your new image.

Overview of Image Cropper Field

More features/tools to come in version 2:

  • image flip tools
  • ability to download your new cropped image before clicking the Crop Image button.

Reporting an issue

When you are reporting an issue, please ensure you specify what version of SilverStripe you are using i.e. 4.4.4. Also, be sure to include any JavaScript or PHP errors you receive.

For PHP errors, please ensure you include the full stack trace. Also, please include your implementation code as well as how you produced the issue. You may also be asked to provide some of the classes to aid in re-producing the issue. Stick with the issue, remember that it was you who saw the issue not the maintainer of the module so it may take a lot of questions to arrive at a fix or answer.

FAQ

Q: I can't find my image after creating it in the file Insert Form. Where is my new image?

A: Your new image will be saved to the subfolder named Cropped. You will have to, currently, refresh the page and open the insert image window again to get the image to show up when cropping from the file Insert Form.

Q: How do I change the folder the image saves too?

A: In this current version, you cannot change where the image is saved too. We will be trying to add it in a future release.

Q: You keep mentioning file Insert Form, where is this form? Do I use it?

A: The file Insert Form can be found when you interact with the Files popup window, so either by clicking on the insert from files button on a WYSIWYG editor or by clicking the browse button/link on an upload field. The image below is the file Insert Form that is referred too.

Overview of Image Cropper Field

Q: Can I use this field on a page or a dataobject?

A: Currently this field is designed only to be used in the file system of the CMS and the file Insert Form. There are plans to allow this field to be used on pages/dataobjects, and it will most likely come in version 2.