Easy Table of Contentsで目次が表示されない時の確認。

Wordpressの目次プラグイン「Easy Table of Contents」で目次が表示されない時に確認すべき内容をまとめました。

大抵の原因は見出し（Hタグ）が表示条件分使用されていない事と、プラグインのCSSが読み込めていないことにあります。

ページ内にHタグを適切に使用しているにも関わらず、目次が表示されない時はプラグインの設定を再確認しましょう。

目次の表示に関わる設定のポイントは大きく４つ！画像付きで解説します。

この記事の目次

Easy Table of Contentsが表示されない原因

早速ですが、Easy Table of Contentsで目次が表示されない主な原因は以下です。

投稿内のHタグの個数が足りていない。
投稿内のHタグがPタグなどになっている。
有効化するページが適切な設定になっていない。
プラグインのCSSが読み込まれておらず、非表示になっている。

目次が表示されない原因はほとんどがプラグインの設定ミスです。
プラグインの性質上、Easy Table of Contentsは他のプラグインやテーマと干渉する事はほぼありません。

目次が表示されないといってもEasy Table of Contentsの場合は、

目次ユニットが全く表示されない時
"目次"というラベルしか表示されない時

というように２つの状況があります。
ではそれぞれ詳しく見ていきましょう・ｗ・

目次が全く表示されない時の確認

まずは目次ユニットが全く表示されない場合の確認事項です。

目次のタイトルすら表示されていない場合

上の画像のような場合ですね。
こうなる時はEasy Table of Contentsの目次出力の条件を満たしていないことが主な原因です。

確認事項１．記事中のHタグは足りているか？

Easy Table of Contentsの設定画面には「表示条件」という項目があります。

Hタグ数が設定値以上存在する記事のみに目次を出力する

これは記事中に見出し（Hタグ）が何個以上あれば目次を表示するかの設定です。
1～10以上という条件を設定することが出来ます。
この個数以上のHタグを記事中に使用していない場合は目次が表示されません。

チェックを入れたHタグが個数のカウント対象

また、この個数のカウントは設定画面にある「見出し」という項目にチェックを入れたHタグのみが使用されます。

極端に言うとH1タグのみにチェックを入れている状態だと、記事中にH2,H3,H4などの見出しを何個使おうが目次は表示されないという事です。

ポイント

表示条件：設定した数以上Hタグを使っているときに目次を表示する設定。
見出し：どのHタグを"数"としてカウントするかの設定。

確認事項２．ページごとの目次有効化設定

続いて確認したい設定が、目次を表示したいページを有効化しているかどうかです。

目次を表示したいページタイプを選択する

プラグインの設定画面にある「サポートを有効化」及び「自動挿入」の箇所で、目次を表示したいページでプラグインが有効になっているか確認しましょう。

初期設定では「投稿」にしかチェックが入っていないので、記事ページ以外の全てのページで目次を表示しない設定になっています。
固定ページに目次が表示されない時はこれが原因です。

確認事項３．見出しにHタグを使っているか？

これは初歩的なミスになりますが、見出しにHタグ以外（pタグなど）を使っていると「Easy Table of Contents」は目次の見出しとして認識しません。

例を挙げれば以下のような感じ…。

<!--以下のようならOK！-->
<h1>これはH1見出しです。</h1>
<h2>これはH2見出しです。</h2>
<h3>これはH3見出しです。</h3>
<!--以下のようならNG！-->
<p>これはH1見出しです。</p>
<p class="h2huu">これはH2見出しです。</p>
<span>これはH3見出しです。</span>

Wordpressでは特にブロックエディターやクラシックエディターのビジュアルモードを使っていると、知らず知らずのうちにhタグがpタグに変更されていることがあるので注意が必要です。

また、テーマ側で用意されたHタグ風の装飾がされたpタグもダメです。

以上、記事に目次が全く表示されない時は「表示条件の設定」「Hタグの使用数」「見出しがHタグか？」の３点を確認しましょう！