【WordPress・プラグインなし】ページネーションが表示されない時の解決策

white and black braille typewriter

この記事には広告を含む場合があります。

記事内で紹介する商品を購入することで、当サイトに売り上げの一部が還元されることがあります。

先日、当ブログのWordPressテーマをリニューアルしました。

今回のリニューアルでページネーション(プラグインなし)を追加するために、参考サイトを検索しました。

そこまでは良かったのですが、参考サイトを見ながらコードを書いてみると。ページネーションがどうしても表示されませんでした。

参考サイトや、書いたコードが間違えていたのではなく、原因は単純なことでした。

検証環境

WordPressのバージョン

5.9.1

投稿の総記事数

2件

該当コード(ページネーション部分)

ページネーションのコード部分の作り方は以下参考サイトから。

参考サイト

5分で実装!WordPressでページネーションを作成する方法(プラグインor自作)https://min-web.com/wordpress-pagination-selfmade-plugin/

<?php
$args = array(
    'mid_size' => 1,
    'prev_text' => '<<前のページへ',
    'next_text' => '次のページへ>>',
    'screen_reader_text' => ' ',
);
the_posts_pagination($args);
?>

まず、ページネーションって何?

まずはページネーションとは何か?ということから簡単に説明します。「ページネーションが何か知ってるよ」という方は、読み飛ばしOKです。

ブログなどでページの一番下に「1、2、…次へ」のように、次のページに進むボタンがありますよね。それがページネーションです。

以下の画像はページネーションのイメージ図です。


ページネーション

原因

今回ページネーションが表示されなかった原因は、「1ページに表示する最大投稿数」の設定が記事の総数より多かったからでした。

「1ページに表示する最大投稿数」の設定って何?

今まで書いた記事が100記事ほどあったとすると、全ての記事を1ページに表示すると、1ページが縦にすごく長くなります。

そこで複数ページに分割して表示したい場合、「1ページに表示する最大投稿数」の設定でページを分割できます。

ページネーションの有るページと無いページをまとめたのが下の図です。

解決策(結論)

ページネーションが表示されないときの解決策は、「1ページに表示する最大投稿数」の設定を総投稿記事数より少ない数に設定することです。

例えば・・・

記事の総数が20ページだったとして、「1ページに表示する最大投稿数」が「10件」ならば、20件のうち、10件だけ表示されます。

解説

結論をもう少し解説すると、今回の場合は「1ページに表示する最大投稿数」の設定が「10件」に設定されていたのですが、書いていた投稿記事の総数が「2件」でした。

投稿数が「10件」(1ページに表示される最大の記事数)に満たない「2件」なので、1ページに収まっているのです。

式で表すと・・・

  • ページネーションが表示される場合「サイトの総投稿記事数」 >「 1ページに表示される最大の記事数」
  • ページネーションが表示され無い場合 「 1ページに表示される最大の記事数」>「サイトの総投稿記事数」

図で表すと・・・

参考サイト(ページネーションのコード部分)

5分で実装!WordPressでページネーションを作成する方法(プラグインor自作)https://min-web.com/wordpress-pagination-selfmade-plugin/

まとめ

今回はWordPressにプラグインなしでページネーションを表示したいのに、表示されない場合の解決策について説明しました。

テスト環境で記事数が少ないために、起こったことでした。

記事数が増えて来たら、自然にページネーションが表示されます。

テスト環境で記事数が少ない時にページネーションが表示されなかったら、今回のような原因を疑ってみてください。

ではまた/~