当前浏览:首页 / WordPress函数 / wp_list_authors()

wp_list_authors( string|array $args = '' )

列出网站的所有作者,并提供了几个选项

author 作者more...

listmore...


参数

$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的数组或以逗号/空格分隔的列表。

默认值: ''


返回

(void|string) 如果“echo”参数为true,则无返回;如果“echo”为false,则返回作者列表。


说明

显示网站作者(用户)的列表,如果用户撰写了任何文章,则作者姓名将显示为其文章的链接。可选地,该标签显示每个作者的文章数和RSS feed链接。



源码

查看源码 官方文档


更新日志

版本描述
1.2.0开始引入

用户贡献的笔记

  • 贡献者:Codex

    作者全名和文章数量
    此示例显示网站作者的列表,包括全名(名字和姓氏)加上每个作者的文章数量。注意,输出按文章计数降序,并且获取数量限制为三(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)