Simple Image Crop
No security coverage
This module provides a simple image cropping field that allows editors to easily crop and resize images with a fixed aspect ratio and specified dimensions. It automatically generates optimized images and works on any content entity.
This module is ideal when you want reliable, consistent image cropping with minimal configuration and no unnecessary overhead.
Features
Simple Crop provides a new field type that allows editors to crop images using a fixed ratio, resize them to a specified final dimension, and automatically generate optimized images.
- Works on any content entity (nodes, products, etc.)
- Uses a clean, mobile-friendly JavaScript cropper widget
- Configurable "Fixed" aspect ratio ensures layout consistency
- Automatically generates final resized images to
public://simple_crop/ - No reliance on Crop API or focal point modules
- Custom output dimensions per field instance
- Stores crop coordinates and processed image reference with the field
Post-Installation
After installing the module:
- Go to Manage fields for your content type, and add a new field of type Simple Crop.
- Configure the aspect ratio and final image size (e.g., 4:3, 390x280 pixels).
- On content edit forms, users will be able to upload an image and visually select a crop region that fits the configured ratio.
- On save, the image is cropped and resized automatically. The resulting image is saved and displayed in place of the original.
Additional Requirements
- Hook Event Dispatcher module (required for handling entity save events)
- GD library or ImageMagick enabled on the PHP server (for image processing)
Recommended modules/libraries
- Image module (core) — handles file uploads and base image functionality
- Image Effects — if you need additional filters or styling after cropping
Similar projects
- Image Widget Crop — more complex and relies on Crop API. Good for reusable crops or multiple crops per image, but heavier and less beginner-friendly.
- Focal Point — allows selecting the image's focus rather than cropping. Useful for art direction but doesn't enforce aspect ratios or output dimensions.
Simple Crop is different because it:
- Has no extra entity types or configuration UI
- Stores crop and processed image per field instance
- Prioritizes simplicity, visual feedback, and consistent output
Supporting this Module
If you'd like to support development of this module, feel free to reach out to Joseph Olstad or contribute on the issue queue.
Community Documentation
- Focus touch resizable JS Widget
- Live test site: TBD