函数描述

显示网站所有的作者（用户）列表，如果某作者发表了文章，作者的名称会加上链接到他们发表的文章的存档页的链接，该函数还可以显示作者所发表的文章数量和该作者所发表文章的RSS链接。

使用方法

<?php wp_list_authors( $args ); ?>

默认使用

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

默认情况下，该函数显示以下内容。

• 显示作者名称（公开显示为选项所设置的），按名称升序排列。
• 不显示显示作者的数量。
• 不显示作者发表的文章数量
• 在列表中排除’admin’角色的作者
• 显示的名称为 “公开显示为” 设置里面设置的名称。
• 排除没有发表过文章的作者
• 直接显示查询结果
• 没有定义作者订阅源文本、图片或订阅源类型。
• 显示方式为列表
• 项目返回为经过验证的HTML
• 没有订阅任何排除或包含的作者

参数

orderby (string) 用来排列查询结果的字段，可用的值有：

• name – display_name 用户表中的 display_name – 默认
• email – user_email 用户表中的user_email
• url – user_url 用户表中的user_url
• registered – 用户表中的user_registered 日期
• id – ID 用户表中的ID主键
• user_login – 用户表中的user_login值
• post_count – 用户所发表的文章数量

order (string) 升序还是降序排列，可用的值有：

• ASC – 默认
• DESC

number (integer) 最多显示多少个用户，默认没有限制，显示所有用户。 optioncount (boolean) 是否显示每个作者所发表的文章数量，可用的值有：values:

• 1 (true)
• 0 (false) – 默认

exclude_admin (boolean) 是否排除管理员用户，可用的值有：

• 1 (true) – 默认
• 0 (false)

show_fullname (boolean) 是否显示作者的全名（包括姓和名），如果设置为false，将显示“公开显示为”设置选项的值。可用的值有：

• 1 (true)
• 0 (false) – 默认

hide_empty (boolean) 是否隐藏没有发表过任何文章的作者，可用的值有：

• 1 (true) – 默认
• 0 (false)

echo (boolean) 是否直接显示查询结果，可用的值有：

• 1 (true) – default
• 0 (false)

feed (string) 每个作者的RSS订阅链接的文本，默认为空，不显示订阅链接。 feed_image (string) 图片路径，每个作者RSS订阅链接的链接图像，覆盖上面的 feed 参数。 feed_type (string) 订阅源的类型，默认为空字符串，可用的值有：

• – 默认
• rss2
• atom
• rss
• rdf

style (string) 以哪种方式显示作者列表，默认为list，以无须列表方式显示作者列表。如果设置为none，将显示为逗号分隔的作者名称。如果下面的 html 设置为 false,，次选项将被忽略。可用的值有：

• list – 默认
• none

html (boolean) 以HTML还是纯文本方式显示作者列表，默认为true，以HTML方式显示，如果设置为false，上面的 style 设置将被忽略，结果显示为以逗号分隔的作者名称列表，可用的值有：

• 1 (true) – 默认
• 0 (false)

exclude (array) 在查询结果中排除一个或多个作者，该参数接收一个逗号分隔的作者id列表。 include (array) 在查询结果中包含一个或多个作者，该参数接收一个逗号分隔的作者id列表。

使用示例

显示作者全名和他们所发表的文章数量

下面的示例以列表形式显示了网站的作者名称和他们所发表的文章数量，注意，输出是以作者发表文章的数量为标准，降序排列的，查询限制了最多显示3名作者，默认排除了管理员用户，隐藏了没有发表过文章的用户，没有显示RSS文本或图像链接。

wp_list_authors('show_fullname=1&optioncount=1&orderby=post_count&order=DESC&number=3');

上面的查询结果最终输出为：

Andrew Anderson (48)
Harriett Smith (42)Sally Smith (29)