get_posts_nav_link

説明

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



お勧め

5.3の新機能:クエリーログに任意の項目を追加できる新フィルター(2019年10月23日 更新)

5.3 RC2」が公開され、正式リリースまであと20日。公式ディレクトリにプラグインを公開していることもあり、5.3に関する開発者向けの情報「Miscellaneous Developer Focused Changes in 5.3」を読んでいる。

Login rebuilder 2.7.4の変更内容を紹介(2022年7月6日 更新)

Login rebuilder 2.7.4では、ダッシュボードの「ログインのログ」ウィジェット内に現在のユーザー(管理者のみ)のログイン状況を簡潔なメッセージで表示するようにした。

ショートコードを含んだページを表示する前に何か処理する(2014年5月28日 更新)

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。

プラグインの設定ページもレスポンシブ対応(2014年6月3日 更新)

レスポンシブ対応したWordPressの管理画面。プラグインやテーマのカスタマイズで管理画面を拡張しているなら、切り替わるタイミングはきっちり押さえておきたいところではないだろうか。

oEmbed対応サイトを整理した(2023年8月9日 更新)

投稿記事にTwitterやYouTubeのURL(アドレス)を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み(機能)はoEmbedというもので、対応サイトは随時バージョンアップしている。