Ready to get started?Download WordPress

Plugin Directory

Get the Image

An easy-to-use image script for adding things such as thumbnail, slider, gallery, and feature images.

Version 1.0.0

General Changes:

  • the_post_thumbnail argument deprecated in favor of featured.
  • image_scan argument deprecated in favor of scan or scan_raw.
  • default_image argument deprecated in favor of default.
  • order_of_image argument removed with no replacement.


  • Re-coded how the image script works by encapsulating the functionality into a single class rather than multiple functions. This makes it much easier to reuse code and paves the way for more improvements in the future.
  • New scan_raw argument for pulling an image (straight HTML) directly from the post content.
  • New split_content argument for removing an image from the post content if one is found. Used only in conjunction with the scan_raw argument.
  • New order argument for changing the order in which the script looks for images.
  • Better support and handling for sub-attachments (e.g., featured images for audio/video attachments).
  • Support for Schema.org microdata. itemprop="image" attribute added to image outputs where possible.
  • New image orientation class if the width and height are available. Class can be landscape or portrait.
  • Default image size is post-thumbnail if the theme has set this size. Otherwise, thumbnail is the default size.
  • Supports the ability to get embedded images via WordPress' image embeds (Instagram, Flickr, etc.) via the scan* methods.
  • New filter hook: get_the_image_post_content. Used when checking the post content.
  • Added min_width and min_height arguments (doesn't work with scan* methods).

Version 0.9.0


  • Caption support. FTW!
  • Multiple image classes now allowed via the image_class argument.
  • Use current theme's post-thumbnail as default image size if set via set_post_thumbnail_size().

Bug fixes:

  • Use the WordPress-saved attachment alt text for the image.
  • Only add $out['src'] if $out['url'] is set when returning as an array.
  • Allow https when returning as an array.
  • Use the correct variable ($attachment_id) when getting an image via attachment.

Version 0.8.1

  • Use correct $attachment_id variable instead of $id.
  • Pass full $image array to the get_the_image_meta_key_save() function so that it saves correctly.
  • Only use before and after arguments if an image is found.
  • General code formatting updated.

Version 0.8

  • Inline docs updates.
  • Added the before argument to output HTML before the image.
  • Added the after argument to output HTML after the image.
  • Added the thumbnail_id_save argument to allow the attached image to be saved as the thumbnail/featured image.
  • Get the post ID via get_the_ID() rather than the global $post object.
  • Fixed debug notice with $image_html.
  • Moved the *_fetch_post_thumbnail_html hooks into the main function and only fire them if displaying to the screen.
  • Simplified the meta_key logic.
  • Completely rewrote the attachment logic.
  • Sanitize classes with sanitize_html_class().

Version 0.7

  • Deprecated and replaced functions that lacked the get_the_image_ prefix.
  • New cache delete functions that delete when a post or post meta is updated.
  • Fixed notice when image_scan was used.

Version 0.6.2

  • Updated the cache to save by post ID instead of a single object.
  • Minor code adjustments.

Version 0.6.1

  • Updated inline documentation of the code.
  • Smarter meta_key logic, which allows a single meta key or an array of keys to be used.
  • Set custom_key and default_size to null by default since they're deprecated.

Version 0.6

  • Deprecated custom_key in favor of meta_key.
  • Added the meta_key_save argument to allow users to save the image as a meta key/value pair.
  • Added a callback argument to allow developers to create a custom callback function.
  • Added a cache argument, which allows users to turn off caching.

Version 0.5

  • Added support for persistent-caching plugins.
  • Switched the default_size argument to size to be more in line with the WordPress post thumbnail arguments, but default_size will still work.
  • Now using wp_kses_hair() to extract image attributes when using the array value for format.
  • Image alt text will now use the attachment description if one has been given rather than the post title.
  • Updated the readme.html instructions for using the plugin.

Version 0.4

  • Dropped support for older versions of WordPress. Now only compatible with 2.9+.
  • Added support for the_post_thumbnail(), which is WordPress 2.9's new image functionality.
  • New function: image_by_the_post_thumbnail().
  • Documented more of the code, so the inline PHP doc is updated.
  • Cleaned up some of the old legacy code that's no longer needed.

Version 0.3.3

  • General code cleanup
  • Added the get_the_image filter hook.

Version 0.3.2

  • General code cleanup.
  • More efficient and logical code.
  • Beefed up the inline documentation so developers can better understand the code.
  • Added a GPL license.txt file.

Version 0.3.1

  • Fixed the default image and image scan features.

Version 0.3

  • Changed methods of calling the image script.
  • Added more parameters.

Requires: 3.9 or higher
Last Updated: 2014-7-10
Downloads: 412,570


4 stars
4.7 out of 5 stars


1 of 2 support threads in the last two months have been resolved.

Got something to say? Need help?


Not enough data

1 person says it works.
0 people say it's broken.

100,3,3 100,3,3
75,4,3 100,3,3
100,7,7 100,1,1 100,4,4
100,7,7 100,2,2
100,1,1 100,3,3
88,8,7 88,8,7
80,5,4 100,1,1
67,3,2 100,1,1
100,1,1 75,4,3
80,5,4 100,1,1
100,1,1 100,1,1
100,1,1 100,2,2