WordPress

WordPress ショートコードをエスケープする方法

投稿日:2017年8月18日 更新日:

Wordpress Logo

ショートコードを使っているプラグインは結構あります。Table of Contents PlusやPz-LinkCardなどがそうです。さて、これらのショートコードを投稿に載せるときにどうしていますか?[toc]を文字として打ち出そうとすると目次に変換されてしまって困ったりしていませんか?エスケープするのにはどうすればよいのでしょうか?

komatta_man2

知ってる人にとっては本当にくだらない内容と思います。しかし、知らない人もいるのです。

<スポンサーリンク>

ショートコードとは?

半角のカッコで括られた命令のようなものです。編集している間はただの文字ですが、公開する際に準備されたコードによって意味のある文字列に変換されます

例えば、Table of Contents Plusでは以下のようなショートコードを用いています。

[toc]

[toc heading_levels=2]

何が問題なのか?

文字列として”[”と”]”で括られているものをショートコードと認識します。もちろん括弧の中の文字は定められている文字列です。それらは置換されてしまうので、[toc]のように文字として打ち出す際にエスケープしてあげる必要があります。

前述しているような  [toc] は当たり前のように表示されていますが、普通に[toc]と書いてしまうと、目次に変換されます。従って、

”ショートコードは[toc]のように書くのです!”

のような文章を書くのが難しいのです。

 

もちろん最初は私もわからなくて、超悩みました。

 

あるサイトではきちんと[toc]のように表示されていたり、よくよく見るとそれは画像だったりしていました。

もちろん、私の投稿はきちんと文字になっています。よければご覧ください。

<code></code>でエスケープできるんじゃないのか?

できないんですね。

私も最初は深く考えずにこんな感じにやってみました。

<code>[toc]</code>

見事にエスケープされず、目次になりました。しかし、これが正解なのではないかと思って、これで結構粘りましたね。(苦)

&とか付ければいいんじゃないの?

さすがにこれが正解だとは思いませんでしたが・・・

 

一応、やってみました。

 

もちろんできませんでした。(汗)

エスケープの正解はこれだ

正解はこれです。

[[toc]]

きちんと調べれば書いてあるんです。

WordPress Codex日本語版 ショートコード

中段ぐらいに以下の記載があります。

投稿の中でふつうはショートコードを表す文字列をただの文字列として使いたい場合があります。そうするには1組ではなく2組のかぎかっこを使ってショートコードをエスケープする必要があります。例えば次のように投稿内に表示するには:

[gallery]

次のように書きます:

[[gallery]]

開始タグと終了タグを持つショートコードの場合は、一番最初と一番最後のかぎかっこをエスケープする必要があります:

[[shortcode] … [/shortcode]]

引用元:WordPress Codex 日本語版 ショートコードより

もちろん、上記の引用もそのままコピー&ペーストすると括弧が足りない(gallery で変換されてしまう)ので、括弧[]を足してあげています。

追記:2017/08/24

開始タグと終了タグを持つショートコードの場合、こちらの表記の方が正しいかもしれません。

[[[shortcode] … [/shortcode]]]

<スポンサーリンク>

まとめ

最初はわからないのは当たり前なので恥ずかしいことではないのです。

しかし、意外にこのような常識がわからなかったりもするのです。この投稿見て”ハッ!”とする人もいるんじゃないかと思っています。

そして、こういうニッチな話はネットで見つけにくかったりします。実際に私はこの情報に中々当たりませんでした。

  • ショートコードをエスケープしたい場合は括弧を重ねる
  • <code></code>で囲ってもエスケープできない

お役に立てば嬉しいです。

-WordPress
-

執筆者:

<スポンサーリンク>

comment

メールアドレスが公開されることはありません。

*

関連記事

Glue-eye

【AMP対応】Glue for Yoast SEO & AMP の使い方

AMP対応にGlue for Yoast SEO & AMPを採用しました。Glue for Yoast SEO & AMPは”AMP”プラグインを補佐する位置づけにあります。本稿では”AMP…

もっと見る

head

【AMP】Google Analyticsに表示されるusqp=mq331の意味は何?

AMP対応をして、Google Analyticsを確認するとURLの語尾にusqp=mq331xxxが付いたアクセスを確認できます。このアクセスはいったい何なのか最初は困惑しました。調べてみて、スパ…

もっと見る

portsoy

WordPress リンク切れチェック Broken Link Checker

「あ、このリンク切れてた」なんてことありませんか?この Broken Link Checker はそんなリンク切れをチェックしてくれるプラグインです。入れてあげるだけで、URLや画像に対するリンク切れ…

もっと見る

puzzle

【超初心者向け】 ブログ開設の11の手順

ブログを開設してから早くも5ヵ月経ちました。一旦、ここらで何をやってきたのかをまとめてみようかと思います。これから開設する方や、ブログ開設直後の方には参考になると思います。ざっくりと書いていきますが、…

もっと見る

サイト内の検索はこちらから

サイト内の検索はこちらから

サイト内の検索はこちらから

カテゴリー

アーカイブ

最近の投稿
Scroll Up