背景

WordPress では、あらかじめ登録してある PHP の関数を呼び出せる「[」と「]」を用いたショートコードという機能があります。

こちらの記事でショートコードの作り方は説明したのですが、ショートコードで文字列を囲んで渡す方法について今回は記事にしてみました。

コード

とりあえず、次のコードを functions.php に追加します。
[code lang=’php’] function showcontent_func($atts, $content = null) {
return “→{$content}←”;
}
add_shortcode(‘showcontent’, ‘showcontent_func’);
[/code]

続いて投稿や固定ページに次のコードを書き、表示してみましょう。
[code lang=’text’] [showcontent]中身だよ！[/showcontent] [/code]

こんな感じで見えると思います。
[code lang=’text’] →中身だよ！←
[/code]

解説

ここでのポイントは、第2引数です。

第1引数にはショートコードへ渡された引数が連想配列で含まれますが、第2引数はショートコードで囲われた文字列が渡されます。

注意点としては、ショートコードへの引数は通常 shortcode_atts() によってチェックしますが、第2引数はそのチェック機能がありません。
そのため、引数のデフォルト値として null を渡すようにしてあります。

参考：
・ショートコードAPI – WordPress Codex

応用

ショートコード内に書かれたショートコードは、そのままでは機能しません。
例えば次の様なコードは、内側のショートコード(innnercode)は無視され、外側のショートコード(showcontent)しか動かないと言うことです。

この様にネストされたコードを実行するようにするためには、次の様にショートコードの定義で do_shortcode() 関数を呼び出すようにします。

参考：
・do_shortcode()

まとめ

囲み型ショートコードを使う事で、応用の範囲が大きく広がることがわかりますね。