参数
- $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' ) ); ?>
注意：似乎所有参数都必须存在，否则它将不起作用。