WordPressでショートコードをそのまま表示させる方法:メモ

地味に困ったことの解決策がコーデックスで書かれていたので、メモ的に記事にします。

さすがコーデックス。

実現したいこと

• 記事内でショートコードをそのまま書いて説明したい
• そのまま表示したいショートコードは動作させない

ちょっと分かりにくいですが、例えば以下のような表示を行うことです。

[gallery]

上記はWordPressで最初から登録されているショートコードのため、通常ではcodeで囲っても動作してしまいギャラリーが表示されます。

今回はこの動作をさせたくないという趣旨です。

実現する方法

以下のページに答えがありました。

• ショートコード API エスケープ

<code> 要素はいつも texturize 処理の対象外になります。

登録済みショートコードは <code> 要素の内側でも処理されます。登録済みショートコードを web サイトへ表示するためにエスケープする書き方は次のようになります:
[[caption param=”test”]]
… このように出力されます …

囲み型ショートコードの場合は次の構文を使ってください:

[[caption]My Caption[/caption]]

codeタグとの併用になりますが、この方法でエスケープできます。