get_pagenum_link()


WordPressのget_pagenum_link()関数は、指定されたページ番号のリンクを取得するために使用されます。この関数は、ページネーションやアーカイブページで特定のページへのリンクを生成する際に役立ちます。

構文

get_pagenum_link( int $pagenum = 1, bool $escape = true );

引数の説明:

  • $pagenum (int) — リンクを取得したいページ番号を指定します。デフォルトは1です。
  • $escape (bool) — リンクをエスケープするかどうかを指定します。デフォルトはtrueです。

例1: 基本的な使用例

ページ番号2のリンクを取得します。

<?php echo get_pagenum_link(2); ?>

例2: エスケープなしでリンクを取得

エスケープなしでページ番号3のリンクを取得します。

<?php echo get_pagenum_link(3, false); ?>

例3: カスタムクエリを使用したリンクの取得

カスタムクエリを使用してページ番号4のリンクを取得します。

<?php $link = get_pagenum_link(4); echo esc_url($link); ?>

例4: 現在のページ番号を動的に取得

現在のページ番号に基づいてリンクを取得します。

<?php $paged = get_query_var('paged') ? get_query_var('paged') : 1; echo get_pagenum_link($paged); ?>

例5: ページネーションリンクの生成

ページネーション用のリンクを生成します。

<?php for ($i = 1; $i <= 5; $i++) { echo '<a href="' . get_pagenum_link($i) . '">' . $i . '</a> '; } ?>

例6: カスタム投稿タイプでの使用

カスタム投稿タイプのアーカイブページでページ番号2のリンクを取得します。

<?php $link = get_pagenum_link(2); echo '<a href="' . esc_url($link) . '">ページ2へ</a>'; ?>

注意点

  • この関数は、ページネーションやアーカイブページでの使用に適しています。
  • リンクをエスケープする場合は、セキュリティ上の理由から$escapeをtrueに設定してください。

関連機能：