Plugin / picowall

Description

With this plugin installed, you could resize images on the fly. just define the size and the way that you want to resize then it’s done.
it is perfect for wallpaper and stock photography websites.

Features of plugin include:

• support different images formats. (PNG, JPG, JPEG, GIF)
• Intelligent sizing – No image distortion!
• Resize by exact width/height. (exact)
• Auto determine – let the script determine how to handle it. (auto)
• Resize, then crop, with the exact size and no distortion. (crop)
• Automatic download after resize.
• Powerful shortcode.

Languages

1. English
2. Persian (Farsi) – (راهنمای فارسی)

Notes

Automatic download works with a wide range of devices and browsers.

You can expect it to work for the vast majority of your users, with some common-sense limits:

• Devices without file systems like iPhone, iPad, Wii, et al. have nowhere to save the file to, sorry.
• Android support starts at 4.2 for the built-in browser, though chrome 36+ and firefox 20+ on android 2.3+ work well.
  *Devices without Blob support won’t be able to download Blobs or TypedArrays
• Legacy devices a[download] support can only download a few hundred kilobytes of data, and can’t give the file a custom name.
• Devices without window.URL support can only download a couple megabytes of data
• IE versions of 9 and before are NOT supported because the don’t support a[download] or dataURL frame locations.

Function Reference

there is two way to use this plugin, function, and shortcode.

shortcode

if you’re not familiar with programming. then use picowall shortcode to setup the script without programming knowledge.

shortcode attributes:

• size (required) – you should at least define a width and height but also you can define multiple sizes (width,height,option|width,height,option|… width,height,option).
• option (optional) (default:auto) – define the way that you want to resize (auto|exact|crop) if you don’t define this attribute then the script will automatically decide how to handle it.
  keep in mind that this attribute will make a global effect on each size block that you didn’t define an option for it.
• sep (optional) (default: non-breaking space ” “) – with this attribute you can define a character to separate output links from each other.

examples

resize to exact width/height: [picowall size=”800,600″ option=”exact”]

resize to exact width/height (multiple size): [picowall size=”800,600|1920,1080″ option=”exact”]

resize then crop the first one and then for other ones just resize to exact width/height and then separate the results with a dash (pretty cool huh ?!)

picowall[size=”800,600,crop|1920,1080|150,150″ option=”exact” sep=”-“]

you can see that I use a different syntax in the last example. that is a “sizing block”.
it means that you can define multiple sizes with different ways to resize. simply just define it like this:

with,height,option|width,height,option| …. width(n),height(n),option(n).

note: use a vertical bar (|) to separate the size block.

keep in mind that if you don’t define the option for a sizing block then the value of “option” attribute will effect on that block. and also if you don’t define it there, then the script will automatically decide how to handle resizing.

functions

picowall($size,$option,$id)

this function will return an array of links to download resized images.

parameters

• $size (required) – just like the shortcode you can define setting blocks too
• $option (optional) (default: ‘auto’)- same as option attribute in shortcode.
• $id (optional) (default: null) – if you use this function outside the loop then you have to define the id of post that you want to fetch photo from.

picowall_generate_links($size,$option,$sep,$id)

this function will print the result of above function in HTML.

parameters

• $size (required) – just like the shortcode you can define setting blocks too
• $option (optional) (default: ‘auto’)- same as option attribute in shortcode.
• $sep (optional) (default: non breaking space ” “) – same as sep attribute in shortcode.
• $id (optional) (default: null) – if you use this function outside post loop then you have to define the id of that post which you want to fetch photo.
  u want to fetch photo.