参数
- $args
-
(string|array)
(可选)
默认参数的数组或字符串。- 'orderby'
(string) 如何对作者进行排序。接受'nicename'、'email'、'url'、'registered'、'user_nicename'、'user_email'、'user_url'、'user_registered'、'name'、'display_name'、'post_count'、'ID'、'meta_value'、'user_login'。默认'name'。 - 'order'
(string) $orderby的排序方向。接受“ASC”、“DESC”。默认值“ASC”。 - 'number'
(int) 返回或显示的最大作者数。默认为空（所有作者）。 - 'optioncount'
(bool) 在作者姓名旁边的括号中显示计数。默认值为false。 - 'exclude_admin'
(bool) 是否排除“admin”帐户（如果存在）。默认为true。 - 'show_fullname'
(bool) 是否显示作者的全名。默认值为false。 - 'hide_empty'
(bool) 是否隐藏没有文章的作者。默认为true。 - 'feed'
(string) 如果不为空，则显示指向作者feed的链接，并将此文本用作链接的alt参数。 - 'feed_image'
(string) 如果不是空的，则显示指向作者feed的链接，并将此图像URL用作可单击的锚链接。 - 'feed_type'
(string) 要链接到的feed类型。可能的值包括“rss2”和“atom”。默认值为get_default_feed()。 - 'echo'
(bool) 是输出结果还是返回结果。默认为true。 - 'style'
(string) 如果“list”，则每个作者都被包装在一个<li>元素中，否则作者将被逗号分隔。 - 'html'
(bool) 是以HTML形式还是纯文本形式列出项目。默认为true。 - 'exclude'
(int[]|string) 要排除的作者ID的数组或以逗号/空格分隔的列表。 - 'include'
(int[]|string) 要包括的作者ID的数组或以逗号/空格分隔的列表。
默认值: ''
- 'orderby'
返回
(void|string) 如果“echo”参数为true，则无返回；如果“echo”为false，则返回作者列表。
说明
显示网站作者（用户）的列表，如果用户撰写了任何文章，则作者姓名将显示为其文章的链接。可选地，该标签显示每个作者的文章数和RSS feed链接。
源码
更新日志
| 版本 | 描述 |
|---|---|
| 1.2.0 | 开始引入 |
使用示例
作者全名和文章数量
此示例显示网站作者的列表，包括全名（名字和姓氏）加上每个作者的文章数量。注意，输出按文章计数降序，并且获取数量限制为三（3）。此外，默认情况下，它会排除管理员作者，隐藏没有文章的作者，并且不显示RSS feed或图像。wp_list_authors( array( 'show_fullname' => 1, 'optioncount' => 1, 'orderby' => 'post_count', 'order' => 'DESC', 'number' => 3 ) );
输出示例：
Andrew Anderson (48)
Harriett Smith (42)
Sally Smith (29)