wp_list_authors()

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)

  • 发表评论

    您的电子邮箱地址不会被公开。