WordPressテーマ「Cocoon」は、標準で高機能な目次機能が備わっています。しかし、稀に「目次が表示されない」という謎の不具合に直面することがあります。
今回は、一般的なチェックリストから、私が最終的に解決に至った「テーマの再インストール」まで、解決の手順をまとめました。
基本設定をクイックチェック
以下の3点は、まず最初に確認すべき「よくある原因」です。
- 見出しの数： H2などの見出しが2つ以上あるか？
- Cocoon設定： [目次]タブの「目次を表示する」にチェックがあるか？
- ショートコード： 本文中に ［toc］ と入力しても表示されないか？
一般的な対処法でダメな場合
基本設定に問題がない場合、以下のような「見えない干渉」を疑います。
- プラグインの競合： 他の目次プラグインやキャッシュプラグインが邪魔をしていないか。
- CSSによる非表示： カスタマイズしたCSSで
display: none;が目次に当たっていないか。 - JavaScriptの不具合： 他のツールと干渉して目次の生成コードが止まっていないか。
これらを一つずつ停止・確認しても改善しない場合、テーマのシステム自体に何らかの不具合が生じている可能性があります。
【最終手段】Cocoonの再インストール
あらゆる設定を試してもダメだった場合、Cocoon本体（親テーマ・子テーマ）の再インストールが有効です。これにより、破損したファイルの修復や、内部的な設定の初期化が行われ、正常に表示されるようになります。
- バックアップをとる： 万が一のため、サイト全体のバックアップを推奨します。
- 一時的に別のテーマに変える： 「外観」＞「テーマ」から、一時的にTwenty Twenty-Fiveなどのデフォルトテーマを有効化します。
- Cocoon（親テーマ・子テーマ）を削除： Cocoonのテーマを一度削除します。
- 公式サイトから最新版をダウンロード： Cocoon公式サイトから親テーマ・子テーマのZIPファイルを再入手します。
- 新規インストール＆有効化： 再度インストールし、有効化します。
結果： 私の環境では、この手順で何も変更していないはずの目次がパッと表示されるようになりました。
まとめ：諦める前に再インストールを
設定画面と数時間格闘するよりも、一度リセットしたほうが早く解決する場合があります。 「何をやっても目次が出ない！」と頭を抱えている方は、テーマの入れ直しという選択肢も検討してみてください。
WordPressの概要を知りたいなら、Webサイト制作の基礎知識体系的に学べるこちらの本がおすすめです！
リンク
コメント