当前浏览:首页 / WordPress函数 / get_avatar()

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

检索用户、电子邮件地址、MD5哈希、评论或文章的头像标记

activation


参数

$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


返回

(string|false) 用户头像的<img>标签。失败时为False。



源码

查看源码 官方文档


更新日志

版本描述
4.2.0添加了可选的$args参数。
2.5.0开始引入

使用示例

  • 示例1

    文章作者的示例,在循环中。

    <?php echo get_avatar( get_the_author_meta( 'ID' ), 32 ); ?>
    
  • 示例2

    如果此功能没有为您返回任何信息,请转至 设置 > 讨论 并确保选中了显示头像。

  • 示例3

    评论示例。

    <?php echo get_avatar( $comment, 32 ); ?>
    
  • 示例4

    随机电子邮件地址示例。

    <?php echo get_avatar( 'email@example.com', 32 ); ?>
    
  • 示例5

    class属性示例:

    <?php
    echo get_avatar( get_the_author_meta( 'ID' ), $size = '60', $default = '', $alt = '', $args = array( 'class' => 'wt-author-img' ) ); 
    ?>

    注意:似乎所有参数都必须存在,否则它将不起作用。