説明
string function do_shortcode( string $content [ , bool $ignore_html = false ] )
文字列に含まれるショートコードを変換する。
パラメータ
- $content投稿記事などの文字列。
- $ignore_html[4.2.3]HTML要素内のショートコードを実行しない場合はtrueを、実行する場合はfalseを指定（省略時はfalse）。
返り値
ショートコードが変換された文字列を返す。注意
このdo_shortcode関数は、 the_content関数のフィルターとして使用されており、投稿記事を表示する際に自動的に実行されている。ショートコードは投稿記事以外でも使用でき、 add_filter関数を使用するか、テーマやプラグイン内で実行することで、任意の文字列を対象にショートコードを変換することができる。また囲み型ショートコードでそのコンテントの中にショートコードを含める（ショーコードが入れ子になる）場合には、ショートコード関数の返り値を返す直前で本関数を呼び出す。
function shortcode_example_func( $atts, $content='' ) {
// $contentを適宜処理
return do_shortcode( $content );
}
add_shortcode( 'exp', 'shortcode_example_func' );
[4.2.3]HTML要素（コメントを除く）内のショートコードを先に実行する。
[4.2.3]ショートコードの実行結果を返す前に無効なショートコードのアンエスケープ処理を行う。
使用例
- ショートコードを変換する。<?php $decoded = do_shortcode( $content ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/shortcodes.php最終更新 : 2020年04月02日 11:21
関連
お勧め
カテゴリー専用の投稿一覧と新規投稿メニューを追加する（2012年1月23日 更新）
サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。ブロックエディターの文字サイズ設定を変えてみる（2019年12月12日 更新）
今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。
4.2で始まるiOSの絵文字ケア（2018年5月27日 更新）
WordPress 4.2のベータ1、ベータ2が立て続けにリリースされ、4.2の正式版リリースが近づいています。4.2のポイントの1つは絵文字のクロスブラウザ対応です。ここでの絵文字とは、UTF-8で4バイトのコードが割り当てられている（基本的にはiOSの）絵文字を指します。この絵文字を含んだ投稿が正しく保存できなかったり、iOS以外の環境で意図した通りに表示できないといった問題があり、4.2ではそのような問題を対処をコードが組み込まれています。
「不明な書式」って何ですか。（2024年11月13日 更新）
オートコンプリート機能を利用して四字熟語を挿入するプラグインを作った際、ツールバーに「不明な書式をクリア（Clear Unknown Formatting）」ボタンが表示されるようになった。この「書式」、何を指しているのかわからないんだが。
決まった値を返すだけの関数群（2018年5月27日 更新）
WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。