说明
该标签显示博客作者(用户)列表,若用户在博客上发表过文章,则该用户名会显示为一个指向其文章的链接。该标签可显示用户的文章总数和RSS订阅链接。
用法
<?php wp_list_authors( $args ); ?>
默认用法
<?php $args = array(
'optioncount' => false,
'exclude_admin' => true,
'show_fullname' => false,
'hide_empty' => true,
'echo' => true,
'feed' => [empty string],
'feed_image' => [empty string],
'style' => list,
'html' => [empty string] ); ?>
默认情况下的用法:
- 不显示文章总数
- 从用户列表中排除'admin(管理者)'
- 显示“公开显示名称为”中设置的作者名
- 排除没有发表过文章的用户
- 显示结果
- 不显示作者订阅文本或图片
- 列表格式
- 返回的条目具备有效的HTML代码
参数
optioncount
(布尔型)显示每个用户所发表的文章总数。有效值包括:
- 1 (true)
- 0(false)——默认值
exclude_admin
(布尔型)从用户列表中排除'admin(登录名为admin的用户)'有效值包括:
- 1 (true)——默认值
- 0(false)
show_fullname
(布尔型)显示用户的全名(姓+名)。若值为false,显示“公开显示名称为”中设置的用户名。
有效值包括:
- 1 (true)
- 0(false)——默认值
hide_empty
(布尔型)不显示没有发表过文章的用户。有效值包括:
- 1 (true)——默认值
- 0(false)
echo
(布尔型)显示结果。有效值包括:
- 1 (true)——默认值
- 0(false)
feed
(字符串)每位文章作者的RSS订阅链接的链接文本。默认无链接文本,不显示RSS。
feed_image
(字符串)图片的路径/文件名。可作为作者RSS订阅的链接,改写feed参数。
style
(字符串)用以显示作者列表的样式表。list为其默认值,表示以无序列表方式显示作者名;值none可生成常规显示方式(列表项由逗号隔开)。若html为false,该选项将被忽略。始见于WP 2.8。有效值包括:
- list —— 默认值
- none
html
(布尔型)以HTML形式或普通文本形式列出作者名。默认设置为true。若html为false,style设置将被覆盖,函数返回由逗号隔开的列表项。始见于WP 2.8。有效值包括:
- 1 —— 默认值
- 0
示例
显示作者全名和发表的文章总数
下面的示例显示的作者列表中列出了作者的全名(姓+名)和该作者发表的文章总数。此外,默认情况下,列表中会排出admin用户并隐藏没有发表过文章的作者,不显示RSS订阅或图片。
<?php wp_list_authors('show_fullname=1&optioncount=1'); ?>
历史记录
- 始见于WordPress 1.2.0版本
- WP 2.8.0中新增'style'和'html'参数
源文件
wp_list_authors()位于 wp-includes/author-template.php
分类:中文手册