WordPress中用于获取及自定义头像图片的PHP脚本详解

这篇文章主要介绍了WordPress中用于获取及自定义头像图片的PHP脚本编写方法,分别为get_avatar()和alt标签的使用,需要的朋友可以参考下。

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

get_avatar()（获取头像）

$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, '', '自定义邮箱' ); ?>

自定义头像图片的 alt 标签

WordPress 默认使用的是 Gravatar 头像，通过 get_avatar() 函数调用，一般用来在调用评论的时候使用。

利用 get_avatar() 函数的第四个属性 $alt 可以设置返回代码的 alt 标签，但是大多数人在使用的时候都不会去设置，也就变成了空白。

搜索引擎的爬虫是无法读取图片上到底是什么内容的，只能靠它的 alt 标签，没有了 alt 标签的图片，对 SEO 是非常不好的。

如果想要给所有的头像都统一加上一个 alt 标签，可以把下边的代码放到主题的 functions.php（了解更多） 文件。

1. /** 
2.   *WordPress 自定义头像图片的 alt 标签 
3.   *根据不同的人生成不同的 alt 标签 
4.   *http://www.endskin.com/avatar-alt/ 
5. */ 
6. function Bing_avatar_alt( $avatar ){ 
7.   $alt = 'Gravatar 头像';//alt 标签的内容 
8.   $before = strpos( $avatar, "alt='" ); 
9.   $after = strpos( $avatar, "'", $before ); 
10.   if( $before === false || $after === false ) return $avatar; 
11.   $alt = esc_attr( $alt ); 
12.   return substr( $avatar, 0, $before ) . "alt='$alt" . substr( $avatar, $after + strlen( "'" ) ); 
13. } 
14. add_filter( 'get_avatar', 'Bing_avatar_alt' ); 

这样就行了，注意修改代码里的 $alt 变量为你要修改成的 alt 标签内容。

根据不同的人生成不同的 alt 标签

如果要根据不同的人放置不同的 alt 标签可以用下边的例子代码：

1. /** 
2.   *WordPress 自定义头像图片的 alt 标签 
3.   *http://www.endskin.com/avatar-alt/ 
4. */ 
5. function Bing_avatar_alt( $avatar, $id_or_email ){ 
6.   if( $id_or_email == 'bingoblog@163.com' || $id_or_email === 1 ){ 
7.     $alt = '博主 Gravatar 头像';//博主的 alt 标签内容 
8.   }else{ 
9.     $alt = 'Gravatar 头像';//普通访客的 alt 标签内容 
10.   } 
11.   $before = strpos( $avatar, "alt='" ); 
12.   $after = strpos( $avatar, "'", $before ); 
13.   if( $before === false || $after === false ) return $avatar; 
14.   $alt = esc_attr( $alt ); 
15.   return substr( $avatar, 0, $before ) . "alt='$alt" . substr( $avatar, $after + strlen( "'" ) ); 
16. } 
17. add_filter( 'get_avatar', 'Bing_avatar_alt', 10, 2 ); 

如果已经设置 alt 标签则不替换

如果你需要在已经设置 alt 标签的内容（get_avatar() 函数的 $alt 属性）则不替换的时候可以用下边的代码：

1. /** 
2.   *WordPress 自定义头像图片的 alt 标签 
3.   *如果已经设置 alt 标签则不替换 
4.   *http://www.endskin.com/avatar-alt/ 
5. */ 
6. function Bing_avatar_alt( $avatar, $id_or_email, $size, $default, $alt ){ 
7.   if( !emptyempty( $alt ) ) return $avatar; 
8.   $alt = 'Gravatar 头像';//alt 标签的内容 
9.   $before = strpos( $avatar, "alt='" ); 
10.   $after = strpos( $avatar, "'", $before ); 
11.   if( $before === false || $after === false ) return $avatar; 
12.   $alt = esc_attr( $alt ); 
13.   return substr( $avatar, 0, $before ) . "alt='$alt" . substr( $avatar, $after + strlen( "'" ) ); 
14. } 
15. add_filter( 'get_avatar', 'Bing_avatar_alt', 10, 5 );