get_author_posts_url() の使い方|説明・引数・注意点

説明

get_author_posts_url() は、投稿者の投稿一覧ページのURLを返す関数です。

基本構文

get_author_posts_url( int $author_id, string $author_nicename = '' ): string

引数

  • $author_id:ユーザーID
  • $author_nicename:ユーザーのスラッグ(省略可)

戻り値

投稿者アーカイブのURL。

使い方(サンプル)

echo esc_url( get_author_posts_url( get_the_author_meta( 'ID' ) ) );

注意点

  • 投稿者アーカイブのURLにはユーザー名が含まれる場合があり、セキュリティ面で注意が必要です。

実務での使いどころ

  • 投稿者の記事一覧ページへ、リンクを張るとき。

よくあるミスと対処

  • ユーザー名ではなく、ユーザーIDを渡す。引数の第1引数は、ID。
  • SEOプラグインなどで著者アーカイブを無効にしているサイトでは、リンク先が表示されない場合がある。
  • 出力時に、esc_url() を通していない。

NG例

echo '<a href="' . get_author_posts_url( 'taro' ) . '">投稿一覧</a>'; // 名前を渡している

OK例

$author_id = get_the_author_meta( 'ID' );
echo '<a href="' . esc_url( get_author_posts_url( $author_id ) ) . '">投稿一覧</a>';

使い分け早見表

やりたいこと 使うもの
著者アーカイブのURL get_author_posts_url()
投稿者のIDを取得 get_the_author_meta()
著者アーカイブか判定 is_author()

関連項目

the_author()、get_the_author_meta()

公式リファレンス:get_author_posts_url() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました