previous_post_link()

Q: 投稿が1つだけの場合、どうすればリンクを非表示にできますか？

if 文を使って、前後の投稿が存在する場合のみリンクを表示するようにします。

Q: カスタム投稿タイプでも使えますか？

はい、get_previous_post_where フィルターを使用すれば、カスタム投稿タイプにも対応できます。

Q: 同じタグ内の前の投稿をリンクすることはできますか？

はい、$in_same_term パラメータを使用し、同じタグやカテゴリー内での前後投稿リンクを作成できます。

Function

2025/7/5 Saturday

previous_post_link() は、現在の投稿の前に公開された投稿へのリンクを生成するテンプレートタグです。ブログや投稿一覧ページで、ユーザーが前の投稿に簡単に移動できるナビゲーションを提供します。

機能の説明

previous_post_link() は、現在の投稿の1つ前の投稿へのリンクを表示します。リンクには任意のテキストやHTMLを指定でき、リンクが必要ない場合には空の値を返します。

引数

$format : リンクの出力フォーマット（%link の位置にリンクが挿入されます）
$link : リンクに表示するテキストまたはHTML
$in_same_term : 同じカテゴリーやターム内の投稿を取得するかの指定（デフォルト：false）
$excluded_terms : 除外するカテゴリーやタームのID（カンマ区切り）

シンプルなコード例

<?php previous_post_link('%link', '← 前の投稿'); ?>

このコードは、前の投稿が存在する場合、「← 前の投稿」というリンクを表示します。

使い方の解説

previous_post_link() は、ブログ投稿の詳細ページで使われ、ユーザーに前の投稿にナビゲートする手段を提供します。

引数 $in_same_term を使うことで、同じカテゴリーやターム内の投稿だけをリンクすることも可能です。
CSS でナビゲーションリンクをカスタマイズすることで、サイト全体のデザインに統一感を持たせられます。

シンプルな使用例

<nav class="post-navigation">
    <?php previous_post_link('%link', '← %title'); ?>
</nav>

この例では、前の投稿のタイトルをリンク内に表示します。%title は自動的に投稿のタイトルに置き換わります。

同じカテゴリー内でのリンク

<nav class="post-navigation">
    <?php previous_post_link('%link', '← %title', true); ?>
</nav>

このコードでは、同じカテゴリー内の前の投稿に限定してリンクを表示します。

除外するカテゴリーを指定した例

<nav class="post-navigation">
    <?php previous_post_link('%link', '← %title', false, '1,3'); ?>
</nav>

カテゴリーIDが1と3の投稿を除外した状態で、前の投稿へのリンクを生成します。

一緒に使うことが多い関連タグ

`next_post_link()`

現在の投稿の次の投稿へのリンクを生成するテンプレートタグです。previous_post_link() と組み合わせて使うことで、投稿の前後ナビゲーションを提供します。

<nav class="post-navigation">
    <?php previous_post_link('%link', '← %title'); ?>
    <?php next_post_link('%link', '%title →'); ?>
</nav>

このコードは、投稿の前後リンクをナビゲーションメニューにまとめています。

`get_the_category()`

投稿が所属するカテゴリー情報を取得するテンプレートタグです。カテゴリーを表示し、リンクに反映させるときに使います。

$categories = get_the_category();
if (!empty($categories)) {
    echo '<a href="' . esc_url(get_category_link($categories[0]->term_id)) . '">' . esc_html($categories[0]->name) . '</a>';
}

このコードは、現在の投稿の最初のカテゴリーにリンクを生成します。

追加情報を取得したい場合

`get_adjacent_post()` を使ったカスタマイズ

get_adjacent_post() は、previous_post_link() の裏側で動作する関数で、前後の投稿データを取得するために使えます。

$previous_post = get_adjacent_post(false, '', true);
if ($previous_post) {
    echo '<a href="' . get_permalink($previous_post->ID) . '">← ' . get_the_title($previous_post->ID) . '</a>';
}

このコードでは、前の投稿のタイトルとリンクを直接取得して表示します。

`get_post()` で投稿情報を取得

$post = get_post();
echo '投稿タイトル: ' . $post->post_title;
echo '投稿日: ' . $post->post_date;

このコードでは、現在の投稿のタイトルと投稿日を取得して表示します。

出力できる情報

post_title: 投稿タイトル
post_date: 投稿日時
post_content: 投稿本文
post_author: 投稿者ID

使用する事で想定されるトラブル

投稿が存在しない場合、リンクが表示されない

最初の投稿の場合、前の投稿が存在しないためリンクが出力されません。

解決策

if 文で投稿が存在するかどうかを確認します。

<?php if (get_adjacent_post(false, '', true)) : ?>
    <?php previous_post_link('%link', '← 前の投稿'); ?>
<?php endif; ?>

カスタム投稿タイプでリンクが機能しない

previous_post_link() はデフォルトでは投稿タイプが異なる投稿を無視します。

解決策

カスタムクエリを使って、previous_post_link() を使う前に投稿タイプを指定します。

add_filter('get_previous_post_where', function($where) {
    return $where . " AND post_type = 'custom_post_type'";
});
previous_post_link('%link', '← 前の投稿');