WordPress函數(shù)：wp_list_authors（作者列表）

描述

用來顯示網(wǎng)站的作者（用戶）列表，如果用戶發(fā)布有文章，就會將作者名字鏈接到他們的文章。還可以顯示每個作者的文章數(shù)和RSS訂閱鏈接。

用法

<?php wp_list_authors( $args ); ?> 

默認(rèn)用法

<?php $args = array(
'orderby'       => 'name', 
'order'         => 'ASC', 
'number'        => null,
'optioncount'   => false, 
'exclude_admin' => true, 
'show_fullname' => false,
'hide_empty'    => true,
'echo'          => true,
'feed'          => [empty string], 
'feed_image'    => [empty string],
'feed_type'     => [empty string],
'style'         => list,
'html'          => true ); ?> 

默認(rèn)用法顯示的內(nèi)容：

• 名稱顯示（顯示名稱）順序：升序
• 顯示的用戶數(shù)量沒有限制
• 不顯示用戶的文章數(shù)
• 從列表中排除“管理員”
• 顯示作者的“公開顯示為”的名稱
• 排除沒有文章的用戶
• 顯示結(jié)果
• 沒有定義作者的Feed文本、圖像或Feed類型
• 該風(fēng)格以列表格式顯示
• 使用有效的HTML返回項目

參數(shù)

orderby 

（字符串）字段用于對結(jié)果進行排序。這種說法是3.1版本中引入。有效值：

• name – 根據(jù) users 這個表的 display_name 進行排序 – 默認(rèn)
• email – 根據(jù) users 這個表的user_email 進行排序
• url – 根據(jù) users 這個表的 user_url 進行排序
• registered – 根據(jù) users 這個表的 user_registered 日期 進行排序
• id – 根據(jù) users 這個表的 ID 進行排序
• user_login – 根據(jù) users 這個表的 user_login 進行排序
• post_count – 根據(jù)用戶的文章數(shù)進行排序

order 

（字符串）令結(jié)果遞增或遞減。這種說法是3.1版本中引入。有效值：

• ASC – 升序（默認(rèn)）
• DESC – 降序

number 

（整數(shù)）顯示用戶的最大數(shù)量。缺省情況下，顯示的用戶的數(shù)目是沒有限制的。這種說法是3.1版本中引入。

optioncount 

（布爾）顯示每個作者發(fā)表的文章。有效值：

• 1 (true)
• 0 (false) – 默認(rèn)

exclude_admin 

（布爾）排除“管理員”（登錄名是admin）帳戶列表。有效值：

• 1 (true) – 默認(rèn)
• 0 (false)

show_fullname 

（布爾）顯示完整的（第一個和最后一個）作者名稱。如果為false，顯示“公開顯示為”的名稱。有效值：

• 1 (true)
• 0 (false) – 默認(rèn)

hide_empty 

（布爾）不顯示沒有文章的作者。有效值：

• 1 (true) – 默認(rèn)
• 0 (false)

echo 

（布爾）顯示結(jié)果。有效值：

• 1 (true) – 默認(rèn)
• 0 (false)

feed 

（字符串）鏈接到每個作者的RSS feed 所顯示的文字。默認(rèn)是沒有文字，而且不顯示Feed。

feed_image 

（字符串）圖想的路徑/文件名。這可以作為一個鏈接到每個作者的RSS feed，覆蓋feed參數(shù)。

feed_type 

（字符串）Feed的類型，默認(rèn)空字符串。有效值：

• – 默認(rèn)
• rss2
• atom
• rss
• rdf

style

（字符串）作者列表的顯示樣式。一個列表，默認(rèn)情況下，顯示了作者作為一個無序列表，而沒有產(chǎn)生任何特殊的顯示方式（用逗號分隔每個列表項）。如果html是false，這個選項被忽略。有效值：

• list – 默認(rèn)
• none

html 

（布爾）作者列表以html或明文輸出。默認(rèn)設(shè)置為true。如果html是false，樣式設(shè)置將被忽略，而且返回列表項，用逗號隔開。有效值：

• 1 (true) – 默認(rèn)
• 0 (false)

例子

顯示作者名稱和文章數(shù)

這個例子顯示一個列表的網(wǎng)站的作者的全名（第一個和最后一個名字），以及每個作者的文章數(shù)量。作者列表是根據(jù)每個作者的文章數(shù)量進行降序排列，并只顯示前三名作者/用戶。此外，默認(rèn)情況下，它排除了admin 管理員，隱藏沒有文章的作者，并且不顯示RSS feed或圖像。

<?php wp_list_authors('show_fullname=1&optioncount=1&orderby=post_count&order=DESC&number=3'); ?>

輸出結(jié)果：

• Andrew Anderson (48)
• Harriett Smith (42)
• Sally Smith (29)

函數(shù)歷史

始見于 1.2.0 版本

2.8版本：添加 ‘style’ 和 ‘html’ 參數(shù)

3.1版本：添加 ‘orderby’, ‘order’, 和 ‘number’ 參數(shù)

源文件

wp_list_authors() 位于 wp-includes/author-template.php.