cat_is_ancestor_of

Posted on by Eternal-tears
Sponsored Link

カテゴリーが別のカテゴリーの祖先の場合、この条件タグはチェックします。これはboolean関数であり、TRUEまたはFALSEのいずれかを返します。

Sponsored Link

This Conditional Tag Check if a category is an ancestor of another category. This is a boolean function, meaning it returns either TRUE or FALSE.

cat_is_ancestor_ofのファンクションタグ使用方法

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

cat_is_ancestor_ofのパラメーター

$cat1

(int/object) (required)親カテゴリーがある場合にチェックするためのIDあるいはオブジェクトです。
デフォルト：なし

(int/object) (required) ID or object to check if this is the parent category.
Default: None

$cat2

(int/object) (required) 子カテゴリー。
デフォルト：なし

(int/object) (required) The child category.
Default: None

戻り値

(boolean) Trueの場合、cat1はcat2の祖先で、ない場合はFalseを返します。

(boolean)
True if cat1 is an ancestor of cat2, False if not.

例

この例は、テーマのarchive.phpに置かれ、表示されているカテゴリーに応じて異なるコンテンツを表示するために条件タグを使用します。これは取得したカテゴリーの特定のカテゴリーの幾つかをインクルードする必要がある時に便利です。category-slug.phpメソッドを使用する代わりに、ありとあらゆるカテゴリーにcategory-slug.phpファイルを作成しなければなりません。

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.

下記のコードスニップは、
‘Music’ (ID 4)と呼ばれるカテゴリーが処理されているか参照するためにチェックし、そうであれば、音楽（例えばジャズ、クラッシック）の任意のカテゴリーである音楽アーカイブページにwp_nav_menuを提示します。

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; ?>

注意

  • 第二カテゴリーが最初のカテゴリーの子である場合、この関数は判断します。
  • 先祖の任意のレベルはTrueを返します。
  • 整数あるいはオブジェクトのいずれかになる引数は、引数が整数の文字列で表現され、真の整数でないcat_is_ancestor_ofはFalseを返します。
  • The function evaluates if the second category is a child of the first category.
  • Any level of ancestry will return True.
  • Arguments should be either integer or objects, If arguments are string representations of integers and not true integers cat_is_ancestor_of will return False.

変更ログ

Since: 2.1.0

ソースファイル

cat_is_ancestor_of()は、wp-includes/category.php内に位置しています。

cat_is_ancestor_of() is located in wp-includes/category.php.

関連ファンクションタグ

Conditional Tags: comments_open(), 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_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network(), is_plugin_inactive(), is_plugin_page(), is_post_type_archive(), is_preview(), 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(), 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(), wp_attachment_is_image(), wp_script_is()

Sponsored Link