Default featured image

Omschrijving

Add a default featured image to the media settings page. This featured image will show up if no featured image is set. Simple as that.

For exceptions and to see which functions to use see the FAQ.

Suggestions are welcome

  • Een bug gevonden?
  • Want to help to translate it in your language?
  • Something to be improved?

Contact me

Schermafdrukken

  • The setting on the media page
  • The media manager will start with the current selected image

Installatie

  1. Unzip the folder to the /wp-content/plugins/ directory
  2. Activeer de plugin via het ‘Plugins’ menu in WordPress
  3. Go to the settings->media page and select an image.

FAQ

My chosen featured image doesn’t show, why isn’t it working?

This plugin can’t guarantee that it works. That depends on the themes. Still I want to know if it fails, so contact me

Which functions can I use to display the featured image?

The plugin uses the default WordPress functions the_post_thumbnail or get_the_post_thumbnail. has_post_thumbnail will always return true. get_post_thumbnail_id will return the ID set on the post or the DFI you set.

Can I exclude a page or give it a different image?

Yes you can by using the builtin dfi_thumbnail_id filter. It will give you the post id which you can use to check against.

Don’t use a featured image on page 23

function dfi_skip_page ( $dfi_id, $post_id ) {
  if ( $post_id == 23 ) {
    return 0; // invalid id
  }
  return $dfi_id; // the original featured image id
}
add_filter( 'dfi_thumbnail_id', 'dfi_skip_page', 10 , 2 );

Use a different image for some categories

The example below only works if the post has ‘animals’ as a category. Assigning just ‘cats’ won’t work
To do that just don’t nest the if

function dfi_category ( $dfi_id, $post_id ) {
  // all which have 'animals' as a category
  if ( has_category( 'animals', $post_id ) ) {

    //sub category
    if ( has_category( 'cats', $post_id ) ) {
      return 7; // cats img
    } else if has_category( 'dogs', $post_id ) {
      return 8; // dogs img
    }

    return 6; // default animals picture
  }
  return $dfi_id; // the original featured image id
}
add_filter( 'dfi_thumbnail_id', 'dfi_category', 10, 2 );

Different image for the post_type ‘wiki’

function dfi_posttype_book ( $dfi_id, $post_id ) {
  $post = get_post($post_id);
  if ( 'wiki' === $post->post_type ) {
    return 31; // the image id
  }
  return $dfi_id; // the original featured image id
}
add_filter( 'dfi_thumbnail_id', 'dfi_posttype_book', 10, 2 );
Can I change the HTML of the image returned?

yes you can with the filter dfi_thumbnail_html.

function dfi_add_class($html, $post_id, $default_thumbnail_id, $size, $attr) {
    // add a class to the existing class list
    $attr['class'] .= ' my-class';

    return wp_get_attachment_image( $default_thumbnail_id, $size, false, $attr );
}
add_filter( 'dfi_thumbnail_html', 'dfi_add_class', 10, 5 );

Beoordelingen

27 februari 2018
Absolutely love this little plugin, saved me a massive headache with my theme and site options. <3 Just activate and set the default image and away you go. Fits nicely with many other plugins I have active also.
20 december 2017
That didn't worked for me sir, I have installed your plugin on my https://www.atarehman.com & I want my picture to show when I want to share it on social media. But the featured images shows from a post, but not from what I have set via this plugin.
Lees alle 37 beoordelingen

Bijdragers & ontwikkelaars

“Default featured image” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

“Default featured image” is vertaald in 4 talen. Dank voor de vertalers voor hun bijdragen.

Vertaal “Default featured image” naar jouw taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

1.6.1

  • Small readme.txt update.

1.6

  • On of the last fixes didn’t account for all situations.

1.5

  • Fixed two small (and rare) warnings
  • Added translation domain

1.4

  • Added plugin images both the plugin header as the thumbnail. Based on the boat WP.org uses in it’s theme previews
  • Fixed a bug where the ajax calls didn’t return the DFI forum thread

1.3

  • Filter dfi_thumbnail_id now also returns the post ID of the post (or any postype) that is being called. See the FAQ for new examples

1.2

  • Filter dfi_thumbnail_id is now called in an earlier stage.

1.1

  • Fixed inheriting classes of the image

1.0

  • Plugin will now remove it’s setting on plugin removal
  • added a default class to the <img> tag, if it shows a default featured image
  • The default featured image will now also return with get_post_thumbnail_id, making the chance that it fail far far smaller.
  • The image given in the media page is now validated

0.9

  • Launch