WordPress获取用户头像函数:gravatar

这个函数几乎所有的主题都需要,主要是获取文章作者头像、评论用户头像、指定用户头像,在获取用户头像的img标签,同时可以指定图像的大小、默认头像以及头像图片的alt属性值。

函数

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

返回值:成功返回HTML<img>标签,失败返回false。

实例

获取文章作者头像(主循环中使用)

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

获取指定ID用户头像

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

获取指定邮箱头像

<?php echo get_avatar('email@example.com',50); ?>

全部参数

<?php $getavatar = get_avatar(get_the_author_meta('email'),50,'','alt参数',array('width'=>56,'height'=>56,'rating'=>'X','class'=>array('test','xx-blog'),'extra_attr'=>'title="title参数"','scheme'=>'http') );
echo $getavatar;
?>

 

相关文章

我想将wordpress的默认接口路由改掉,愿意是默认的带一个 wp...
wordpress自定义分类法之后,我看到链接都自动在后面添加了一...
事情是这样的,我用 get_post_type 函数创建了一个自定义分类...
最近网站莫名其妙的被顶上了,过一个多小时,就注册一个账号...
最近服务器要到期了,就想着把网站转移到另外一台服务器,本...
今天在写wordpress的接口,然后碰到个奇怪的问题,怎么访问都...