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

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

「関数リファレンス/cat is ancestor of」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連: {{原文|Function_Reference/cat is ancestor of|77153}}<!-- 21:38, 16 August 2009‎ Ramiy -->)
(最新のマージ 148839}}<!-- 17:37, 29 December 2014‎ Dudd -->)
17行目: 17行目:
  
 
== 用例 ==
 
== 用例 ==
 +
 +
This example, placed in a theme's archive.php, uses [[Conditional Tags]] to show different content depending on the category being displayed.  This is helpful when it is necessary to include something for any child category of a given category, instead of using ''category-slug.php'' method where you'd have to create ''category-slug.php'' files for each and every category.
 +
 +
The code snip below checks to see if the category called 'Music' (ID 4) is being processed, and if so, presents a [[Function Reference/wp_nav_menu|wp_nav_menu]] for the Music archive page, and any subcategories of Music (e.g. jazz, classical.)
 +
 +
<pre>
 +
<?php
 +
  // if the category is music or a music SUBcategory,
 +
  if (cat_is_ancestor_of(4, $cat) or is_category(4)):  ?>
 +
  <div id="music_subnav_menu" class="subnav_menu">
 +
    <?php wp_nav_menu( array('menu' => 'Music' )); ?>
 +
  </div>
 +
<?php endif; ?>
 +
</pre>
 +
  
 
== 注 ==
 
== 注 ==
33行目: 48行目:
  
 
== 関連 ==
 
== 関連 ==
 +
 +
{{NeedTrans|一部}}
  
 
{{Conditional Tags}}
 
{{Conditional Tags}}
38行目: 55行目:
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文|Function_Reference/cat is ancestor of|77153}}<!-- 21:38, 16 August 2009‎ Ramiy -->
+
{{原文|Function_Reference/cat is ancestor of|148839}}<!-- 17:37, 29 December 2014‎ Dudd  -->
  
 
[[Category:条件分岐タグ]]
 
[[Category:条件分岐タグ]]
  
 
[[en:Function_Reference/cat_is_ancestor_of]]
 
[[en:Function_Reference/cat_is_ancestor_of]]

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

説明

この条件分岐タグは、カテゴリーが他のカテゴリーの「先祖」カテゴリーであるかどうかをチェックします。真偽値を返す関数のため、TRUEまたはFALSE値を返します。

使い方

<?php cat_is_ancestor_of( $cat1, $cat2 ); ?>

パラメータ

$cat1
int/object) (必須) 親かどうかをチェックしたいカテゴリーの、カテゴリーIDまたはカテゴリーオブジェクト
初期値: なし
$cat2
int/object) (必須) 子カテゴリー
初期値: なし

戻り値

(boolean) 
cat1がcat2の親または先祖である場合はTRUE、そうでない場合はFALSE

用例

This example, placed in a theme's archive.php, uses Conditional Tags to show different content depending on the category being displayed. This is helpful when it is necessary to include something for any child category of a given category, instead of using category-slug.php method where you'd have to create category-slug.php files for each and every category.

The code snip below checks to see if the category called 'Music' (ID 4) is being processed, and if so, presents a wp_nav_menu for the Music archive page, and any subcategories of Music (e.g. jazz, classical.)

<?php 
  // if the category is music or a music SUBcategory, 
  if (cat_is_ancestor_of(4, $cat) or is_category(4)):  ?>
  <div id="music_subnav_menu" class="subnav_menu">
    <?php wp_nav_menu( array('menu' => 'Music' )); ?>
  </div>
<?php endif; ?>


  • この関数は、2番目に指定したカテゴリーが1番目に指定したカテゴリーの子または子孫であるかどうかを評価します。
  • どれほど遠いレベルの先祖であっても、TRUEを返します。
  • パラメータの値は整数値またはオブジェクトでなければなりません。もしパラメータに整数値ではなく、文字表現された整数を指定した場合、cat_is_ancestor_ofはFALSEを返します。

変更履歴

2.1.0より

ソースファイル

cat_is_ancestor_of() は、wp-includes/category.phpに含まれています。

関連

このページ「関数リファレンス/cat is ancestor of」は一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

条件分岐タグ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/cat is ancestor of最新版との差分