get_avatar() | WordPress获取Gravatar头像

函数

get_avatar( $id_or_email, $size, $default, $alt, $args );

描述

WordPress 默认获取的 Gravatar 头像的函数，函数通过用户 ID 或邮件地址获取用户头像，同时如果要正确显示头像需要将【设置 – 讨论】下的“显示头像”给勾选上。

参数

• $id_or_email – （整数 | 字符串 | 对象）（必须），授受用户 ID、邮箱或用户的对像
• $size – （整数）（可选）指定头像的尺寸大小，单位为 px（像素），默认为 96（即 96px），最大 512
• $default – （字符串）（可选）如果用户没有设置 gravatar 头像，则返回 false，即没有头像返回，默认为 “神秘人”，可以指定图片 URL 作为默认头像
• $alt – （字符串）（可选）头像 img 标签的 alt 属性内容，默认 False
• $args – （数组）（可选）设置头像额外的参数，默认为空，可设置以下的参数：
  • ‘height’ – （整数）img 的 height 属性，默认使用 $size
  • ‘width’ – （整数）img 的 width 属性，默认使用 $size
  • ‘force_default’ – （布尔型）是否始终显示默认图像，默认 false
  • ‘rating’ – （字符串）头像的等级，可选’G’, ‘PG’, ‘R’, ‘X’，并按该顺序进行判断，默认是 wordpress 后台里设置——评论里设置的【最高等级】
  • ‘scheme’ – （字符串）使用的 URL 方案，可参与 set_url_scheme() 函数的参数值（’http’, ‘https’, ‘login’, ‘login_post’, ‘admin’, ‘relative’, ‘rest’, ‘rpc’），默认为空
  • ‘class’ – （数组|字符串）给 img 标签添加样式
  • ‘force_display’ – （布尔型）是否始终显示头像，忽略 wordpress 后台里设置——评论里设置的【头像显示】设置，默认为 false
  • ‘extra_attr’ – （字符串）插入 img 元素，如 alt、title，默认为空

返回值

划重点

实例

获取文章作者头像（主循环中使用）

echo get_avatar(get_the_author_meta('email'), 50);

获取指定 ID 用户头像

echo get_avatar(1, 50);

获取指定邮箱头像

echo get_avatar('email@example.com', 50);

完整参数

$getavatar = get_avatar(get_the_author_meta('email'),50,'','WordPress迷',array('width'=>56,'height'=>56,'rating'=>'X','class'=>array('boke8','leonhere'),'extra_attr'=>'title="WordPress迷"','scheme'=>'http') );
echo $getavatar;

生成的 HTML 如下：

<img alt="WordPress迷" src="https://www.maosiji.com/wp-content/uploads/sites/4/2020/01/default.jpeg" class="avatar avatar-50 photo boke leon" title="WordPress迷" height="56" width="56">