{"name":"Default Featured Image","slug":"default-featured-image","version":"1.7.3","author":"Jan Willem Oostendorp","author_profile":"https://profiles.wordpress.org/janwoostendorp/","requires":"6.2","tested":"6.6.2","requires_php":"7.4","requires_plugins":[],"rating":98,"ratings":{"1":1,"2":0,"3":1,"4":2,"5":59},"num_ratings":63,"support_threads":1,"support_threads_resolved":0,"downloaded":412264,"last_updated":"2024-09-12 1:53pm GMT","added":"2012-12-25","homepage":"http://wordpress.org/extend/plugins/default-featured-image/","sections":{"description":"

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.

Take a look at FAQ for the basic questions.
\nFeel free to contact me on the forum or on the github repository.

\n","installation":"

Unzip the folder to the /wp-content/plugins/ directory
Activate the plugin through the ‘Plugins’ menu in WordPress
Go to the settings->media page and select an image.

\n","faq":"\n

\nMy chosen featured image doesn’t show, why isn’t it working?\n\n

This plugin works out of the box for most cases, but not always. If it doesn’t work you can try the following things.

Switch themes. Most of the time the theme does something weird.
Are you using the Core WordPress functions to get the image? (see the FAQ below this one).
Do normal feature images work?
Might it be hidden via css? DFI images have an extra default-featured-img class added to them.

Still having problems? I want to know if it fails, so contact me

\nWhich functions can I use to display the featured image?\n\n

There are no new functions, all core WordPress functions can be used.

the_post_thumbnail / get_the_post_thumbnail Display the image.
the_post_thumbnail_url / get_the_post_thumbnail_url Get the url.
has_post_thumbnail If a DFI is set it will always return true.
get_post_thumbnail_id will return the ID set on the post or the DFI.

\nCan I set a different image for a custom post type?\n\n

Yes, the following code will set a different image.

add_filter( 'dfi_thumbnail_id', 'dfi_posttype_book', 10, 2 );\nfunction dfi_posttype_book( $dfi_id, $post_id ) {\n    $post = get_post( $post_id );\n    if ( 'book' === $post->post_type ) {\n        return 31; // the image id for the book post type.\n    }\n\n    return $dfi_id; // the original featured image id.\n}\n

\nCan I set different images per category?\n\n

Yes, the following snippet will set different images based on the category.

add_filter( 'dfi_thumbnail_id', 'dfi_category', 10, 2 );\nfunction dfi_category( $dfi_id, $post_id ) {\n    // Set a different image for posts that have the 'cats' category set.\n    // This will trigger first, if multiple categories have been set.\n    if ( has_category( 'cats', $post_id ) ) {\n        return 7; // cats img id.\n    }\n    // Set a different image for posts that have the 'cats' category set.\n    if ( has_category( 'dogs', $post_id ) ) {\n        return 8; // dogs img id.\n    }\n\n    return $dfi_id; // the original featured image id.\n}\n

\nCan I change the HTML of the default featured image?\n\n

When a Default Featured Image is used it will already add an extra class default-featured-img.
\nThis can be used for styling.

If you need more you can change the whole HTML with the filter dfi_thumbnail_html.

add_filter( 'dfi_thumbnail_html', 'dfi_add_class', 10, 5 );\nfunction dfi_add_class( $html, $post_id, $default_thumbnail_id, $size, $attr ) {\n    // Add a class to the existing class list.\n    $attr['class'] .= ' my-class';\n\n    return wp_get_attachment_image( $default_thumbnail_id, $size, false, $attr );\n}\n

\nCan I exclude one page from having a Default Featured Image?\n\n

The following code will exclude the post/page with ID 23.

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

\n\n","changelog":"

1.7.3

PHP 7.4 and WP 6.2 are now required. This is to use the new WP_HTML_Tag_Processor functions.
Fixed a bug where classes were overridden.

1.7.2.1

Development is now done in git.

1.7.2

Added extra context to a translation as suggested by Alex Lion

1.7.1

Fixed weird SVN deployment bug.

1.7.0

moved main class to it’s own file.
Added second class that can hold exceptions with other plugins
The first exception is for WP User Frontend
The second exception is for WP All Import.

1.6.4

get_post_meta($post_id) without specifying the meta_key didn’t find the DFI. It will now even use an even deeper level and set it in the core cache.

1.6.3

Fixed plugin header which blocked installing it.

1.6.2

Plugin now follows WP coding standard
Fixed a small bug where DFI overrides attachments featured images. mp3 has a music note by default, DFI should not override that.

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

\n","screenshots":"

$\"The$
The setting on the media page
$\"The$
The media manager will start with the current selected image

"},"download_link":"https://downloads.wordpress.org/plugin/default-featured-image.1.7.3.zip","screenshots":{"1":{"src":"https://ps.w.org/default-featured-image/assets/screenshot-1.png?rev=2771497","caption":"The setting on the media page"},"2":{"src":"https://ps.w.org/default-featured-image/assets/screenshot-2.png?rev=2771497","caption":"The media manager will start with the current selected image"}},"tags":{"image":"image","media":"media"},"versions":{"0.9":"https://downloads.wordpress.org/plugin/default-featured-image.0.9.zip","1.0":"https://downloads.wordpress.org/plugin/default-featured-image.1.0.zip","1.1":"https://downloads.wordpress.org/plugin/default-featured-image.1.1.zip","1.2":"https://downloads.wordpress.org/plugin/default-featured-image.1.2.zip","1.3":"https://downloads.wordpress.org/plugin/default-featured-image.1.3.zip","1.4":"https://downloads.wordpress.org/plugin/default-featured-image.1.4.zip","1.5":"https://downloads.wordpress.org/plugin/default-featured-image.1.5.zip","1.6":"https://downloads.wordpress.org/plugin/default-featured-image.1.6.zip","1.6.1":"https://downloads.wordpress.org/plugin/default-featured-image.1.6.1.zip","1.6.2":"https://downloads.wordpress.org/plugin/default-featured-image.1.6.2.zip","1.6.3":"https://downloads.wordpress.org/plugin/default-featured-image.1.6.3.zip","1.6.4":"https://downloads.wordpress.org/plugin/default-featured-image.1.6.4.zip","1.7.1":"https://downloads.wordpress.org/plugin/default-featured-image.1.7.1.zip","1.7.2":"https://downloads.wordpress.org/plugin/default-featured-image.1.7.2.zip","1.7.2.1":"https://downloads.wordpress.org/plugin/default-featured-image.1.7.2.1.zip","1.7.3":"https://downloads.wordpress.org/plugin/default-featured-image.1.7.3.zip","1.7.4-beta":"https://downloads.wordpress.org/plugin/default-featured-image.1.7.4-beta.zip","BP2":"https://downloads.wordpress.org/plugin/default-featured-image.BP2.zip","blueprint":"https://downloads.wordpress.org/plugin/default-featured-image.blueprint.zip","trunk":"https://downloads.wordpress.org/plugin/default-featured-image.zip"},"donate_link":"","icons":{"1x":"https://ps.w.org/default-featured-image/assets/icon-128x128.jpg?rev=1058491","2x":"https://ps.w.org/default-featured-image/assets/icon-256x256.jpg?rev=1058491"},"contributors":{"janwoostendorp":"https://profiles.wordpress.org/janwoostendorp/"}}

Default Featured Image

Screenshots

Categories

Get New Themes & Resources