PHPackages seppzzz/silverstripe-image-cropper-field - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. seppzzz/silverstripe-image-cropper-field ActiveSilverstripe-vendormodule seppzzz/silverstripe-image-cropper-field ======================================== Adds a new field to images to allow them to be cropped. This will give the ability to save as new or overwrite current image. 05JavaScript Since Mar 29Pushed 2y ago1 watchersCompare [ Source](https://github.com/seppzzz/silverstripe-image-cropper-field)[ Packagist](https://packagist.org/packages/seppzzz/silverstripe-image-cropper-field)[ RSS](/packages/seppzzz-silverstripe-image-cropper-field/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) Image Cropper Field THIS IS A FORK FROM =============================================================================================================== [](#image-cropper-fieldthis-is-a-fork-from-httpsgithubcomwebbuilders-groupsilverstripe-image-cropper-field) Adds the ability to crop images from within the SilverStripe file section. Requirements ------------ [](#requirements) - SilverStripe 4.4.x Installation ------------ [](#installation) Installation is supported via composer only ``` composer require seppzzz/silverstripe-image-cropper-field ``` - Run `dev/build?flush=all` to regenerate the manifest Setup ----- [](#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 --------------------- [](#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](screenshots/Capture_1.jpg)](screenshots/Capture_1.jpg)[![Overview of Image Cropper Field with aspect dropdown shown](screenshots/Capture_2.jpg)](screenshots/Capture_2.jpg)[![Overview of Image Cropper Field with dimension editing shown](screenshots/Capture_3.jpg)](screenshots/Capture_3.jpg) **The tools:** - cropper dimensions tool [![cropper dimensions tool](screenshots/Tool_1.jpg)](screenshots/Tool_1.jpg) - move tool [![move tool](screenshots/Tool_2.jpg)](screenshots/Tool_2.jpg) - cropper tool [![cropper tool](screenshots/Tool_3.jpg)](screenshots/Tool_3.jpg) - zoom tools [![zoom in](screenshots/Tool_4.jpg)](screenshots/Tool_4.jpg) [![zoom out](screenshots/Tool_5.jpg)](screenshots/Tool_5.jpg) - image rotating tools [![rotate left](screenshots/Tool_6.jpg)](screenshots/Tool_6.jpg) [![rotate right](screenshots/Tool_7.jpg)](screenshots/Tool_7.jpg) - reset tool [![reset tool](screenshots/Tool_8.jpg)](screenshots/Tool_8.jpg) - aspect ratio setting tool [![reset tool](screenshots/Tool_9.jpg)](screenshots/Tool_9.jpg) 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](screenshots/Capture_4.jpg)](screenshots/Capture_4.jpg) 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](screenshots/Capture_5.jpg)](screenshots/Capture_5.jpg) Once the link is clicked, you will be taken to your new image. [![Overview of Image Cropper Field](screenshots/Capture_6.jpg)](screenshots/Capture_6.jpg) **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 ------------------ [](#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 --- [](#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](screenshots/Capture_7.jpg)](screenshots/Capture_7.jpg) **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. ### Health Score 15 — LowBetter than 3% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community12 Small or concentrated contributor base Maturity24 Early-stage or recently created project Bus Factor1 Top contributor holds 72.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/e8b4f1ff3d3079c2907fd8b5abcd67e41c1b348f1cf7f1624e8815cf87a6cd4c?d=identicon)[seppzzz](/maintainers/seppzzz) --- Top Contributors [![DoggersHusky](https://avatars.githubusercontent.com/u/8750719?v=4)](https://github.com/DoggersHusky "DoggersHusky (92 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (12 commits)")[![a2nt](https://avatars.githubusercontent.com/u/672794?v=4)](https://github.com/a2nt "a2nt (11 commits)")[![UndefinedOffset](https://avatars.githubusercontent.com/u/1391558?v=4)](https://github.com/UndefinedOffset "UndefinedOffset (11 commits)")[![firebranddevelopers](https://avatars.githubusercontent.com/u/125844589?v=4)](https://github.com/firebranddevelopers "firebranddevelopers (1 commits)") ### Embed Badge ![Health badge](/badges/seppzzz-silverstripe-image-cropper-field/health.svg) ``` [![Health](https://phpackages.com/badges/seppzzz-silverstripe-image-cropper-field/health.svg)](https://phpackages.com/packages/seppzzz-silverstripe-image-cropper-field) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)