Table of Contents Plusで目次が表示されない原因と対処法

こんにちは。KYOです。

当ブログはWordPress（ワードプレス）を使って作成しているんですが、ある日当然、記事の目次が表示されなくなってしまいました。（現在は解決済み）

以前は別のテーマを使用しており、その時は「Table of Contents Plus」（TOC+）という目次を自動的に表示させるプラグイン（拡張機能）を使っていました。

目次が表示されなくなった直前にプラグインの設定を変更したという記憶がなかっただけに、相当焦りました。

目次がなくても特に問題はなかったのですが、こういう問題を放置しておくことが性格的に出来ないので、今回は私が実践した問題の対処法をご紹介します。

Table of Contents Plusで目次が表示されない原因（１）見出し数

実は、Table of Contents Plusを使っていて目次が表示されなくなった体験は過去に2度あります。

私が最初に遭遇したトラブルの原因が「見出し数」の設定を誤っていたことです。

まず、ダッシュボードにアクセスして「設定」から「TOC+」の項目を開きます。

そうすると「基本設定」の画面が表示されますが、この時、「表示条件」を確認して下さい。

デフォルトでは「2つ以上見出しがあるとき」に設定されているはずですが、私のケースでは、これがなぜか「3つ」に設定されていました。

当時、私の記事は見出しの数が2つしかなかったため、見出しの表示条件が「3つ以上」に設定されていれば目次が出て来ないのは当然ですね。

この設定を「2つ」に変更したところ、無事目次が表示されるようになりました。

なお、設定を変更した後は、画面の最下部にある「設定を更新」のボタンを必ず押してください。

設定を変更しただけで別のページに変遷すると、変更が更新されないままの状態になってしまいます。

直近で遭遇したトラブルの原因が「見出しレベル」のチェックが勝手に外れていたことでした。

「見出しレベルとは何ぞや？」と思う方が多いかもしれませんが、今回のトラブルに遭遇するまで私も全く知らない言葉でした。

この見出しレベルを確認するには（１）で説明した基本設定の最下部にある「上級者向け」という項目を開いてください。

通常、この項目は非表示に設定されているので、普段は目にする機会が殆どないはずです。

「上級者向け」の項目を開くと「見出しレベル」という項目があるので、そこのチェックが外れていないかをチェックします。

私はこのチェックが全て外れており、これが原因で目次が表示されなくなっていました。

下記の通り、「heading 2 ～ heading 4」の項目にチェックを入れたら目次が表示されるようになりました。

全ての見出しレベルにチェックを入れる必要はなく、普段から多く使っている見出しレベルだけにチェックを入れれば問題ありません。

今までに上級者向けの項目を開いたことすらなかったのですが、どうやらプラグインの更新をしたことでチェックが全て外れてしまったようです。

（１）でも説明した通り、設定を変更したら「設定を変更」のボタン押下を忘れずに行って下さい。

（１）で説明した基本設定の画面に「以下のコンテンツタイプを自動挿入」という項目があります。

この項目で「post」と「page」にチェックが入っているかを確認しましょう。

「post」は投稿記事のことで、「page」は固定ページを意味しており、ここにチェックが入っていないと、それらに目次が表示されません。

この2つにチェックが入っていなくても目次を表示される方法はあり、それが記事内にショートコード（［toc］）を設置するというものです。

［補足］
［toc］のショートコードは［］（全角）ではなく[]（半角）です。

[]（半角）でtocを囲ってしまうと、意図しない位置に目次が表示されてしまうため、上記の説明では敢えて［］（全角）で囲っています。

ただ、全ての記事1つ1つにショートコードを設置するのは大変なので、「post」と「page」にチェックを入れた方が断然速いでしょう。

最後のケースは、Table of Contents Plusのウィジェットの設定に誤りがある場合です。

使用しているテーマによってはウィジェットに「TOC+」と表示されている場合があります。

まずはダッシュボードの「外観」を開き、ウィジェットにアクセスして「TOC+」があるか確認しましょう。

プラグインではなくこのウィジェットで目次の設定をしている場合、「目次をサイドバーにのみ表示」の項目にチェックが入っているかを確認して下さい。

当然、この項目にチェックが入っていると、目次はサイドバーにしか表示されません。

「サイドバーには目次が表示されるのに、記事には目次が表示されない」という症状が発生している場合は、このウィジェットの設定が誤っている可能性が高いと思われます。