Skip to content

kcolls/ImageResizer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 

Repository files navigation

Image Resizer

Image Resizer is a Craft plugin that resizes your assets when they are uploaded. This allows huge images to be resized so as not to use up unnecessary disk space, but still kept at a reasonable resolution. This plugin is not a replacement for using image transforms throughout your site.

Install

  • Add the imageresize directory into your craft/plugins directory.
  • Navigate to Settings -> Plugins and click the "Install" button.

Plugin options

  • Enable/Disable resizing images on upload. Enabled by default.
  • Set the maximum width/height (in pixels) for uploaded images. Set to 2048px by default.
  • Set the quality for resized images between 0-100. Set to 100 by default.
  • Select which Asset sources you want resizing to be performed on.

Resizing

Resizing of images can be setup to run automatically (through the plugin settings) whenever new images are uploaded. The aspect ratio of images are maintained, and will always match the maximum width/height options in your plugin settings. For example, given a 4000 x 2500px image and a max width/height of 1024px, the resulting image would be 1024 x 640px.

Please note that resizing of images will permanently alter the original uploaded image, so be sure to set the maximum allowed size to something that works for your purposes, while maintaining image quality.

Batch Resizing

To batch resize images, use the Assets Index to select which image files you'd like to resize, click on the Actions button and select Resize image.

You'll be presented with a warning screen advising that the selected images will be resized according to your plugin settings.

Under the hood, the batch processing is run through Craft's Tasks service, which will allow you to process plenty of images at once, without timing out or running into memory issues.

Cropping

You can crop any image through the Assets Index screen, by clicking on the Actions button, and selecting Crop image. You can only crop one image at a time. There are several preset options related to the aspect ratio to control how cropping is controlled, and are selected through the Crop modal window.

Activating the cropping interface upon upload of new images is on the Roadmap, and will be released soon.

Aspect ratio options are:

  • Free: No restrictions
  • Square: Restricted to square crop
  • Constrain: Restricted to the aspect ratio of the image
  • 4:3: Restricted to a 4:3 aspect ratio crop

Roadmap

  • Provide cropping options on-upload.
  • Allow Asset folder selection in addition to source.
  • Provide hook for third-party Aspect Ratio options.

Changelog

0.0.7

  • Fix to ensure images uploaded are both an image, and manipulatable.
  • Better error-catching for resizing.

0.0.6

  • Added cropping option to Element Actions.

0.0.5

  • Performance improvements - now uses Tasks to handle batch resizing.

0.0.4

  • Fix to make sure environment variables are parsed for asset sources.

0.0.3

  • Added batch processing for existing assets.
  • Added image quality option.

0.0.2

  • Moved hook from onBeforeSaveAsset to onSaveAsset.
  • Asset record is updated after resize, reflecting new image width/height/size.
  • Added option to restrict resizing to specific Asset sources.

0.0.1

  • Initial release.

About

A Craft CMS plugin to resize images on upload.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 56.1%
  • PHP 33.6%
  • CSS 5.5%
  • HTML 4.8%