robsonsobral/ed.imageresizer.ee2_addon

EE2+ Version of the ED ImageResizer. Resizes, crops and caches images on the fly.

ED Image resizer for ExpressionEngine 2.x

Resize images on the fly

Installation

1. Copy pi.ed_imageresizer.php to system/expressionengine/third_party/ed_imageresizer/
2. Add path variables to your config at system/expressionengine/config/config.php:

$config['ed_server_path'] = '/var/www/html/'; // Server path to your site's web root
$config['ed_cache_path'] = '/var/www/html/media/images/resizer_cache/'; // Server path to where your resized images should be stored
$config['server_url']	= 'http://sub.domain.com'; // OPTIONAL - no trailing slash

Usage

Parameters

• image (string) required : the file to resize
• maxWidth (integer) : maximum width of the resized image
• maxHeight (integer) : maximum height of the resized image
• forceWidth (boolean “yes” or “no”, default “no”) : will force the width, even if the original’s width is less
• forceHeight (boolean “yes” or “no”, default “no”) : will force the height, even if the original’s height is less
• cropratio (string format “integer:integer”) : crops the image to the defined ratio
• default (string) : a backup image to use if the image is not found
• alt (string) : an alt tag for the image
• class (string) : a class for the image tag
• id (string) : an ID for the image tag
• title (string) : a title for the image tag
• href_only (boolean “yes” or “no”, default “no”) : if yes, will return only the href, not the image tag
• debug (boolean “yes” or “no”, default “no”) : will optionally output an error message if one is encountered, otherwise will fail silently
• grayscale (boolean “yes” or “no”, default “no”) : grayscales the resized image
• crop_align (string “t”, “r”, “b”, “l” and “c”, default “cc”) : sets the align of crop. First character for horizontal and second for vertical.
• baseline (number) : sets the typographic baseline to match the height of image

Usage example

{exp:ed_imageresizer
    image="{my_image_field}"
    default="/images/site/default_image.png"
    maxWidth="100"
    cropratio="100:120"
    class="my_class"
    alt="Image description"
    grayscale="yes"
    }

Would then output the following:

<img src="/media/images/resizer_cache/resized_image.jpg" width="100" height="120" alt="Image description" />