カテゴリー一覧が表示されない時にチェックすること【WordPress】

カテゴリー一覧ページで真っ白な画面になってしまう、カテゴリー一覧ページへアクセスできない。
そんな時にチェックしたいこと、その解決策をまとめていきます。

何かの作業直前にカテゴリー一覧が表示されていることが確認できていれば、その作業内容に問題があるはずなので、原因究明はしやすいです。
ただ毎回の作業の時に全ページチェックはついつい忘れがちに…(私はそうです)

いつの間にか表示されない、そういった時に何をチェックしていくかを知って、早急に原因を特定していきましょう。

キャッシュを削除してみる

特に思い当たらない場合、簡単な方法から試していきましょう。

キャッシュによって正常に動作しないこともあるので、まずはブラウザのキャッシュを削除。
WordPressのキャッシュプラグインを入れている方は、そちらの方でも削除してください。

パーマリンク設定の確認

パーマリンクの設定によって意図した通りにアクセスできないこともあります。設定 > パーマリンク からどういった設定にしているか改めて確認してみましょう。

【パーマリンク構造を「投稿名」にしていた場合】

この設定にしている時に、例えば cat01 というカテゴリーがあったとして、https://example.com/cat01/ でアクセスしても一覧ページにはアクセスできません。

このパーマリンク設定の時のカテゴリー一覧のURLは、https://example.com/category/cat01/ となります。
上記のURLでも問題なければ各所リンク先に注意して設定します。
もし「category」という部分を無くしたいのであれば、パーマリンク構造を「/%category%/%postname%/」にするか、「category」の部分を切り取ってくれるプラグインを導入してみてください。
【おすすめプラグイン】No Category Base (WPML)

パーマリンク構造を「/%category%/%postname%/」に設定したもの

上記の設定をすることで、パーマリンク構造を「投稿名」にしていても https://example.com/cat01/ で一覧が表示されるはずです。

※この動作はWordPressバージョン6.2で確認しています。

テーマを変えてみる

テーマに問題がないか確認するには他のテーマを使ってみるのも一つの手です。

別のテーマに変更して表示される場合はテーマの中に問題があると考えられます。テーマ内のファイルをカテゴリー一覧表示に関連するファイルをチェックしていきましょう。

プラグインチェック

WordPressのエラーはプラグインが原因となることも多いです。

一覧が表示されなくなった時に追加したプラグインを停止してみましょう。解決されない場合は一覧ページが表示されるか確認しながら一つずつ停止していきます。

プラグイン停止後に表示されれば、そのプラグインが原因です。代替プラグインや、そのプラグインのエラーについて調べて解決法を見つけましょう。

同じような機能のプラグインを有効にしているとエラーになることも多いようです。
プラグインをたくさん使っている場合、これを機に整理してみるのもいいかもしれません。もし自分で機能をつけられそうなら自作してみるのもありです。

一覧ページのテンプレートファイルを確認

ページにアクセスができるものの画面が真っ白になっている場合、表示しているテンプレートファイルが原因の場合があります。

カテゴリー一覧ページのテンプレートファイルは category.php や archive.php、その他 category-〇〇.php といったファイルも当てはまります。

どのファイルが使われているかわからない場合は、下記記事も参考にしてみてください。

そのページに使用されているファイルのバックアップをとっておいて、新たにファイルを作ってテーマに入れてみます。

これで正く表示されるなら、そのファイルのどこかにエラーの原因があるので、思い当たるコードを削除したり書き換えたりしてみてください。

もしくはデバックモードにしてエラー行を確認します。デバッグモードは wp-config.php にあるコードを編集すれば表示されるようになります。
define('WP_DEBUG', false); になっていたら falsetrue に変更すればエラーが表示されるようになります。

// デバッグモードOFF
define('WP_DEBUG', false);

// デバッグモードをONにする
define('WP_DEBUG', true);

使えないスラッグを使ってる?

カテゴリーのスラッグが影響している可能性もあります。ワードプレスには予約語というものがあって、その文字列は使用することができません。

また全角記号を使用している場合もエラーになってしまうことがあるようです。特定のカテゴリーだけが表示されない、といった場合には別のスラッグに変更して表示されるか確認してみましょう。

カテゴリー : WordPress

TOPへ