next_post_link:WordPress私的マニュアル

next_post_link

(1.5.0以降)
next_post_link - 次の投稿ページのリンクを表示する

説明

void next_post_link( [ string $format = '%link »' [ , string $link = '%title' [ , bool ~~$in_same_cat~~$in_same_term = false [ , mixed ~~$excluded_categories~~$excluded_terms = '' [ , string $taxonomy = 'category' ] ] ] ] ] )

次の投稿ページのリンクを表示する。

パラメータ

$format
リンク文字列の書式。省略時は'%link »'（%linkは実際のaタグに置き換わる）。
$link
リンクに表示されるラベル。省略時は'%title'（'%title'は、投稿データのタイトルに置き換わる。また'%date'を指定した場合は、投稿データの投稿日に置き換わる）。
~~$in_same_cat~~$in_same_term
同じターム（[3.8.0]より前のバージョンはカテゴリー、[3.8.0]以降のバージョンは$taxonomyで指定されたタクソノミー）内の投稿ページに限定する場合はtrue、限定しない場合はfalseを指定。省略時はfalseが適用される。
~~$excluded_categories~~$excluded_terms
除外するターム（[3.8.0]より前のバージョンはカテゴリー、[3.8.0]以降のバージョンは$taxonomyで指定されたタクソノミー）を指定する場合は、そのカテゴリーIDを文字列または配列で指定。
$taxonomy
[3.8.0]$in_same_termがtrueの場合に同一判定するタクソノミー名を指定（省略時は'category'）。

返り値

返り値はありません。

注意

次の投稿ページがない場合は、何も表示されない。

使用例

次の投稿ページのリンクを表示する。
<?php next_post_link( ); ?>
同一カテゴリー内の次の投稿ページのリンクを表示する。
<?php next_post_link( '%link »', '%title', true ); ?>
同一タグ内の次の投稿ページのリンクを表示する。
<?php next_post_link( '%link »', '%title', true, '', 'post_tag' ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/link-template.php

参考

Code Reference: next_post_link

お勧めコンテンツ

テキストエディタの文字を変更する（2016年8月30日登録）

テキストエディタ（投稿ページの「テキスト」タブのエディタ）に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。

各投稿記事で設定されているカスタムフィールドの値を取得するには（2011年9月16日登録）

投稿記事ごとに設定されているカスタムフィールドの値はget_post_meta関数で取得できるが、すべての投稿記事で設定されているカスタムフィールドの値を一覧を取得する関数が見当たらない。カテゴリーや投稿タグのようにそれぞれの値と実際に使用されている投稿記事件数を取得したいのだが、探し方が悪いのか見つからないのだ。

ダッシュボードのフィードボックスをカスタマイズ（2011年7月8日登録）

管理者ページのトップページ「ダッシュボード」には、「WordPress 開発者ブログ」と「WordPress フォーラム」という2つのフィードボックスが表示されている。自分のような開発者には有益な情報をもたらしているが、一般の方には必要のない情報かもしれない。今回はこのフィードボックスをカスタマイズする方法を紹介する（管理者権限）。

WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日登録）

WordPress 3.5で登場するであろうWP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。

プラグイン「Login rebuilder」には、バージョン1.2.0からログ情報を保存・確認する機能が備わっています。このログ情報では直近のログインページへの不正アクセスやログイン試行を確認できます。ここでは保存しているログ情報の見方について簡単に説明します。