プラグイン

table of contents plusとtag groupsはぶつかる

table of contents plusとtag groupsはぶつかることがわかった。
原因を突き止めたのでメモ。

ちなみに、table of contents plusというのは、記事中にこんな感じで目次を自動表示。

toc-image

tag groupsは、タグ（カテゴリーやカスタムタクソノミーを含む）をグループ化する機能を追加し、そのタグクラウドを記事中やサイドバーに表示させることができる。

taggroups

両方ともとても便利で有意義なプラグインで、コンサデコンサで使用中。

【環境】
Wordpress 4.1-ja
table of contents plus 1408
tag groups 0.16

【現象】
table of contents plusプラグインを導入したところ、table of contents plusによるテーブル（目次）が表示されないページがあった。

【原因】
tag groupsプラグインとぶつかっている。
それもかなり特殊な条件で。

【トラブルが起きる条件】
以下の条件を満たすと、該当ページ内でのみtable of contents plusによる目次が表示されない。
この時、tag groupsプラグインによるタグ表示や、table of contents plus widgetによるサイドバーでの表示は影響を受けず、ちゃんと表示される。

  1. table of contents plusとtag groupsをインストール、有効化している。
  2. tag groupsプラグインで、ページ内にタグクラウド（カテゴリー）を表示させている。
  3. 表示させているタグ（カテゴリー）の中に説明文を記述しているタグ（カテゴリー）がある。

三番目の条件がキモ。これによって、表示されるかどうかが決まる。

タグ（カテゴリー）の中の説明文というの以下のようなもの。

toc-tg-conflict

管理画面のタグ（カテゴリー）のリストで確認できる。tag groupsプラグインによ手表示されたタグクラウドはタグの説明文もマウスオーバーによって表示されるのだが、どうもマルチバイト文字には対応していないようで、従来より文字化けしていた。その文字化けによって、変なコードとして認定されて、table of contents plusのテーブルがうまく表示できていないのではな以下と推測される。

【対応】
プログラムを書き換えるほどの能力はないので、以下のような方法を採用するしかない。
・該当ページでのtag groupsによるタグクラウドの表示をやめる。
・該当ページでの問題のあるタクソノミー（タグ）の表示をやめる。
・該当するタクソノミー（タグ）の説明文を空欄にする。

など。

記事の共有：