WordPress 函数：get_avatar()（获取头像）

get_avatar() 函数用来获取置顶邮箱或者用户的头像代码，在评论列表中非常常用。

这个函数提供一个 get_avatar 过滤器，用来过滤头像的 Html 代码（img 标签）。

如果在后台 “设置” 的 “讨论” 里关闭 “显示头像选项” 则返回 False.

用法

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

参数

$id_or_email

（整数 | 字符串 | 对象）（必须）用户的 ID；邮箱；评论或者用户的对象。如果在循环中可以使用 get_the_author_meta( 'ID' ) 函数调用当前文章的作者。

默认值：None

$size

（整数）（可选）头像的尺寸，最大为 512，单位为像素（px）。

默认值：96

$default

（字符串）（可选）如果没有头像返回的图片，默认为 “神秘人”，可以是图片 URL.

默认值：空字符串（神秘人）

$alt

（字符串）（可选）头像 img 标签的 alt 属性内容。

默认值：False

返回值

（字符串 | 布尔）返回一个头像的 img 标签，如果在后台 “设置” 的 “讨论” 里关闭 “显示头像选项” 则返回 False.

例子

评论列表：

<?php echo get_avatar( $GLOBALS['comment'] ); ?>

循环，获取当前文章作者头像：

<?php echo get_avatar( get_the_author_meta( 'ID' ), 32 ); ?>

自定义邮箱：

<?php echo get_avatar( 'email@example.com', 32, '', '自定义邮箱' ); ?>

其它

此函数位于：wp-includes/pluggable.php