テンプレートタグ/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] ); ?>

デフォルトでは以下のようになります。

• 投稿数を表示しない
• リストから'管理者'の著者を除く
• 著者の"公的な表示名"を表示
• 投稿のない著者を除く
• 結果を(HTML形式で)表示
• 著者のフィードテキスト・画像は非表示
• スタイルは一覧形式
• リストを有効なHTMLで返す

パラメータ

optioncount 

(真偽値)各著者によって公開された投稿の数を表示するかしないか。

• 1 (true)
• 0 (false) - デフォルト

exclude_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フィードへのリンク文字列を設定します。デフォルトではテキストはなく、表示されません。

feed_image 

(文字列) 画像へのパス・ファイル名を指定します。各著者のRSSフィードへのリンクとなり、feedパラメータを上書きします。

style 

(文字列) 著者リストを表示するスタイルを指定します。デフォルトではlistで、非序列リストで表示します。noneではカンマ区切りのみの表示です。htmlパラメータがfalseの場合はこのオプションは無視されます。このオプションはVersion 2.8で導入されました。有効な文字列は次の通りです。

• list - デフォルト
• none

html 

(真偽値) リストをHTMLで表示するかプレーンテキストで表示するかを選択します。デフォルトではtrueです。もしfalseの場合は、styleパラメータは無視され、リストはカンマ区切りで返されます。このオプションはVersion 2.8で導入されました。

• 1 (true) - デフォルト
• 0 (false)

用例

著者のフルネームと投稿数を表示

この例ではサイトの著者リストをフルネーム（姓名）で表示し、さらに各著者の投稿数を表示しています。さらに、デフォルトで、管理者を除き、投稿のない著者を隠し、RSSフィードや画像は表示しません。

<?php wp_list_authors('show_fullname=1&optioncount=1'); ?>

Harriett Smith (42)

Sally Smith (29)

Andrew Anderson (48)

変更履歴

• 3.1 : パラメータ 'orderby'、'order'、'number' が追加されました。
• 2.8.0 : 'style'、'html'パラメータが追加されました。
• 1.2.0 : 新規テンプレートタグ

ソースファイル

wp_list_authors()はwp-includes/author-template.phpに書かれています。

最新英語版： WordPress Codex » Function_Reference/wp_list_authors （最新版との差分）

関連

作成者タグ： the_author(), get_the_author(), the_author_link(), get_the_author_link(), the_author_meta(), get_the_author_meta(), the_author_posts(), get_the_author_posts(), the_author_posts_link(), get_author_posts_url(), get_the_modified_author(), the_modified_author(), wp_dropdown_users(), wp_list_authors()

リスト・ドロップダウン関数： wp_list_authors(), wp_list_categories(), wp_list_pages(), wp_list_bookmarks(), wp_list_comments(), wp_get_archives(), wp_page_menu(), wp_dropdown_pages(), wp_dropdown_categories(), wp_dropdown_users()

関数リファレンス、テンプレートタグ目次もご覧ください。