Simple Image Grabber

August 18, 2015

Simple Image Grabber Plugin

Display one or all images from a post's content. Options include image width, height, class and permalink.

Display one or all images from a post’s content. Options include image width, height, class and permalink.

Installation

  1. Unzip the simple-image-grabber.zip file.
  2. Upload the simple-image-grabber folder to the /wp-content/plugins/ directory.
  3. Activate the plugin through the ‘Plugins’ menu in WordPress.
  4. Place <?php images(); ?> within the loop to grab your post’s images.

FAQ

1) How can I customize the Simple Image Grabber function?

The images() function accepts five variables.

The basic use of the function looks like: <?php images( '1' ); ?> or <?php images(); ?>

This will display the first image from your post, with its default width and height, no class and a permalink to the post.

This is how the function looks with passing all variables directly or through an array:

<?php images( $number, $width, $height, $class, $permalink, $echo ); ?> <?php $defaults = array( 'number' => 1, 'width' => null, 'height' => null, 'class' => 'alignleft', 'permalink' => true, 'echo' => true ); images( $defaults ); ?> 

$number = the image you want to pull from your post, ie. the first image from the post (‘1’) or the second image from the post (‘2’) and so on. NOTE: If you use ‘all’, it will display all images from the post.

$width = the width of the displayed image

$height = the height of the displayed image

$class = the class you would like to assign to the displayed image

$permalink = whether you would like the image to link to the post or not

$echo = echo or return the value

The following function will echo the second image from a post (if there is one) with a width of 150px and a height of 200px, the class “alignleft” and no link to the post.

<?php images( '2', '150', '200', 'alignleft', false ); ?> 

The following will return all images from a post with their original width and height, a class name of alignright and a link to the post.

<?php $args = array( 'number' => 'all', 'class' => 'alignright', 'echo' => 0 ); $all_images = images( $args ); ?> 

Changelog

1.0.5 (2015-8-18)

  • Added validation
  • Updated contributor username
  • Updated version and stable tag

1.0.4 (2012-10-04)

  • Updated donate link

1.0.3 (2012-06-04)

  • Added the ability to pass an array to the images() function
  • Added the ablity to either echo or return the value string
  • Cleaned up and improved code
  • Added comments and PHPDocs

1.0.2 (2009-10-15)

  • Added original width and height to img tag if neither is set

1.0.1 (2009-03-16)

  • Fixed issue with “All” variable

1.0 (2009-03-11)
Initial Public Release

Details

  • Version: 1.0.5
  • Active installations: 200
  • WordPress Version: 2.7
  • Tested up to: 4.3.34

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars