Students get a Tuts+ subscription for just $45! Hurry limited offer.

Automagic Post Thumbnails & Image Management


Using a custom post thumbnail or featured image function for your posts and pages in WordPress has been a well known trick for a while now. You can use it to create content sliders or other related functions which enhance the overall look of a WordPress site... but using such features can sometimes give you some trouble (or at least I have experienced some difficulties), especially when I'm updating my blog from my mobile device using WordPress for Android or WordPress for BlackBerry. Today, I'm going to show you a few tricks that have helped me out in the past - hopefully they'll help you out as well!

In this article, I will share with you how to detect the first image in your post attachments or use a default thumbnail defined for your theme development. You can view the example of this function on my Personal Blog. You can use this snippet in your theme for easy thumbnail management and give user a better user experience using your theme.

WordPress Post Thumbnails

Before we get started, it's worth noting that I won't be using the official "post thumbnails" feature in this particular tutorial. Obviously, this is the gold standard preferred way to grab a post "featured image"... but there are a few technical reasons for why you might not want to use that:

  • The theme already uses the_post_thumbnail(); function for something else. For instance: You want to grab an image for a custom slider, but the official post-thumbnail is already being used for an actual thumbnail (and you don't want to worry about odd cropping if you use one image for both instances).
  • You don't like the code output of the_post_thumbnail();. I won't go too far into this, but for really custom situations it can actually be easier just to grab an image this way than to wrestle with getting the_post_thumbnail(); to output the way you'd like.
  • You want lots of different "post-thumbnails" at radically different sizes and ratios... and you aren't satisfied with how WordPress is cropping them using the_post_thumbnail();.
  • Your post images are hosted elsewhere. Meaning, you can't grab them using the_post_thumbnail() because they aren't actually hosted on your server.
  • You simply want to try something new. We'll be going over some techniques here that are just plain interesting whether you have an immediate use for them or not!

There might be more reasons that you can come up with, but these were the main reasons that I ended up using the method that I'll be going over here. Keep in mind that I'm not disregarding the_post_thumbnail(); There's a whole lot that you can do with that alone, and we'll probably be providing an in-depth tutorial on the subject in the next week or two just to supplement this!

Step 1 Grabbing the Custom Field

First of all, we will use a custom field to define our thumbnail. You can read more about setting this up using a "custom meta box"... but let's just assume that you have a custom field already set up (you can enter it manually if you don't want to bother with a custom meta box ). for this tutorial, I'm using the custom field "wpt_image" for the thumbnail. Outside of using the_post_thumbnail(); This is the simplest way for us to define custom thumbnail for our post.

Step 2 Grabbing Image Attachments In The Post

Next we will check if the custom field is empty or not. If the custom field for image is empty, we will try to fetch any image attachment from the post. You can simply use the Upload/Insert function and upload a new image without the need to actually insert it into the article. WordPress will assign the attachment to the post ID automatically.

The code below will try to fetch the first attachment available in the post.

If at least one attachment is found, then we will read the attachment url.

We will use the first image attachment url as our default thumbnail url.

Step 3 Detect Any Image Found in a Post

What if there are no attachment or custom field value found? We will try to fetch any image in the article that was inserted without using the upload function. This is useful when we use an image from media library, because the attachment id will be assign to other post.

Step 4 Define A Default Thumbnail As a Fallback

What if all the conditions above return no value? Well, you can opt to not use any images at all, or, you can define a "default" image placeholder. We will define our own default thumbnail to be use. This is where I find it very useful, especially when I'm updating my blog from mobile apps. I don't need to define any custom field or upload an image, I can simply write my article and upload it to my blog, and the function will do all the magic to ensure my front page look as good as I want it to.

Upload your "default_thumbnail" image to your theme directory, or you can use a full url instead.

Usage: How to Use This Function

To use this function, put the whole function in your theme functions.php file, then you can use the function like example given below

or, if you want to use this function together with an image resizer such as TimThumb or WordThumb, upload the required files from timthumb/wordthumb to your theme directory and use the following code instead

Putting it All Together: Full Source Code

For anyone who is having some trouble putting it all together. Here is the full source code (download from link at the top), ready to just paste into the functions.php file:


By now you should be able to use this function in any of your themes in supplement to (or instead of) using the_post_thumbnail(). If you have any additional suggestions or questions regarding custom images, feel free to leave a comment!