get_avatar() 是 WordPress 默认获取的 Gravatar 头像的函数,函数通过用户 ID 或邮件地址获取用户头像,同时如果要正确显示头像需要将设置/讨论面板下的“显示头像”给勾选上。该函数的定义位于 wp-includes 文件夹下的 pluggable.php 中,相关代码如下:
使用 get_avatar() 函数
对于 get_avatar() 函数的使用我们一般可以通过以下方式调用:
$id_or_email:必填(整型/字符串/对象)。用户 ID 、邮件地址或者评论区评论对象。
$size:选填(整型)。要返回的 Gravatar 头像的大小,最大为 512 默认 96 。
$default:选填(字符串)。自定义的默认头像地址,默认“神秘人物”头像。
$alt:选填(字符串)。img 标签的 alt 属性值,图像的替换文本,默认为空。
$args:选填(数组)。设置新的参数以替换 get_avatar中 的默认参数。
$args 可设置的参数
如果要设置新的参数以替换 get_avatar中 的默认参数,必须在调用 get_avatar 之前声明新的参数,否则它们将不会生效。以下参数均为可选参数,由于使用较少,此处仅简单说下,具体内容请参阅文后官方文档!
size(整型、大小)、height(整型、高度)、width(整型、宽度)、default(字符串、默认头像)、force_default(布尔型、强制使用默认头像)、rating(字符串、头像等级 ‘G’, ‘PG’, ‘R’, ‘X’)、scheme(字符串,设置 URL 的 Scheme)、class(数组或字符串,设置 img 标签的 class 属性)、force_display(布尔型、是否强制显示 Gravatar 头像即使未勾选“显示头像”)、extra_attr(字符串,设置头像的 attributes 属性)。
官方文档:https://codex.wordpress.org/Function_Reference/get_avatar