CP Blogs

Announcement: New CMS Made Simple plug-in -- SuperSizer

---

Where can you find it... http://dev.cmsmadesimple.org/projects/supersizer

What does this tag do?

• Creates a resized version of an image on the fly.
• Creates a cached version of the image to be severed.
• It supports any image format supported by the GD library
• It supports Subdomain image severing for optimal setup

How do I use this tag?

Just insert the tag into your template/page like in one of the examples here:
1. {supersizer path='uploads/images/test.jpg' percentage='25'}
2. {supersizer path='uploads/images/test.jpg' width='320'} (With aspect ratio)
3. {supersizer path='uploads/images/test.jpg' height='240'} (With aspect ratio)
4. {supersizer path='uploads/images/test.jpg' width='150' height='140'} (Aspect ratio depends on given width, height)
5. {supersizer path="$LogoSub" width='150' rootUrl="http://media.domain.org/uploads"}
5. {supersizer path="$LogoSub" width='150' Quality=55 Protect=false}
5. {supersizer path="$LogoSub" width='150' class='LogoImg' alt="$Name" rootUrl="http://media.domain.org/uploads" Quality=55}

What parameters does it take?

• path - Image full pathname eg: uploads/images/test.jpg or $entry->logo_path in Company Directory etc...
• rootUrl (optional) - supersizer creates a temp director in the upload folder. If you move the path to the uplaod to a subdomain you may guide the output with this.
• Exapmle: you changed $config['uploads_path'] = '/var/www/vhosts/domain.org/httpdocs/uploads';
• to $config['uploads_path'] = '/var/www/vhosts/domain.org/subdomains/media/httpdocs/uploads';
• now the uploads url would not work as it would be http://www.domain.org/uploads
• So it can be changed here to http://media.domain.org/uploads (NOTE: watch your / )
• For an example visit http://www.northcentralidaho.org/SERVICES-and-MERCHANTS.html and drill down to a company to which you'll see images coming from the subdomain
• Protect (optional) - Don't resize if smaller.. ie: don't size up if true ( true/false )
• Quality (optional) - Resize image at set Quality default is 85 (NOTE: 1-100 ).
• class (optional) - Add a class
• alt (optional) - Add an alt
• id (optional) - Add an id
• title (optional) - Add a title
• percentage (optional) - Resize image in percent of original eg. 50%.
• width (optional) - Resize image on width and height will resize accordingly to keep aspect ratio
• height (optional) - Resize image on height and width will resize accordingly to keep aspect ratio
• height and width (optional)
  Important:You may use width in conjunction with height in order to resize image to an absolute size of your control. Aspect ratio is then, dependent on the values you use. If no parameters for resizing are passed (except for the path) then a resizing with a percentage value of 25% is performed by default