wp_list_authors 列出网站所有作者及他们发布的文章数量

文 / @WordPress主题

函数描述

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

使用方法

<?php wp_list_authors( $args ); ?>

参数

orderbystring):用来排列查询结果的字段,可用的值有:

  • 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 - 用户所发表的文章数量

orderstring):升序还是降序排列,可用的值有:

  • ASC - 默认
  • DESC

numberinteger):最多显示多少个用户,默认没有限制,显示所有用户。

optioncountboolean):是否显示每个作者所发表的文章数量,可用的值有:

  • true
  • false - 默认

exclude_adminboolean):是否排除管理员用户,可用的值有:

  • true - 默认
  • false

show_fullnameboolean):是否显示作者的全名(包括姓和名),如果设置为 false,将显示“公开显示为”设置选项的值。可用的值有:

  • true
  • false - 默认

hide_emptyboolean):是否隐藏没有发表过任何文章的作者,可用的值有:

  • true - 默认
  • false

echoboolean):是否直接显示查询结果,可用的值有:

  • true - 默认
  • false

feedstring):每个作者的 RSS 订阅链接的文本,默认为空,不显示订阅链接。

feed_imagestring):图片路径,每个作者 RSS 订阅链接的链接图像,覆盖上面的 feed 参数。

feed_typestring):订阅源的类型,默认为空字符串,可用的值有:

  • 空 - 默认
  • rss2
  • atom
  • rss
  • rdf

stylestring):以何种方式显示作者列表,默认为 list,以无序列表方式显示作者列表。如果设置为 none,将显示为逗号分隔的作者名称。如果下面的 html 设置为 false,此选项将被忽略。可用的值有:

  • list - 默认
  • none

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

  • true - 默认
  • false

excludearray):在查询结果中排除一个或多个作者,该参数接收一个逗号分隔的作者 ID 列表。

includearray):在查询结果中包含一个或多个作者,该参数接收一个逗号分隔的作者 ID 列表。

默认使用

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

默认情况下,该函数显示以下内容:

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

使用示例

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

下面的示例以列表形式显示了网站的作者名称和他们所发表的文章数量。注意,输出是以作者发表文章的数量为标准,降序排列的。查询限制了最多显示 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)

添加UTHEME为好友
扫码添加UTHEME微信为好友
· 分享WordPress相关技术文章,主题上新与优惠动态早知道。
· 微信端最大WordPress社群,限时免费入群。