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

「関数リファレンス/do shortcode」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(12:37, 1 September 2013 Djkaz 版 に更新。各セクションにdivタグを埋め込み)
(使用法: 用例の追加)
22行目: 22行目:
 
== 使用法 ==
 
== 使用法 ==
 
</div>
 
</div>
 +
 
  add_filter('the_content', 'do_shortcode', 11); // shortcodes.php より。
 
  add_filter('the_content', 'do_shortcode', 11); // shortcodes.php より。
  
35行目: 36行目:
 
  // Landing Page Template のようにショートコードを用いる場合。
 
  // Landing Page Template のようにショートコードを用いる場合。
 
  echo do_shortcode('[contact-form-7 id="91" title="quote"]');
 
  echo do_shortcode('[contact-form-7 id="91" title="quote"]');
 +
 +
<pre>
 +
// Store the short code in a variable.
 +
$var = do_shortcode( '[gallery]' );
 +
echo $var;
 +
</pre>
 +
 +
例外が [[Embeds|built in embed shortcode available with WordPress]] にある場合。
 +
<code>do_shortcode</code>を使ってショートコードを使うには, 以下のように記します:
 +
 +
<pre>$embedurl = 'http://yourembeddableurl.com';
 +
if (!empty($embedurl)) {
 +
      $var = apply_filters('the_content', "[embed]" . $embedurl . "[/embed]");
 +
echo $var;
 +
}</pre>
  
 
<div id="Notes">
 
<div id="Notes">
 +
 
== 注 ==
 
== 注 ==
 
</div>
 
</div>

2015年6月12日 (金) 14:23時点における版

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

使用法

<?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 最新版との差分


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