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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(英文をコピペ。divタグと原文リンクつき)
 
(最新のマージ 141749}}<!-- 22:53, 9 March 2014‎ Jmlapam 版 -->)
 
(2人の利用者による、間の2版が非表示)
2行目: 2行目:
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
Checks whether the content passed contains a specific short code.
+
コンテントが特定のショートコードを渡すか否かをチェックする関数です。
 +
 
 +
The short code needs to be registered with add_shortcode() to be recognized.
  
 
<div id="Parameters">
 
<div id="Parameters">
 
== パラメータ ==
 
== パラメータ ==
 
</div>
 
</div>
{{Parameter|$content|string|The content to search.}}
+
{{Parameter|$content|文字列|検索するコンテント}}
{{Parameter|$tag|string|The short code to search for.}}
+
{{Parameter|$tag|文字列|検索されるショートコード}}
  
 
<div id="Return">
 
<div id="Return">
 
== 戻り値 ==
 
== 戻り値 ==
 
</div>
 
</div>
{{Return||Bool|True if the short code is found, false otherwise.}}
+
{{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.';
 +
//       ↑これはテキストです ($post->post_content から取り込まれたものなど) 。[gallery] ショートコードが含まれています。
 +
if( has_shortcode( $content, 'gallery' ) ) {
 +
    // コンテンツに [gallery] のショートコードが含まれているため、 true が返される。
  
$content = 'This is some text, perhaps pulled via $post->post_content. It has a [gallery] short code.';
 
 
if( has_shortcode( $content, 'gallery' ) ) {
 
    // The content has a [gallery] short code, so this check returned 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">
52行目: 71行目:
 
{{Shortcode Tags}}
 
{{Shortcode Tags}}
  
{{原文|Function Reference/has_shortcode|131161}}<!--  219:36, 17 May 2013 DrewAPicture 版 -->
+
{{原文|Function Reference/has_shortcode|141749}}<!--  22:53, 9 March 2014‎ Jmlapam 版 -->
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 
+
[[Category:wp3.6]]
[[Category:Functions]]
+
[[Category:New_page_created]]
+

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


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