参数
- $id_or_email
-
(mixed)(必填) 要检索的Gravatar。接受user_id、gravatar md5哈希、用户电子邮箱、WP_User对象、WP_Post对象或WP_Comment对象。
- $size
-
(int)(可选) 头像图片文件的高度和宽度(像素)。
默认值: 96
- $default
-
(string)(可选) 默认图片的URL或默认类型。接受'404'(返回404而不是默认图像)、'retro'(8bit)、'monsterid'(怪物)、'wavatar'(卡通人脸)、'indenticon'(“被子”)、'mystery'、'mm'或'mysteryman'(牡蛎人)、'blank'(透明GIF)或'gravatar_default'(Gravatar logo)。默认值是'avatar_default'选项的值,备用选项'mystery'。
默认值: ''
- $alt
-
(string)(可选) img标签中使用的替代文本。
默认值: ''
- $args
-
(array)(可选) 检索头像的额外参数。
- 'height'
(int) 以像素为单位显示头像的高度。默认为$size。 - 'width'
(int) 以像素为单位显示头像的宽度。默认为$size。 - 'force_default'
(bool) 是否总是显示默认图像,而不是Gravatar。默认值为false。 - 'rating'
(string) 显示头像的等级是多少。接受'G'、'PG'、'R'、'X',并按该顺序进行判断。默认值是'avatar_rating'选项的值。 - 'scheme'
(string) 要使用的URL方案。可接受值见set_url_scheme()。 - 'class'
(array|string) 要添加到img元素的附加类的数组或字符串。 - 'force_display'
(bool) 是否总是显示头像- 忽略show_avatars选项。默认值为false。
- 'loading'
(string)loading
属性的值。 - 'extra_attr'
(string) 要插入IMG元素中的HTML属性。未清理。默认为空。
默认值: null
- 'height'
返回
(string|false) 用户头像的<img>
标签。失败时为False。
源码
更新日志
版本 | 描述 |
---|---|
4.2.0 | 添加了可选的$args 参数。 |
2.5.0 | 开始引入 |
使用示例
文章作者的示例,在循环中。
<?php echo get_avatar( get_the_author_meta( 'ID' ), 32 ); ?>
如果此功能没有为您返回任何信息,请转至 设置 > 讨论 并确保选中了显示头像。
评论示例。
<?php echo get_avatar( $comment, 32 ); ?>
随机电子邮件地址示例。
<?php echo get_avatar( 'email@example.com', 32 ); ?>
class属性示例:
<?php echo get_avatar( get_the_author_meta( 'ID' ), $size = '60', $default = '', $alt = '', $args = array( 'class' => 'wt-author-img' ) ); ?>
注意:似乎所有参数都必须存在,否则它将不起作用。