get_avatar() | WordPress获取Gravatar头像

作者猫斯基 2015-02-24 150 人读过

最新文章

函数

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://maosiji.com/wp-content/uploads/2020/01/default.jpeg" class="avatar avatar-50 photo boke leon" title="WordPress迷" height="56" width="56">

本文由 猫斯基 原创发布。

著作权均归用户本人所有。独家文章转载,请联系本站管理员。获得授权后,须注明本文地址! 本文地址:https://maosiji.com/wordpress/wordpress-get_avatar.html