如何为WordPress文章中的所有图片附件添加img-fluid类？

嘿，这个需求特别实用（尤其是用Bootstrap做响应式布局的时候对吧？），给你分享两个靠谱的实现思路，按需选择就行：

方法一：用附件图片属性过滤器（精准推荐） #

WordPress自带了wp_get_attachment_image_attributes过滤器，专门用来修改附件图片的HTML属性，这是最精准的方式，不会影响到非附件的图片。

把下面的代码添加到你的主题（或子主题）的functions.php文件里：

add_filter( 'wp_get_attachment_image_attributes', 'add_img_fluid_class_to_attachments', 10, 3 );
function add_img_fluid_class_to_attachments( $attrs, $attachment, $size ) {
    // 定义需要排除的缩略图尺寸，可根据你的需求调整
    $exclude_thumbnail_sizes = array( 'thumbnail', 'medium' );
    
    // 只给非缩略图的附件图片添加img-fluid类
    if ( !in_array( $size, $exclude_thumbnail_sizes ) ) {
        // 处理已有class的情况，避免覆盖原有类
        if ( isset( $attrs['class'] ) ) {
            $attrs['class'] .= ' img-fluid';
        } else {
            $attrs['class'] = 'img-fluid';
        }
    }
    
    return $attrs;
}

代码说明： #

• 我们通过$size参数判断是否为缩略图，排除了thumbnail和medium尺寸（你可以根据自己的需求增减）。
• 会保留图片原有的类（比如size-full wp-image-xxx），只是追加img-fluid，完全符合你的需求。

方法二：过滤文章内容（兼容自定义场景） #

如果你的网站有一些自定义的图片输出逻辑，第一种方法没覆盖到，可以试试通过the_content过滤器直接处理文章内容里的图片标签：

add_filter( 'the_content', 'add_img_fluid_to_post_content_images' );
function add_img_fluid_to_post_content_images( $content ) {
    // 正则匹配带有wp-image-*标识的附件图片，排除缩略图的size-thumbnail类
    return preg_replace( '/<img class="(?!size-thumbnail)([^"]+)wp-image-\d+/', '<img class="$1img-fluid ', $content );
}

注意事项： #

• 这个正则会匹配所有带wp-image-xxx类的图片（这是WordPress附件图片的特征），同时排除了缩略图的size-thumbnail类。
• 如果需要排除更多缩略图尺寸（比如size-medium），可以修改正则里的(?!size-thumbnail)为(?!size-thumbnail|size-medium)。

重要提醒： #

• 建议使用子主题添加代码，避免主题更新时丢失自定义代码。
• 修改完代码后，记得清理网站缓存（如果用了缓存插件），才能看到效果。

内容的提问来源于stack exchange，提问作者Nimesh