WordPress站点用PHP为现有图片添加alt属性失效问题求助

你之前在functions.php中添加的过滤器均只针对WordPress原生函数wp_get_attachment_image()输出的图片生效，但你提供的两段模板代码均为直接获取图片URL后手动拼接<img>标签，未触发对应过滤器逻辑，因此修改不生效。

方案1：使用原生WordPress函数输出图片（推荐） #

保留你现有的第一个过滤器函数（删除第二个参数和返回值都错误的addImageAlt函数），将模板中手动拼接图片的逻辑替换为原生函数调用：
比如品牌轮播的代码中，替换原有获取图片URL、拼接img标签的逻辑：

// 原有逻辑
$imgsrc=wp_get_attachment_image_src(get_post_thumbnail_id(), 'brand-thumb');
$brand_thumbnail= $imgsrc[0] != "" ?  $imgsrc[0] : get_template_directory_uri() . '/assets/images/default-music-icon.jpg';
$html.='<div class="slide-brand">
            <div class="brand-logo-thumbnail">
                <a href="'.get_permalink().'">
                    <img src='.$brand_thumbnail.' alt="'.basename($brand_thumbnail).'" title="'.get_the_title().'">
                </a>
            </div>
        </div>';

// 替换后逻辑
$html.='<div class="slide-brand">
            <div class="brand-logo-thumbnail">
                <a href="'.get_permalink().'">
                    '.wp_get_attachment_image( get_post_thumbnail_id(), 'brand-thumb' ).'
                </a>
            </div>
        </div>';

原生函数wp_get_attachment_image()会自动触发你写的wp_get_attachment_image_attributes过滤器，自动填充你设置的alt和title属性，同时还会自带srcset、width、height等优化属性，比手动拼接更符合WordPress开发规范。

方案2：直接修改手动拼接的alt属性取值 #

如果你不想调整现有输出逻辑，直接修改img标签中alt的取值逻辑即可，从附件的元数据中读取正确的alt值：

// 品牌轮播img标签修改示例，优先取后台设置的图片alt，无值则 fallback 到品牌名称
$img_id = get_post_thumbnail_id();
$alt = get_post_meta( $img_id, '_wp_attachment_image_alt', true );
$alt = $alt ? $alt : get_the_title();
$html.='<img src="'.$brand_thumbnail.'" alt="'.esc_attr($alt).'" title="'.esc_attr( get_the_title() ).'">

分类轮播的img标签同理，先拿到分类缩略图对应的附件ID，读取alt属性后替换现有的$term->slug即可，无值可以fallback到分类名称$term->name。

• 所有输出到HTML属性的内容都要用esc_attr()函数转义，避免XSS安全风险
• 你写的第二个addImageAlt函数参数和返回值均不符合wp_get_attachment_image过滤器的要求，建议直接删除，仅保留第一个isa_add_img_title函数即可

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