说明

该标签显示博客作者（用户）列表，若用户在博客上发表过文章，则该用户名会显示为一个指向其文章的链接。该标签可显示用户的文章总数和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

分类：中文手册