説明
string get_posts_nav_link( [ array $args = array() ] )
前後のページへのリンクテキストを取得する。
パラメータ
- $args連想配列でパラメータを指定。指定できるパラメータは次の通り。
キー名(handle) 内容 省略時の内容 'sep' 区切り文字 ' — ' 'prelabel' 前ページの文字 __('« Previous Page') 'nxtlabel' 次ページの文字 __('Next Page »')
返り値
前後のページへのリンクテキストを返す。呼び出し時のページが投稿ページか、前後のページがない場合は''を返す。注意
検索結果ページやアーカイブページ用の関数で、内部では get_previous_posts_linkおよび get_next_posts_link関数を呼び出し、それぞれのリンクテキストを作成している。使用例
- 前後のページへのリンクテキストを取得する。<?php $navi = get_posts_nav_link(); ?>
- 区切り文字を指定して前後のページへのリンクテキストを取得する。<?php $navi = get_posts_nav_link( array('sep' => ' (3/5) ') ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/link-template.php最終更新 : 2012年01月11日 17:42
関連
お勧め
6.2に追加されるsearch_columnsパラメータが便利(2023年3月30日 更新)
バージョン6.2では記事検索機能を備えたWP_Queryクラスにsearch_columnsパラメータが追加される。標準のキーワード検索では、タイトル(post_title)、本文(post_content)、抜粋(post_excerpt)が対象になっているが、search_columnsパラメータを使うと対象を絞り込めるようになる。
固定ページのURLの拡張子をhtmlに変更する(2013年3月9日 更新)
固定ページについて、URLを静的ページっぽく拡張子htmlに変更したいという要望を受けることがある。これまでは「.html on PAGES」というプラグインを使っていて特に不満があったわけではないのだが、今回ひょんなことから簡単に対応できることがわかったので、メモ書きしておく。KUSANAGIでマルチサイト(サブドメイン)を試した(2019年8月6日 更新)
本サイトはサブディレクトリタイプのマルチサイト機能を採用して構築しているが、これまでサブドメインタイプは利用した経験はない。マルチサイト機能のサブドメインタイプは以前から1度は試してみたいと思っており、今回実際にサイトを構築してみた。
Fotepo:プラグイン作ってみました(2019年9月19日 更新)
仕事柄、Chromeの「デベロッパーツール」を使ってページのフォントを変更することがある。そんな時、無効なフォント名を指定してしまったり、フォント名をまちがえることがあり、もう少しお手軽にできないかと思って作ったのが今回紹介するプラグイン「Fotepo」である。
カテゴリー専用の投稿一覧と新規投稿メニューを追加する(2012年1月23日 更新)
サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。