Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Image resize plugin for EE2
PHP
branch: master

readme.md

Requirements

  • ExpressionEngine 2.x
  • PHP 5+
  • GD2 or Imagick

Parameters

Required

The src and at least 1 dimension parameter are required

src: Path to the image can be a full or relative (to the index.php) system path or a local url
width and/or height: Absolute width or height to resize to
max_width and/or max_height: Maximum width or height to resize to

Optional

The following options can also be set globaly in a config file using like $config['img_resize:param'] = 'VALUE'

quality: The quality of the resized image between 0-100. Default is 100.
retina_quality: The quality of the resized retina image between 0-100. Defaults to whatever quality is.
just_url: Set this to 'yes' to only return the URL to the image
sharpen: Setting this to 'yes' will cause images to be sharpened after they are resized
urldecode: Setting to 'no' will disable decoding of the src url
handle_retina: Set to 'no' to disable
h_align and/or v_align Adjusts where the crop is done from, default is 50 (center of the image)

These should only be set if you know what you are doing
base_url: URL to where your images are stored, default is your base_url
base_path: The base path to where your images are stored, this is used to determine the path to your images when using relative image paths
cache_path: Full path to where your images are cached, default is FCPATH/images/resized
cache_url: URL to where your images are cached, default is your base_path + /images/resized

Attributes

These will be set as attributes on the img tag

alt
title
id
class

Example Usage

{exp:img_resize src="/assets/img/imagename.jpg" width="100" height="100" alt="Some alt text"}
// Outputs
<img src="http://domain.com/images/resized/assets/img/imagename_100x100.jpg" width="100" height="100" alt="Some alt text">

{exp:img_resize src="/assets/img/imagename.jpg" width="100" height="100" just_url="yes"}
// Outputs
http://domain.com/images/resized/assets/img/imagename_100x100.jpg

Retina Handling

If you have a 100x100 image named like image@2x.png and resize to 25x25 the plugin will generate two images.

The first image will be 25x25 and named like image_25x25.png The second image will be 50x50 and named like image_25x25@2x.png

This should provide support for many retina handling methods that use @2x as an identifer, like http://retinajs.com/.

A data-retina attribute will also be set on the img tag containing the url to the retina image.

Changelog

View the Changelog

Something went wrong with that request. Please try again.