• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(wp3.6 カテゴリ追加。細部修正。)
(最新のマージ 141749}}<!-- 22:53, 9 March 2014‎ Jmlapam 版 -->)
 
3行目: 3行目:
 
</div>
 
</div>
 
コンテントが特定のショートコードを渡すか否かをチェックする関数です。
 
コンテントが特定のショートコードを渡すか否かをチェックする関数です。
 +
 +
The short code needs to be registered with add_shortcode() to be recognized.
  
 
<div id="Parameters">
 
<div id="Parameters">
13行目: 15行目:
 
== 戻り値 ==
 
== 戻り値 ==
 
</div>
 
</div>
{{Return||Bool|ショートコードがある時 <tt>true</tt>。ない時 <tt>false</tt>。}}
+
{{Return||真または偽|ショートコードがある時 <tt>true</tt>。ない時 <tt>false</tt>。}}
  
 
<div id="Usage">
 
<div id="Usage">
23行目: 25行目:
 
== 用例 ==
 
== 用例 ==
 
</div>
 
</div>
 +
 +
===シンプルな例===
 
<pre>
 
<pre>
 
<?php
 
<?php
 
 
$content = 'This is some text, (perhaps pulled via $post->post_content). It has a [gallery] shortcode.';
 
$content = 'This is some text, (perhaps pulled via $post->post_content). It has a [gallery] shortcode.';
 
//       ↑これはテキストです ($post->post_content から取り込まれたものなど) 。[gallery] ショートコードが含まれています。
 
//       ↑これはテキストです ($post->post_content から取り込まれたものなど) 。[gallery] ショートコードが含まれています。
 
 
if( has_shortcode( $content, 'gallery' ) ) {
 
if( has_shortcode( $content, 'gallery' ) ) {
 
     // コンテンツに [gallery] のショートコードが含まれているため、 true が返される。
 
     // コンテンツに [gallery] のショートコードが含まれているため、 true が返される。
 +
 
}
 
}
  
 
?>
 
?>
 
</pre>
 
</pre>
 +
 +
===シンプルな例2===
 +
 +
Enqueue some script when some post uses some shortcode.
 +
 +
<pre>
 +
function custom_shortcode_scripts() {
 +
global $post;
 +
if( is_a( $post, 'WP_Post' ) && has_shortcode( $post->post_content, 'custom-shortcode') ) {
 +
wp_enqueue_script( 'custom-script');
 +
}
 +
}
 +
add_action( 'wp_enqueue_scripts', 'custom_shortcode_scripts');
 +
</pre>
 +
  
 
<div id="Change_log">
 
<div id="Change_log">
53行目: 71行目:
 
{{Shortcode Tags}}
 
{{Shortcode Tags}}
  
{{原文|Function Reference/has_shortcode|134008}}<!--  13:13, 3 August 2013 Djkaz  版 -->
+
{{原文|Function Reference/has_shortcode|141749}}<!--  22:53, 9 March 2014‎ Jmlapam 版 -->
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 
[[Category:wp3.6]]
 
[[Category:wp3.6]]

2015年8月15日 (土) 15:40時点における最新版

コンテントが特定のショートコードを渡すか否かをチェックする関数です。

The short code needs to be registered with add_shortcode() to be recognized.

パラメータ

$content
文字列) (必須) 検索するコンテント
初期値: なし
$tag
文字列) (必須) 検索されるショートコード
初期値: なし

戻り値

(真または偽) 
ショートコードがある時 true。ない時 false

使い方

<?php if ( has_shortcode( $content, 'gallery' ) ) { } ?>

用例

シンプルな例

<?php
$content = 'This is some text, (perhaps pulled via $post->post_content). It has a [gallery] shortcode.';
//       ↑これはテキストです ($post->post_content から取り込まれたものなど) 。[gallery] ショートコードが含まれています。
if( has_shortcode( $content, 'gallery' ) ) {
    // コンテンツに [gallery] のショートコードが含まれているため、 true が返される。

}

?>

シンプルな例2

Enqueue some script when some post uses some shortcode.

function custom_shortcode_scripts() {
	global $post;
	if( is_a( $post, 'WP_Post' ) && has_shortcode( $post->post_content, 'custom-shortcode') ) {
		wp_enqueue_script( 'custom-script');
	}
}
add_action( 'wp_enqueue_scripts', 'custom_shortcode_scripts');


変更履歴

3.6.0にて導入されました。

ソースファイル

has_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/has_shortcode最新版との差分


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