get_the_posts_pagination()

基本構文と使い方（引数・実行結果）

アーカイブページ（記事一覧ページ）にて利用可能なページネーションを取得します。

get_the_posts_pagination($args);

Copy

get_the_posts_pagination($args);

引数	必須/任意	引数に指定するもの
第１引数 $args	任意	パラメーターを`配列`で指定利用できる主なパラメーターは下記の通り。 `class` navに付与するclassの値（初期値：pagination） `total` 表示するページ数の上限（デフォルト：存在するページ分すべて） `mid_size` 現在のページ番号の両サイドにいくつのページ番号を表示するか（デフォルト：２） `prev_text` 前ページリンクのテキスト（デフォルト：前へ） `next_text` 次ページリンクのテキスト（デフォルト：次へ）初期値：`[]`（空の配列）すべてのパラメーターはこちらを参照してください（英語） https://developer.wordpress.org/reference/functions/the_posts_pagination/

戻り値（返す値）：ページネーションを取得します。
表示したい場合はthe_posts_pagination()を使えます。

【引数とは】
テンプレートタグ（=関数）を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。

【引数について】

指定できる引数の数はテンプレートタグによって異なります。（引数なしもあり）
引数ごとに必須 / 任意が決まっています。（必須は必ず指定、任意は指定しなければ初期値）
引数名(例：$post)は仕様の便宜上の名前と考えてください。（この名前自体はテンプレートタグ実行に関係しません。各引数に何を指定するのかを理解していればOKです。）

※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。

テンプレートタグ	説明
get_search_query()	検索キーワードを取得する。
get_post_type()	記事が所属する投稿タイプの名前を返す。
get_queried_object_id()	現在のクエリ（DBへの問い合わせ条件）に関するオブジェクトのIDを返す。
get_queried_object()	現在のクエリ（DBへの問い合わせ条件）に関するオブジェクトを返します。
the_posts_pagination()	アーカイブページ（記事一覧ページ）にてページネーションを表示します。
get_posts()	指定した条件にマッチする記事オブジェクトの配列を取得する。
get_post()	指定した投稿情報を取得する。
wp_reset_postdata()	サブクエリによって上書きされたグローバルオブジェクト$postをリセットしてメインクエリに戻します。
the_post()	処理対象の記事をセットします。
have_posts()	記事が存在するかどうか調べて真偽値を返します。

Akiyuki Tanaka

2014年にフリーランス（Webデザイナー／コーダー）として独立。2016年にWeb制作会社ソーイ株式会社を設立し、現在までWeb制作・開発の現場に携わってきました。

初学者だった頃は、学習に苦労し随分と遠回りしました。かつての自分と同じような人に提供できるものがあるのではないかと考え、YouTubeでの講義配信を経て、より体系的で実践的な学習環境を提供する、独自の学習プラットフォーム unazuki を立ち上げました。

制作と教育、両方の現場に立ってきた経験を活かし、「とりあえずコードが書ける」ではなく、考えて作れるWeb制作者を増やすことを目指しています。