wp_list_authors()

wp_list_authors()の用途

wp_list_authors() は、WordPress で投稿者（ユーザー）一覧をリスト表示するテンプレートタグです。特に「複数の著者がいるブログ」で、著者一覧ページやサイドバーウィジェットなどに使われます。

wp_list_authors()の基本構文

wp_list_authors( $args );

• $args は配列またはクエリ文字列形式で渡すオプション指定。

wp_list_authors()は何をする関数？

• 投稿のあるユーザー（デフォルト）を一覧で表示
• 各著者の名前と著者アーカイブページへのリンクを <li> タグで出力
• 投稿数や RSS リンクなどもオプションで表示可能

wp_list_authors()の出力例（初期状態）

<ul>
  <li><a href="https://example.com/author/yamada/">Yamada</a></li>
  <li><a href="https://example.com/author/sato/">Sato</a></li>
</ul>

wp_list_authors()の主な引数一覧（$args）

wp_list_authors()のシンプルな使用例

<?php wp_list_authors(); ?>

※投稿のあるユーザーのみを、著者名とリンク付きで表示

投稿数も表示する例

<?php
wp_list_authors( array(
  'optioncount' => true,
  'hide_empty' => false
) );
?>

出力例：

<ul>
  <li><a href="...">Yamada</a> (5)</li>
  <li><a href="...">Sato</a> (0)</li>
</ul>

RSSリンク付きの例

wp_list_authors( array(
  'feed' => 'RSS',
  'optioncount' => true
) );

出力例：

<li><a href="...">Yamada</a> (10) <a href=".../feed/" title="Yamada RSS">RSS</a></li>

echo => false で文字列として取得

$list = wp_list_authors( array(
  'echo' => false,
  'hide_empty' => false
) );
echo '<div class="author-list">' . $list . '</div>';

wp_list_authors()の注意点

• デフォルトでは投稿のないユーザーは非表示です（hide_empty => true）。
• 「姓＋名（first_name + last_name）」で表示したいときは、show_fullname => true だが、未設定のユーザーがいると空白になることがあるため注意。
• exclude_admin で ID=1 の管理者が除外されるため、必要なら false を明示。

関連関数との比較

wp_list_authors()のまとめ