About this plugin
This functions are for those needs to resize images on their templates or plugins all the time.
FUNCTION: k1_get_post_thumb_url
DESCRIPTION
string k1_get_post_thumb_url(int $post_id)
This function return the URL for the FEATURED IMAGE (full sized) defined in a POST/PAGE even if the upload is no on the actual post. If is not defined returns the FIRST image if there is at least one.
Returns NULL if no jpg,png or gif images as attachments.
USAGE EXAMPLE
>
PARAMETERS
- $post_id If is empty, we will try to get the POST ID from the global $post var
FUNCTION: k1_get_post_timthumb_img_url
DESCRIPTION
string k1_get_post_timthumb_img_url(int $post_id, int $width, int $height, int $crop, char $align, int $quality)
Returns the IMAGE full URL using timthumb script to resize the post featured image. Use this when you only need the URL not the IMG html tag.
USAGE EXAMPLE
>
PARAMETERS
- $post_id If is empty, we will try to get the POST ID from the global $post var
- $width This is numeric in pixels, if you use 0 width will be proportional to height. See: http://www.binarymoon.co.uk/demo/timthumb-basic/
- $height This is numeric in pixels, if you use 0 height will be proportional to height. See: http://www.binarymoon.co.uk/demo/timthumb-basic/
- $crop Use: 0 Resize to Fit specified dimensions (no cropping), 1 Crop and resize to best fit the dimensions (default), 2 Resize proportionally to fit entire image into specified dimensions, and add borders if required, 3 Resize proportionally adjusting size of scaled image so there are no borders gaps, see: http://www.binarymoon.co.uk/demo/timthumb-zoom-crop/
- $align c: position in the center (this is the default), t: align top, tr: align top right, tl: align top left, b: align bottom, br: align bottom right, bl: align bottom left, l: align left, r: align rightSee: http://www.binarymoon.co.uk/2010/08/timthumb-part-4-moving-crop-location/
- $quality 70: Image quality from the original uploaded image in percentage
NOTE: If you just define one height or width as zero (0) the other one will conserve image proportion, if is not defined it will be default value.
FUNCTION: k1_get_post_thumb_img_html
DESCRIPTION
string k1_get_post_thumb_img_html(int $post_id, boolean $resize, int $width, int $height, int $crop, char $align, int $quality)
This function returns the FULL IMG HTML tag for the post featured image using TIMTHUMB or not as desired
USAGE EXAMPLE
>
PARAMETERS
- $post_id If is empty, we will try to get the POST ID from the global $post var
- $resize TRUE to use timthumb script to resize the image, FALSE to return the image without any dimension change.
- $width This is numeric in pixels, if you use 0 width will be proportional to height. See: http://www.binarymoon.co.uk/demo/timthumb-basic/
- $height This is numeric in pixels, if you use 0 height will be proportional to height. See: http://www.binarymoon.co.uk/demo/timthumb-basic/
- $crop Use: 0 Resize to Fit specified dimensions (no cropping), 1 Crop and resize to best fit the dimensions (default), 2 Resize proportionally to fit entire image into specified dimensions, and add borders if required, 3 Resize proportionally adjusting size of scaled image so there are no borders gaps, see: http://www.binarymoon.co.uk/demo/timthumb-zoom-crop/
- $align c: position in the center (this is the default), t: align top, tr: align top right, tl: align top left, b: align bottom, br: align bottom right, bl: align bottom left, l: align left, r: align rightSee: http://www.binarymoon.co.uk/2010/08/timthumb-part-4-moving-crop-location/
- $quality 70: Image quality from the original uploaded image in percentage
NOTE: If you just define one height or width as zero (0) the other one will conserve image proportion, if is not defined it will be default value.
TODO:
- Get the attachment metadata to make the longdesc=”” and alt=”” IMG properties.
- Use the parameters as array to implement more options