How to display a default image for post thumbnail using functions.php?

I want to display a default featured image if there hasn’t been one set. I googled for a solution and all I could find was this piece of code (below). My question is, is there a way of displaying a default image by writing a function inside the functions.php? I don’t want to repeat myself with the code.

<?php if ( has_post_thumbnail() ) {
the_post_thumbnail();
} else { ?>
<img src="<?php bloginfo('template_directory'); ?>/images/default-image.jpg" alt="<?php the_title(); ?>" />
<?php } ?>

Answers:

Thank you for visiting the Q&A section on Magenaut. Please note that all the answers may not help you solve the issue immediately. So please treat them as advisements. If you found the post helpful (or not), leave a comment & I’ll get back to you as soon as possible.

Method 1

The relevant code is in wp-includes/post-thumbnail-template.php. The thumbnail ID is stored in post metadata as _thumbnail_id.

You could either

1. upload the default image to WordPress and make its ID the default thumbnail ID for any post that doesn’t have one:

   function default_post_metadata__thumbnail_id( $value, $object_id, $meta_key,
                                                 $single, $meta_type )
   {
       if ( '_thumbnail_id' == $meta_key )
       {
           $value = 123; // the ID for the default image
       }
       return $value;
   }
   add_filter( 'default_post_metadata', 'default_post_metadata__thumbnail_id', 10, 5 );

   This means that has_post_thumbnail() and get_the_post_thumbnail() will now find a thumbnail for the post even if one isn’t configured, and will just work as normal with the given ID, i.e. find the correct image size and generate the image tag for you etc.

   However I’d guess there’s a risk this ID would be saved into a post when you edit it,
   so you possibly want to only register the filter if if (! is_admin() ) {, i.e. on the front-end site only. And this does mean you’ll need to add the image to the media library, although it might be possible to fake that too e.g. by using ID -123 and hooking image_downsize_default_thumbnail to return an image for -123.

2. override the has_post_thumbnail filter to always return true, and override the post_thumbnail_html filter to fill in missing HTML if it returns an empty string.

   function default_post_thumbnail_html( $html ) {
       if ( $html == '' ) {
           return sprintf("<img src="%s" alt="%s" />",
               esc_url( bloginfo('template_directory') . '/images/default-image.jpg' ),
               esc_url( get_the_title() ) );
       }
       return $html;
   }
   add_filter( 'post_thumbnail_html', 'default_post_thumbnail_html', 10, 1 );
   add_filter( 'has_post_thumbnail', '__return_true' );

   This way you have to generate the <img> completely yourself, but this will let you use an image that doesn’t have an ID.

All methods was sourced from stackoverflow.com or stackexchange.com, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0