Default Featured Image



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


  • 媒体页面上的设置
  • 媒体管理器将从当前选择的图像开始


  1. 将文件夹解压缩到 /wp-content/plugins/ 目录
  2. 通过WordPress的“插件”菜单激活插件
  3. 转到“设置” -> “媒体” 页,然后选择一个图像。



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


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

Can I set a different image for a custom post type?

Yes, the following code will set a different image.

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

    return $dfi_id; // the original featured image id.

Can I set different images per category?

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

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

    return $dfi_id; // the original featured image id.

Can I change the HTML of the default featured image?

When a Default Featured Image is used it will already add an extra class default-featured-img.
This 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 );
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 );

Can I exclude one page from having a Default Featured Image?

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

add_filter( 'dfi_thumbnail_id', 'dfi_skip_page', 10, 2 );
function dfi_skip_page( $dfi_id, $post_id ) {
    if ( $post_id == 23 ) {
        return 0; // invalid id.

    return $dfi_id; // the original featured image id.


2024 年 3 月 14 日
Default featured image does what it’s supposed to do and it meets two criteria I always look for: light weight it just works The support forum has good answers to questions, and that’s a big plus.Thanks for the great plugin.
2024 年 1 月 12 日 1 回复
Es perfecto porque hay una opción que te pone automáticamente la imagen destacada de todos los post que no la tenían cogiendo la primera imagen del post y si no hay imagen lo deja vacío. Perfecto!!
2023 年 7 月 31 日
Great plugin that does exactly what it claims to do. I have a client site that is using Elementor and it doesn’t allow you to specify a default image on the Blog Archive. This plugin resolved that issue, allowing you to specify a default Featured Image. Thanks for creating such a useful plugin 👍👍


“Default Featured Image” 是开源软件。 以下人员对此插件做出了贡献。


「Default Featured Image」插件已被翻译至 12 种本地化语言。 感谢所有译者为本插件所做的贡献。

将“Default Featured Image”翻译成您的语言。





  • 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.

  • Development is now done in git.


  • Added extra context to a translation as suggested by Alex Lion


  • Fixed weird SVN deployment bug.


  • 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.


  • 未指定meta_key的 get_post_meta($ post_id)找不到DFI。现在,它甚至将使用更深的级别并将其设置在核心缓存中。


  • 修复了阻止安装的插件标头。


  • 插件现在遵循WP编码标准
  • 修复了一个小错误,该错误导致DFI覆盖附件的特色图像。 mp3默认情况下具有音乐音符,DFI不应覆盖该音符。


  • 小自述文件 readme.txt 更新。


  • 在上次修复中,并不能解决所有情况。


  • 修复了两个小(罕见)警告
  • 添加了翻译域


  • 添加了插件图像,将插件标头都作为缩略图。基于 在其主题预览中使用的boat
  • 修复了ajax调用未返回DFI的错误论坛线程


  • 过滤器 dfi_thumbnail_id 现在还返回正在调用的帖子(或任何postype)的帖子ID。有关新示例,请参见常见问题解答


  • 现在在更早的阶段调用了过滤器 dfi_thumbnail_id


  • 修复了图像的继承类


  • 插件现在将删除它在插件删除时的设置
  • <;img>;标记中添加了默认类(如果它显示默认的特色图像)
  • 现在,默认的特色图片也将返回 get_post_thumbnail_id ,从而使失败的可能性大大减小。
  • 媒体页面中给出的图像现已验证


  • 启动