首页    >    中文手册    >   模板标签-wp_list_authors()

模板标签-wp_list_authors()

说明

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

分类:中文手册

* 版权声明:作者WordPress啦! 转载请注明出处。