Drupal is a registered trademark of Dries Buytaert

simple_crop

No security coverage
View on drupal.org

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:

  1. Go to Manage fields for your content type, and add a new field of type Simple Crop.
  2. Configure the aspect ratio and final image size (e.g., 4:3, 390x280 pixels).
  3. On content edit forms, users will be able to upload an image and visually select a crop region that fits the configured ratio.
  4. 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)

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

Activity

Total releases
2
First release
Aug 2025
Latest release
6 months ago
Release cadence
0 days
Stability
0% stable

Releases

Version Type Release date
1.0.x-dev Dev Aug 9, 2025
1.x-dev Dev Aug 9, 2025