WordPress多作者站点：为文章作者替换Gravatar为本地头像

我来帮你修复这段没生效的代码，原代码存在几个关键问题，我会逐一说明并给出完整的修复版本：

原代码的核心问题 #

• 变量名错误：返回的$get_avatar是未定义的变量，应该返回处理后的$avatar或者自定义生成的头像HTML
• 判断逻辑局限：只检查当前登录用户是否是文章作者，但你的需求是所有场景下显示文章作者的本地头像（不管浏览者是谁），而且没覆盖评论作者的场景
• 使用过时函数：get_currentuserinfo()已经被WordPress弃用，应该改用更安全的用户获取方式
• 未正确解析参数：$id_or_email可能是用户ID、邮箱或WP_User对象，原代码没做统一解析，导致无法准确获取用户ID
• 路径函数过时：get_bloginfo('template_directory')推荐替换为get_template_directory_uri()
• 直接返回路径无效：需要生成符合WordPress规范的img标签，而不是单纯的图片URL

修正后的完整代码 #

add_filter('get_avatar', 'custom_author_local_avatar', 99, 5);
function custom_author_local_avatar($avatar, $id_or_email, $size, $default, $alt) {
    // 统一解析传入的ID/邮箱/用户对象，获取用户ID
    $user_id = 0;
    if (is_numeric($id_or_email)) {
        $user_id = (int)$id_or_email;
    } elseif (is_object($id_or_email)) {
        if (!empty($id_or_email->user_id)) {
            $user_id = (int)$id_or_email->user_id;
        } elseif (!empty($id_or_email->ID)) {
            $user_id = (int)$id_or_email->ID;
        }
    } elseif (is_string($id_or_email) && is_email($id_or_email)) {
        $user = get_user_by('email', $id_or_email);
        if ($user) {
            $user_id = $user->ID;
        }
    }

    if (!$user_id) {
        // 无法获取有效用户ID，直接返回原头像
        return $avatar;
    }

    // 判断当前场景，获取需要替换头像的目标作者ID
    $target_author_id = 0;
    global $post, $comment;

    // 文章详情页：获取当前文章的作者ID
    if (isset($post) && is_singular('post')) {
        $target_author_id = $post->post_author;
    }
    // 评论区域：获取当前评论的作者ID
    elseif (isset($comment) && is_object($comment)) {
        $target_author_id = $comment->user_id;
    }
    // 作者档案页：获取当前页面对应的作者ID
    elseif (is_author()) {
        $target_author_id = get_queried_object_id();
    }

    // 如果当前要显示的头像属于目标作者，替换为本地头像
    if ($user_id === $target_author_id) {
        // 获取用户信息，用用户slug生成头像文件名
        $user = get_userdata($user_id);
        $author_slug = $user->user_nicename;
        // 本地头像路径：主题目录下的images文件夹，命名格式为author-{slug}.png
        $local_avatar_url = get_template_directory_uri() . '/images/author-' . $author_slug . '.png';
        
        // 生成符合WordPress标准的头像HTML结构
        $avatar = sprintf(
            '<img alt="%s" src="%s" class="avatar avatar-%d photo" height="%d" width="%d" />',
            esc_attr($alt),
            esc_url($local_avatar_url),
            $size,
            $size,
            $size
        );
    }

    // 返回处理后的头像（非目标作者则返回原Gravatar头像）
    return $avatar;
}

代码关键说明 #

1. 优先级设置为99：确保我们的过滤器在WordPress默认的头像处理逻辑之后运行，保证能覆盖原有输出
2. 全面兼容参数：处理$id_or_email的所有可能类型，准确获取用户ID
3. 覆盖三个核心场景：文章详情页的作者头像、评论区的作者评论头像、作者档案页的头像
4. 动态文件名：根据用户的slug生成头像文件名（比如用户slug是jane-smith，对应的头像文件是author-jane-smith.png），方便批量管理
5. 标准HTML结构：生成和原生Gravatar一致的img标签，避免破坏主题的头像样式

使用注意事项 #

• 确保你的主题目录下存在images文件夹，并且已经上传了对应作者的头像文件，命名严格遵循author-{用户slug}.png格式
• 如果需要使用JPG等其他格式，直接修改代码中的文件后缀即可
• 如果要调整头像存放路径，修改$local_avatar_url中的路径部分

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