WordPress模板函数wp_list_authors输出用户列表，并给出用户页面链接，默认以<li>列表输出。

wp_list_authors( string|array $args = '' )

函数参数

$args

数组或字符串值

wp_list_authors()函数$args参数默认的值如下：

$args = array(
	'orderby'		=> 'name', 
	'order'			=> 'ASC', 
	'number'		=> null,
	'optioncount'	=> false, 
	'exclude_admin'	=> true, 
	'show_fullname'	=> false,
	'hide_empty'	=> true,
	'echo'			=> true,
	'feed'			=> [empty string], 
	'feed_image'	=> [empty string],
	'feed_type'		=> [empty string],
	'style'			=> 'list',
	'html'			=> true,
	'exclude'		=> [empty string],
	'include'		=> [empty string]
);

wp_list_authors()函数$args参数可用的值如下：

orderby

字符串值，默认值：name

指定输出的用户列表以哪个字段排列顺序

• name：以users表display_name字段排列顺序，也就是用户资料“公开显示为”
• email：以用户邮件地址排列
• url：以用户网址排列
• registered：以注册日期排列
• id：以用户ID排列
• user_login：以用户登录账号排列
• post_count：以用户发表的文章数量排列

order

字符串值，默认值：ASC

指定输出的用户列表的排序方式

• ASC：升序
• DESC：降序

number

整数型

指定要输出的用户数量

optioncount

布尔值，默认值：false

是否显示作者发表的文章总数

• 1（true）：显示作者发表的文章总数
• 0（false）：不显示作者发表的文章总数

exclude_admin

布尔值，默认值：true

排除名称为“admin”的用户，只有用户资料设置中“公开显示为”的名称为“admin”才被排除

• 1（true）：排除“admin”用户
• 0（false）：不排除“admin”用户

show_fullname

布尔值，默认值：false

显示用户的姓名而不是用户资料设置“公开显示为”中指定的名称

• 1（true）：显示
• 0（false）：不显示，此时显示用户资料设置“公开显示为”中设定的名称

hide_empty

布尔值，默认值：true

是否隐藏没有发表过文章的用户

• 1（true）：隐藏
• 0（false）：显示

feed

字符串值，默认为空

提供一个文本作为用户feed链接的锚文本，默认不显示用户feed链接

feed_image

字符串值，默认为空

提供一个图片的路径作为用户feed链接图片，并且会覆盖feed的设置

feed_type

字符串值，默认为空

feed的类型，可选的值有：

• -：默认值
• rss2
• atom
• rss
• rdf

style

字符串值，默认值：list

输出用户列表的HTML函数类型

• list：以<li>列表输出，不包括<ul>函数
• none：只输出链接，没有<li>函数，每个链接之间用逗号分隔

html

布尔值，默认值：true

是否输出HTML函数，如果为false，只输出文本，不同用户之前用逗号分隔

• 1（true）：输出HTML函数
  0（false）：只输出文本，不包含<li>函数以及<a>函数，不同用户之前用逗号分隔

exclude

数组

要排除的用户ID，例如：array(1,6,9)

include

数组

要显示的用户ID，例如：array(1,3,5)

函数使用示例

显示10个用户，并排除ID为1的用户，通常管理员的ID为1，同时即使没有发表过文章的用户也显示出来

<?php
	$args = array(
		'number' => 10,
		'exclude' => array(1),
		'hide_empty' => false
	);
	wp_list_authors($args);
?>

下面的写法也是一样的效果：

<?php wp_list_authors('number=10&exclude=1&hide_empty=0'); ?>

不同之处在于，true写成了1，false写成了0

如果要排除多个用户，则这样写：

<?php wp_list_authors('number=10&exclude=1,2,3&hide_empty=0'); ?>

扩展阅读

wp_list_authors()函数位于：wp-includes/author-template.php

相关函数：

• the_author()
• get_the_author()
• get_the_author_id()
• the_author_link()
• get_the_author_link()
• the_author_meta()
• get_the_author_meta()
• the_author_posts()
• get_the_author_posts()
• the_author_posts_link()
• get_author_posts_url()
• get_the_modified_author()
• the_modified_author()
• wp_dropdown_users()