[站长原创]WordPress改变文章中图片的alt标签属性(SEO)

改变图片的alt属性可以带来多方面的好处‌：

1. ‌提升搜索引擎优化（SEO）‌：alt属性对于搜索引擎优化至关重要。搜索引擎无法直接识别图片内容，因此alt属性提供了图片的描述信息，帮助搜索引擎理解图片的主题和内容。这样，图片就能被搜索引擎收录，并在相关搜索结果中显示，从而增加网站的曝光率和流量‌。

2. ‌改善用户体验‌：当图片因为某些原因无法显示时，alt属性中的文字会替代图片显示。这避免了用户因为看不到图片而感到困惑，提供了更好的用户体验‌。

3. ‌增强页面优化效果‌：搜索引擎在评判页面质量时，图片的优化是一个重要因素。通过合理设置alt属性，可以提升页面的整体优化效果，进而影响网站的排名和流量‌。

‌具体应用场景和最佳实践‌：

• ‌与文章标题相符合‌：alt属性的内容应与文章标题或其所描述的内容相符合，确保搜索引擎和用户都能准确理解图片的主题‌3。
• ‌避免关键词堆砌‌：在设置alt属性时，应避免关键词的堆砌，保持内容的自然和相关性‌。
• ‌增加title标签‌：对于一些无法直观表达的图片，可以配合title标签使用，进一步解释图片内容，提升用户体验‌

操作方法如下

将以下代码添加到 主题文件下的functions.php 文件中：

function update_image_alt_to_post_title($post_id) {
    if (wp_is_post_revision($post_id)) {
        return;
    }

    $post = get_post($post_id);
    if (!$post || $post->post_type !== 'post') {
        return;
    }

    $post_title = esc_attr($post->post_title);
    $post_content = $post->post_content;

    // 使用正则匹配 img 标签
    $updated_content = preg_replace_callback(
        '/<img([^>]+)alt=["']([^"']*)["']([^>]*)>/i',
        function ($matches) use ($post_title) {
            return '<img' . $matches[1] . 'alt="' . $post_title . '"' . $matches[3] . '>';
        },
        $post_content
    );

    if ($updated_content !== $post_content) {
        // 更新文章内容
        remove_action('save_post', 'update_image_alt_to_post_title');
        wp_update_post([
            'ID' => $post_id,
            'post_content' => $updated_content
        ]);
        add_action('save_post', 'update_image_alt_to_post_title');
    }
}

add_action('save_post', 'update_image_alt_to_post_title');

上面的代码仅针对新发布文章有效，如果处理已发布文展，需要执行以下脚本代码

1、在 WordPress 主题目录（wp-content/themes/你的主题）下创建一个新文件，比如 update-alt.php。

2、在文件中添加以下代码：

<?php
require_once('../../../wp-load.php'); // 适用于大多数 WordPress 站点

$posts = get_posts([
    'post_type'   => 'post',
    'post_status' => 'publish',
    'numberposts' => -1
]);

$updated_count = 0; // 记录修改的文章数量

foreach ($posts as $post) {
    $post_title = esc_attr($post->post_title);
    $post_content = $post->post_content;

    $updated_content = preg_replace_callback(
        '/<img([^>]+)alt=["']([^"']*)["']([^>]*)>/i',
        function ($matches) use ($post_title) {
            return '<img' . $matches[1] . 'alt="' . $post_title . '"' . $matches[3] . '>';
        },
        $post_content
    );

    if ($updated_content !== $post_content) {
        wp_update_post([
            'ID'           => $post->ID,
            'post_content' => $updated_content
        ]);
        $updated_count++;
        echo "已更新文章：" . esc_html($post->post_title) . "<br>";
    }
}

// 输出最终的成功提示
if ($updated_count > 0) {
    echo "<br><strong>✅ 所有文章的图片 alt 已成功修改，共修改 $updated_count 篇文章！</strong>";
} else {
    echo "<br><strong>ℹ️ 没有需要修改的文章，所有 alt 标签已符合要求！</strong>";
}
?>

3、访问 https://你的站点.com/wp-content/themes/你的主题/update-alt.php 运行此脚本，执行完后删除文件。