WordPress中Ultimate Member插件实现用户头像按用户名重命名

实现步骤 #

1. 替换头像显示URL #

通过Ultimate Member提供的钩子，直接替换页面上显示的头像链接为目标格式。你可以把以下代码添加到主题的functions.php文件，或者使用Code Snippets插件（更安全，适合新手，避免主题更新丢失代码）：

// 替换Ultimate Member头像显示URL为固定格式
add_filter( 'um_get_user_avatar_url', 'custom_um_avatar_url', 10, 2 );
function custom_um_avatar_url( $original_url, $user_id ) {
    $user = get_user_by( 'id', $user_id );
    if ( $user ) {
        // 替换成你的目标路径，自动用用户名替换占位符
        return 'http://example.com/img/' . $user->user_login . '.png';
    }
    // 若获取用户信息失败，返回原URL
    return $original_url;
}

2. 同步修改上传头像的文件名（可选但建议） #

上面的代码仅修改显示的URL，若希望实际存储的头像文件名也和用户名一致，添加以下代码，确保用户上传头像时自动重命名为用户名.png：

// 修改Ultimate Member上传头像的文件名
add_filter( 'um_upload_image_name', 'custom_um_avatar_filename', 10, 3 );
function custom_um_avatar_filename( $original_filename, $file, $upload_dir ) {
    $current_user_id = get_current_user_id();
    if ( $current_user_id ) {
        $user = get_user_by( 'id', $current_user_id );
        return $user->user_login . '.png';
    }
    return $original_filename;
}

注意事项 #

• 优先用Code Snippets插件管理自定义代码，避免直接修改主题functions.php导致网站故障或代码丢失
• 确保http://example.com/img/目录存在且有读写权限，否则头像上传或显示可能异常
• 如果用户后续修改用户名，头像文件名不会自动同步，若需要此功能可额外添加用户名变更的钩子处理

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