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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/has_term 22:09, 30 January 2014 Pmciano 版を流し込み。)
 
(説明を少し詳しくしました。)
 
(同じ利用者による、間の1版が非表示)
1行目: 1行目:
{{NeedTrans}}
+
<div id="Description">
 +
== 説明 ==
 +
</div>
 +
現在の投稿(または指定された投稿)が指定されたタームを持っているかチェックします。
  
== Description ==
+
指定されたタームは、投稿に付けられたタームの ID、名前、スラッグに合うかチェックされます。
Check if the current post has any of the given terms.
+
整数で指定されたタームは、投稿のタームの ID のみと比較されます。
  
The given terms are checked against the post's terms' term_ids, names, and slugs. Terms given as integers will only be checked against the post's terms' term_ids.
+
タームが指定されない場合は、投稿が任意のタームを持つかチェックします。
  
If no terms are given, determines if post has any terms.
+
<div id="Usage">
 
+
== 使い方 ==
== Usage ==
+
</div>
 
  <?php has_term( $term, $taxonomy, $post ) ?>
 
  <?php has_term( $term, $taxonomy, $post ) ?>
  
== Parameters ==
+
<div id="Parameters">
{{Parameter|$term|string&#124;integer&#124;array|The term name/term_id/slug or array of them to check for.|optional|&#39;&#39;}}
+
== パラメータ ==
{{Parameter|$taxonomy|string|Taxonomy name|required|&#39;&#39;}}
+
</div>
{{Parameter|$post|integer&#124;object|Post to check instead of the current post.|optional|null}}
+
{{Parameter|$term|文字列&#124;整数&#124;配列|チェックするタームの名前、ID、スラッグ、またはそれらの配列。|オプション|<tt><nowiki>''</nowiki></tt>}}
 +
{{Parameter|$taxonomy|文字列|タクソノミーの名前}}
 +
{{Parameter|$post|整数&#124;オブジェクト|チェックする投稿の ID または投稿オブジェクト。|オプション|<tt>null</tt> - 現在の投稿}}
  
== Return Values ==
+
<div id="Return_Values">
; (boolean) : True if the current post has any of the given terms (or any term, if no term is specified).
+
== 戻り値 ==
 +
</div>
 +
; (真偽値) : 指定されたタームの何れかを(タームが指定されなかった場合は、任意のタームを)投稿が持っていれば <code>true</code> を返す。
  
== Examples ==
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
 
<!-- Need creative examples. Feel free to link to external examples. -->
 
<!-- Need creative examples. Feel free to link to external examples. -->
  
 
<pre>
 
<pre>
 
if( has_term( 'jazz', 'genre' ) ) {
 
if( has_term( 'jazz', 'genre' ) ) {
     // do something
+
     // カスタム分類 genre のターム jazz が付いている投稿
 
}
 
}
 
</pre>
 
</pre>
  
== Notes ==
+
<div id="Notes">
 +
== 参考 ==
 +
</div>
 +
<!-- 特に無し -->
  
== Change Log ==
+
<div id="Change_Log">
Since: 3.1.0
+
== 変更履歴 ==
 +
</div>
 +
* [[Version 3.1|3.1.0]] : 新規導入。
  
== Source File ==
+
<div id="Source_File">
<tt>has_term()</tt> is located in {{Trac|/wp-includes/category-template.php}}.
+
== ソースファイル ==
 
+
</div>
== Related ==
+
<tt>has_term()</tt> {{Trac|/wp-includes/category-template.php}} にあります。
<!--
+
    To Do:
+
    Need to find related functions.
+
    Need to create groups of functions and create templates to add them to a page quickly.
+
    Some functions may be related to many groups of functions.
+
-->
+
  
 +
<div id="Related">
 +
== 関連項目 ==
 +
</div>
 +
{{Term Tags}}
 
{{Conditional Tags}}
 
{{Conditional Tags}}
<br />
 
{{Term Tags}}
 
  
 
{{Tag Footer}}
 
{{Tag Footer}}
53行目: 63行目:
  
 
{{DEFAULTSORT:Has_term}}
 
{{DEFAULTSORT:Has_term}}
[[Category:Conditional Tags]]
+
[[Category:条件分岐タグ]]
[[Category:Functions]]
+
[[Category:関数]]
 +
[[Category:タクソノミー]]
  
 
[[en:Function Reference/has_term]]
 
[[en:Function Reference/has_term]]
 
[[it:Riferimento funzioni/has_term]]
 
[[it:Riferimento funzioni/has_term]]

2015年4月25日 (土) 22:13時点における最新版

現在の投稿(または指定された投稿)が指定されたタームを持っているかチェックします。

指定されたタームは、投稿に付けられたタームの ID、名前、スラッグに合うかチェックされます。 整数で指定されたタームは、投稿のタームの ID のみと比較されます。

タームが指定されない場合は、投稿が任意のタームを持つかチェックします。

使い方

<?php has_term( $term, $taxonomy, $post ) ?>

パラメータ

$term
文字列|整数|配列) (オプション) チェックするタームの名前、ID、スラッグ、またはそれらの配列。
初期値: ''
$taxonomy
文字列) (必須) タクソノミーの名前
初期値: なし
$post
整数|オブジェクト) (オプション) チェックする投稿の ID または投稿オブジェクト。
初期値: null - 現在の投稿

戻り値

(真偽値) 
指定されたタームの何れかを(タームが指定されなかった場合は、任意のタームを)投稿が持っていれば true を返す。

用例

if( has_term( 'jazz', 'genre' ) ) {
    // カスタム分類 genre のターム jazz が付いている投稿
}

参考

変更履歴

  • 3.1.0 : 新規導入。

ソースファイル

has_term()/wp-includes/category-template.php にあります。

タームタグ: is_term(), term_exists(), get_objects_in_term(), get_term(), get_term_by(), get_term_children(), get_term_link(), get_terms(), get_the_terms(), get_the_term_list(), has_term(), sanitize_term(), the_terms(), get_object_taxonomies() is_object_in_taxonomy() the_taxonomies() wp_get_object_terms(), wp_set_object_terms(), wp_get_post_terms(), wp_set_post_terms(), wp_delete_object_term_relationships()


条件分岐タグis_404(), is_admin(), is_admin_bar_showing(), is_archive(), is_attachment(), is_author(), is_category(), is_comments_popup(), is_date(), is_day(), is_feed(), is_front_page(), is_home(), is_local_attachment(), is_main_query, /is_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network() /en, is_plugin_inactive() /en, is_plugin_page() /en, is_post_type_archive(), is_preview() /en, is_search(), is_single(), is_singular(), is_sticky(), is_tag(), is_tax(), is_taxonomy_hierarchical(), is_time(), is_trackback(), is_year(), in_category(), in_the_loop(), is_active_sidebar(), is_active_widget(), is_blog_installed() /en, is_rtl(), is_dynamic_sidebar(), is_user_logged_in(), has_excerpt(), has_post_thumbnail(), has_tag(), pings_open(), email_exists(), post_type_exists(), taxonomy_exists(), term_exists(), username_exists() /en, wp_attachment_is_image(), wp_script_is()



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


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