/Aqua-Resizer

Resize WordPress images on the fly

Primary LanguagePHP

Version 1.2

This small script will allow you to resize & crop WordPress images uploaded via the media uploader on the fly. It relies on WP's native functions to resize the images, and checks if there is an already resized version of the image so that it won't be wasting your server's resources to regenerate the images.

Why use it?

There are a couple of image resizing scripts out there that already have this function. Some authors simply use the add_image_size() function to define custom image sizes that will be generated for each image uploaded via the media uploader. I mostly find these methods somewhat a little complicated to use, or having some limitations or too resource intensive.

With Aqua Resizer, the only required inputs are the URL and width. It's easy, fast & efficient. Additionally, you have the additional options such as the height, crop, and array return.

How to use

Simply copy aq_resizer.php into your theme and reference it from your functions.php file e.g. require_once('aq_resizer.php');, then you're good to go.

You can then use it in your theme as such:

aq_resize($img_url,$width);

More usage instructions and examples can be found in our wiki

License

WTFPL

Do whatever you want with it. A linkback would be nice :)

Donations

If you have some spare bucks, please seriously consider helping the World Food Programme to build world without hunger. Your donations will provide foods & shelters to those who needs them the most! - Fill the Cup!

Or, buy me a coffee :)

Contacts

Twitter: http://twitter.com/syamilmj

Website: http://aquagraphite.com

Changelog

v1.2.0

  • Aqua Resize is now basically a class (still with a wrapper function so usage has not changed at all)
  • class written as Singleton pattern
  • removed fallback for WP older v3.5

v1.1.7

  • either $width or $height is required
  • return false if the image can not be resized to the exact dimension specified in the arguments in crop mode
  • return the original image if specified dimension is the same as the one of the original image

v1.1.6

  • uses wp_get_image_editor() (WP3.5)

v1.1.5

  • handles wp_error
  • shorten script

v1.1.4

  • fix for compatibility with wpml

v1.1.3

  • array return use int (0,1,2)

v1.1.2

  • add check for broken image

v1.1.1

  • default $single to true and return string

v1.1

  • fix issue with smaller widths

v1.0 first commit