当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

関数リファレンス/do shortcode

提供: WordPress Codex 日本語版
< 関数リファレンス
2015年6月12日 (金) 14:23時点におけるMiccweb (トーク | 投稿記録)による版 (使用法: 用例の追加)

移動先: 案内検索

ショートコード を探し、そのフックを使用してショートコードをフィルタします。

使用法

<?php echo do_shortcode( $content ) ?>

パラメーター

$content
文字列) (必須) ショートコード名
初期値: なし

戻り値

(文字列) 
ショートコードハンドラからの出力で置き換えられたショートコードの内容。

使用法

add_filter('the_content', 'do_shortcode', 11); // shortcodes.php より。
// ショートコードを PHP ファイル (投稿エディタの外) で使用する
echo do_shortcode('[gallery]');
// 開始と終了のショートコードがある場合。
echo do_shortcode('[iscorrect]'.$text_to_be_wrapped_in_shortcode.'[/iscorrect]');
// テキストウィジェットでショートコードを使用する
add_filter('widget_text', 'do_shortcode');
// Landing Page Template のようにショートコードを用いる場合。
echo do_shortcode('[contact-form-7 id="91" title="quote"]');
// Store the short code in a variable.
$var = do_shortcode( '[gallery]' );
echo $var;

例外が built in embed shortcode available with WordPress にある場合。 do_shortcodeを使ってショートコードを使うには, 以下のように記します:

$embedurl = 'http://yourembeddableurl.com';
if (!empty($embedurl)) {
       $var = apply_filters('the_content', "[embed]" . $embedurl . "[/embed]");
	echo $var;
}

ショートコードタグが定義されていない場合は、なにもフィルタせずに表示します。プラグインを無効化した場合に、ショートコードがそのまま表示されるかもしれません。

改訂履歴

  • 2.5.0にて導入されました。

ソースファイル

do_shortcode() は、wp-includes/shortcodes.php にあります。

ショートコード: do_shortcode(), add_shortcode(), remove_shortcode(), remove_all_shortcodes(), shortcode_atts(), strip_shortcodes(), shortcode_exists(), has_shortcode(), get_shortcode_regex(), wp_audio_shortcode(), wp_video_shortcode(), フィルター no_texturize_shortcodes /en


最新英語版: WordPress Codex » Function Reference/do shortcode 最新版との差分


関数リファレンステンプレートタグ目次もご覧ください。