WordPressの記事本文中にHTMLコメントタグを書くための設定

たとえば、次のような、「<>」を含むコメントを書くと、問題が発生してしまいます。

<!--
comment
<>
-->

これは、タグを丸ごとコメントアウトすることに相当し、広い範囲をコメントアウトするときによく該当してしまいます。

問題が発生するコメントを書いてしまうと、そのコメントの部分以降、すべてがコメントアウトになってしまいます。つまり、本文途中のコメントアウトをすると、そこより後ろの本文すべてが消えてしまうのです。

例のコメントアウトを保存して表示してみると、実際の表示の際に変換が挟まり、表示する際には、次のようなソースコードになってしまいます。

<!--
comment
<>
&#8211;>

つまり、コメントタグの閉じるためのタグが変換されてしまっているのです。これにより、コメントタグが終了しないので、問題が発生していたわけです。細かく見てみると、「ハイフン二つ」が「ハイフンの実体参照（&#8211）」に変換されてしまっています。この変換機能が原因というわけです。

ここから、良くある対策と、おすすめの対策を書きます。

よくあるのは、この機能を有効にしているコードをコメントアウトする方法です。具体的には、「wp-includes/default-filters.php」の

add_filter( 'the_content', 'wptexturize'        );

を、

// add_filter( 'the_content', 'wptexturize'        );

に書き換えます。これだけで、問題の原因になっていたコードの自動変換機能が停止します。ただし、この方法の場合、WordPressをアップデートすると、変更が元に戻ってしまい、再発しかねません。

おすすめの方法は、これと同じ効果のあるコードを、テーマの「functions.php」に書き加える方法です。次のようなコードを「functions.php」に書き加えてください。

remove_filter( 'the_content', 'wptexturize' );

こうすれば、WordPress本体のアップデートに巻き込まれることはありません（'wptexturize'の名前が変わるなどしてしまうとさすがに駄目ですが）。こちらのほうがおすすめですし、変更がすべて「functions.php」に並ぶおかげで、管理が容易です。

このような使う人によっては迷惑な自動変換はいろいろあるので、また紹介したいと思います。