WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

ChoiceCuts Image Juggler

Version: 0.8.3.2, 11/10/2010 ChoiceCuts Image Juggler resizes images, generates thumbnails, adds lightboxes and enhances image presentation in WordPr

Usage Exmaples

SHOW JUST THE FIRST IMAGE AS A LANDSCAPE BANNER - Get the first image from the current Post and output it as a 480px x 100 px and remove all other images from Post Content.

<< php code start >> the_post(); $postContent = get_the_content(); ccImj_firstLandscape( $postContent, 480, 100 ); echo ccImj_noImg( $postContent ); << php code end >>

CREATE A THUMBNAIL FOR EACH OF 10 MOST RECENT POSTS IN THE BLOG CATEGORY - Get all posts from the 'Blog' category and output them as 60px square thumbnails, as well as the post title and post excerpt.

<< php code start >> query_posts( "category_name=Blog&showposts=10&orderby=date&order=DESC" ); while(have_posts()) { the_post(); $postContent = get_the_content(); ccImj_firstThumb( $postContent, 60, get_permalink() ); the_title(); the_excerpt(); }
<< php code end >>

Full Plugin API

N.B. All functions are technical documented within the plugin code. Read through file cc_image_juggler.php within the plugin install folder for more information.

// -------------------------------------------------------------------------- IMAGE EXRACTION UTILITIES

ccImj_getFirstImg - extract the first image from passed $content, return image file path only << php code start >> $image = ccImj_getFirstImg( $postContent ); ?> << php code end >>

ccImj_getAllImg - extract all images from passed $content, returns a multi-dimensional array. The returned array contains an element for each image found. Within each element is an associative array as follows: ['tag'] - full html img tag. ['url'] - image file path only. << php code start >> $images = ccImj_getAllImg( $postContent ); ?> << php code end >>

ccImj_noImg - remove all images from the passed parameter, typically post content << php code start >> $contentWithoutImages = ccImj_noImg( $postContent ); ?> << php code end >>

// -------------------------------------------------------------------------- IMAGE MANIPULATION PREPARATION

ccImj_resizeWidthURL - resize image to specified width, pass min_height to ensure consistent image dimensions. Return only the image resize URL, without embedding any HTML tags << php code start >> $resizeUrl = ccImj_resizeWidthURL( $img_path, 480, 120 ); ?> << php code end >>

ccImj_resizeHeightURL - resize image to specified height. Return only the image resize URL, without embedding any HTML tags << php code start >> $resizeUrl = ccImj_resizeHeightURL( $img_path, 300 ); ?> << php code end >>

ccImj_resizeWidth - resize image to specified width. Return full HTML IMG tag for resized image << php code start >> $image_html = ccImj_resizeWidth( $img_path, 480, 'class="special-image-style" rel="ajax-link-code-13"' ); ?> << php code end >>

ccImj_resizeHeight - resize image to specified height. Return full HTML IMG tag for resized image << php code start >> $image_html = ccImj_resizeHeight( $img_path, 300, 'class="special-image-style"' ); ?> << php code end >>

ccImj_cropLandscape - proportionally resize image to specified width, then crop excess height as required << php code start >> $image_html = ccImj_cropLandscape( $img_path, 300, 240 ); ?> << php code end >>

ccImj_cropPortrait - proportionally resize image to specified height, then crop excess width as required << php code start >> $image_html = ccImj_cropPortrait( $img_path, 300, 240, 'class="special-image-style" alt="Your Blog"' ); ?> << php code end >>

ccImj_cropSquareCtr - resize image to specified size, then crop a square from the centre << php code start >> $image_html = ccImj_cropSquareCtr( $img_path, 60, 'class="special-image-style"' ) << php code end >>

// -------------------------------------------------------------------------- 'GET FIRST' FUNCTIONS

ccImj_firstLandscape - extract the first image from the passed content, resize image to specified width, crop the excess if required and wrap it in a hyperlink if desired << php code start >> ccImj_firstLandscape( $postContent, 480, TRUE, FALSE, 'class="special-image-style"' ); ?> << php code end >>

ccImj_firstPortrait - extract the first image from the passed content, resize image to specified height, crop the excess if required and wrap it in a hyperlink if desired << php code start >> ccImj_firstPortrait( $postContent, 600, TRUE, FALSE, 'class="special-image-style"' ); ?> << php code end >>

ccImj_firstThumb - extract the first image from the passed content, then crop a square from the centre and wrap it in a hyperlink if desired << php code start >> $image_html = ccImj_firstThumb( $content, 130, FALSE, TRUE, 'class="thumbnail-image-style"' ); ?> << php code end >>

// -------------------------------------------------------------------------- RESIZE & CROP PASSED IMAGE FUNCTIONS

ccImj_linkedLandscape - resize image to specified width and height, then wrap it in a hyperlink if desired << php code start >> ccImj_linkedLandscape( $img_path, 600, 200, FALSE, FALSE, 'class="mega-banner"' ); ?> << php code end >>

ccImj_linkedPortrait - resize image to specified height and width, then wrap it in a hyperlink if desired << php code start >> $your_variable = ccImj_linkedPortrait( $img_path, 400, 180, TRUE, TRUE, 'class="thumbnail-image-style"' ); ?> << php code end >>

ccImj_linkedThumb - resize image to specified size, then crop a square from the centre and wrap it in a hyperlink if desired << php code start >> ccImj_linkedThumb( $img_path, 200, 'http://www.workwithchoicecuts.com', FALSE, 'class="thumbnail-image-style"' ) << php code end >>

// -------------------------------------------------------------------------- FILTER ALL FUNCTIONS

ccImj_flexiWidth - resize all images, to be within specified width sizes, in every post. if image is larger than max_width resize and present original via lightbox, or if smaller than min_width resize up to min_width. ** To use this function edit the constant 'FILTER_FLEXI_WIDTH' value to be TRUE. Find this at the top of the plugin code.

ccImj_allWidth - resize all images, to specified width, and wrap it in a hyperlink if desired ** To use this function edit the constant 'FILTER_ALL_WIDTH' value to be TRUE. Find this at the top of the plugin code.

ccImj_allCrop - resize all images, to specified square thumbnail size, in every post to specified height and wrap it in a hyperlink if desired ** To use this function edit the constant 'FILTER_ALL_CROP' value to be TRUE. Find this at the top of the plugin code.

Requires: 2.5 or higher
Compatible up to: 3.0.5
Last Updated: 2010-10-12
Downloads: 4,657

Ratings

3 stars
3.8 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1
0,1,0