wp_list_authors( string|array $args = '' )
列出该站点的所有作者,并提供多个选项。
参数
$args
(string|array) (可选)默认参数的数组或字符串。
‘orderby’
(string)如何对作者进行排序。接受“nicename”、“email”、“url”、“registered”、“user_nicename”、“user_email”、“user_url”、“user_registered”、“name”、“display_name”、“post_count”、“ID”、“元值’,’用户登录’。默认“名称”。
‘order’
(string) $orderby 的排序方向。接受“ASC”、“DESC”。默认“ASC”。
‘number’
(int) 要返回或显示的最大作者数。默认为空(所有作者)。
‘optioncount’
(bool) 在作者姓名旁边的括号中显示计数。默认为假。
‘exclude_admin’
(bool)是否排除“管理员”帐户(如果存在)。默认为真。
show_fullname’
(bool) 是否显示作者全名。默认为假。
hide_empty’
(bool) 是否隐藏任何没有帖子的作者。默认为真。
‘feed’
(string) 如果不为空,则显示指向作者提要的链接并将此文本用作链接的 alt 参数。
‘feed_image’
(string) 如果不为空,则显示指向作者提要的链接,并使用此图片 URL 作为可点击的锚点。
‘feed_type’
(string) 要链接到的提要类型。可能的值包括“rss2”、“atom”。默认是 get_default_feed() 的值。
‘echo’
(bool)是输出结果还是返回结果。默认为真。
‘style’
(string) 如果是 ‘list’,每个作者都被包裹在一个
‘html’
(bool)是否以 HTML 形式或纯文本形式列出项目。默认为真。
‘exclude’
(int[]|string) 要排除的作者 ID 的数组或逗号/空格分隔列表。
‘include’
(int[]|string) 要包含的作者 ID 的数组或逗号/空格分隔列表。默认值: ”
返回
(void|string) 如果 ‘echo’ 参数为真,则无效,如果 ‘echo’ 为假,则为作者列表。
示例
此示例显示站点作者的列表,其中包含全名(名字和姓氏)以及每位作者的帖子数。 请注意,输出按帖子计数降序排列,并且限于三 (3) 位作者/用户。 此外,默认情况下,它排除管理员作者,隐藏没有帖子的作者,并且不显示 RSS 提要或图像。
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)