WordPress 纯代码实现用户显示随机头像（替代 Gravatar）

2020-05-10 · Ryan · 发表评论

WordPress 默认使用 Gravatar 全球头像服务，但其加载速度受网络环境影响，可能导致页面加载缓慢。虽然使用 SSL 线路或缓存插件可以部分缓解，但对于没有设置 Gravatar 头像的用户，系统会显示一个默认的灰色头像，美观度欠佳。

本文将介绍一种纯代码方案，通过本地随机头像来替代 Gravatar，提升加载速度并改善默认头像的视觉效果。

功能实现代码

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

add_filter( 'get_avatar', 'custom_local_random_avatar', 1, 5 );

function custom_local_random_avatar( $avatar, $id_or_email, $size, $default, $alt ) {
    // 初始化头像路径变量
    $avatar_url = '';

    // 判断是否为管理员（通过用户ID判断，此处假设管理员ID为1）
    $user_id = 0;
    if ( is_numeric( $id_or_email ) ) {
        $user_id = (int) $id_or_email;
    } elseif ( is_object( $id_or_email ) && ! empty( $id_or_email->user_id ) ) {
        $user_id = (int) $id_or_email->user_id;
    } elseif ( is_string( $id_or_email ) && ( $user = get_user_by( 'email', $id_or_email ) ) ) {
        $user_id = $user->ID;
    }

    // 设置头像路径
    if ( $user_id === 1 ) { // 管理员显示特定头像
        $avatar_url = get_template_directory_uri() . '/avatar/admin.jpg';
    } else { // 其他用户显示随机头像
        $random_number = mt_rand( 1, 10 ); // 随机数范围对应图片数量
        $avatar_url = get_template_directory_uri() . '/avatar/' . $random_number . '.jpg';
    }

    // 构建并返回头像的 HTML 标签
    $avatar = "<img alt='" . esc_attr( $alt ) . "' src='" . esc_url( $avatar_url ) . "' class='avatar avatar-{$size} photo' height='{$size}' width='{$size}' />";
    return $avatar;
}

代码说明与配置

核心逻辑

代码通过 WordPress 的 get_avatar 过滤器钩子，替换默认的头像获取逻辑。
函数会判断当前头像请求是否针对管理员（示例中管理员用户ID为1）。如果是，则返回固定的 admin.jpg；否则，从1到10中随机选择一个数字，返回对应的 [数字].jpg 图片。
代码中已包含更健壮的用户身份判断逻辑，兼容用户ID、评论对象或邮箱地址等多种传入参数。

图片准备

在当前使用的 WordPress 主题根目录下，创建一个名为 avatar 的文件夹。
在该文件夹内，准备10张用作随机头像的图片，将其命名为 1.jpg, 2.jpg, ..., 10.jpg。
同时，准备一张用于管理员的专属头像，命名为 admin.jpg。

注意：所有图片建议使用正方形尺寸，并确保它们已针对网站性能进行过优化（压缩）。

自定义调整

随机图片数量：修改代码中 mt_rand( 1, 10 ) 的数字 10，以匹配你实际准备的图片数量。
管理员判断条件：示例中通过 $user_id === 1 判断管理员。如果你的网站有多个管理员或管理员ID不是1，需要修改此条件，例如使用 current_user_can( 'manage_options' ) 进行角色能力判断会更通用。
图片格式：代码默认使用 .jpg 格式。如果你的图片是 PNG 或 WebP 格式，请相应修改代码中的文件扩展名。

效果与注意事项

启用此功能后：

所有未设置 Gravatar 头像的访客、注册用户（非管理员）在评论或用户资料处将看到随机分配的头像。
管理员（或你指定的特定用户）将始终看到固定的 admin.jpg 头像。
此方法完全绕过了 Gravatar 服务，因此能显著提升头像加载速度，并消除因 Gravatar 不可访问导致的头像缺失问题。

重要提示：在对主题文件进行任何修改前，请务必备份。建议使用子主题的 functions.php 文件添加代码，以避免主题更新时被覆盖。