首页 / WordPress开发 / get_avatar(); [获取gravatar头像函数]

get_avatar(); [获取gravatar头像函数]

发布于 2022.04.11

推荐 0
浏览 239

get_avatar()是wordpress内置用来获取指定用户id或者邮箱头像的函数，通过get_avata…

get_avatar()是wordpress内置用来获取指定用户id或者邮箱头像的函数，通过get_avatar()函数可以轻易地获取文章作者头像、评论用户头像、指定用户头像，在获取用户头像的同时可以指定图像的大小、默认头像以及头像图片的alt属性值。
函数位于：wp-includes/pluggable.php

函数结构

1	get_avatar( mixed $id_or_email, int $size = 96, string $default = ”, string $alt = ”, array $args = null )

参数说明：

$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，默认为空

示例：

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

1	<?php echo get_avatar(get_the_author_meta(’email’), 50); ?>

2、获取指定ID用户头像

1	<?php echo get_avatar(1, 50); ?>

3、获取指定邮箱头像

1	<?php echo get_avatar(‘[email protected]’, 50); ?>

4、完整参数：

<?php

$getavatar = get_avatar(get_the_author_meta(’email’),50,”,‘博客吧教程’,array(‘width’=>56,‘height’=>56,‘rating’=>‘X’,‘class’=>array(‘boke8’,‘leonhere’),‘extra_attr’=>‘title=”博客吧教程”‘,‘scheme’=>‘http’) );

echo $getavatar;

生成的HTML如下：

1	<img alt=‘博客吧教程’ src=‘http://www.qianxingtech.com/wp-content/uploads/2019/07/admin_avatar-50×50.jpg’ class=‘avatar avatar-50 photo’ height=’50’ width=’50’ />