in_category( int|string|int[]|string[] $category, int|object $post = null )

使用示例

• 示例1

  在循环外测试当前文章
  在请求单个文章（通常由single.php模板处理）的过程中，您甚至可以在循环开始之前测试该文章的类别。

  您可以使用此选项切换模板，如下所示：

  if ( in_category('fruit') ) {
  	include 'single-fruit.php';
  } elseif ( in_category('vegetables') ) {
  	include 'single-vegetables.php';
  } else {
  	// Continue with normal Loop
  	if ( have_posts() ) : while ( have_posts() ) : the_post();
  	// ...
  }
  

  （自定义文章模板插件允许为单个文章创建模板。它还展示了如何添加模板的示例，该模板用于给定类别中的所有文章，而不仅仅是单个文章。默认情况下，该示例在插件中被注释掉，但可以通过取消注释适当的行来轻松实现。）

• 示例2

  在循环中测试当前文章
  in_category()通常用于根据当前文章的类别在循环中采取不同的操作，例如：

  if ( in_category( 'pachyderms' )) {
  	// They have long trunks...
  } elseif ( in_category( array( 'Tropical Birds', 'small-mammals' ) )) {
  	// They are warm-blooded...
  } else {
  	// etc.
  }
  

• 示例3

  要检查文章是否在父类别或其任何子类别内，请执行以下操作：

  <?php
  /**
   * Tests if any of a post's assigned categories are descendants of target categories
   *
   * @param int|array $categories The target categories. Integer ID or array of integer IDs
   * @param int|object $_post The post. Omit to test the current post in the Loop or main query
   * @return bool True if at least 1 of the post's categories is a descendant of any of the target categories
   * @see get_term_by() You can get a category by name or slug, then pass ID to this function
   * @uses get_term_children() Passes $cats
   * @uses in_category() Passes $_post (can be empty)
   * @link originally at https://codex.wordpress.org/Function_Reference/in_category#Testing_if_a_post_is_in_a_descendant_category
   */
  
  if ( ! function_exists( 'wpdocs_post_is_in_a_subcategory' ) ) {
  function wpdocs_post_is_in_a_subcategory( $categories, $_post = null ) {
      foreach ( (array) $categories as $category ) {
          // get_term_children() only accepts integer ID
          $subcats = get_term_children( (int) $category, 'category' );
          if ( $subcats && in_category( $subcats, $_post ) )
              return true;
      }
      return false;
    }
  }
  ?>
  

  用于检查是否在单个cat内：

  wpdocs_post_is_in_a_subcategory( 25 );

  用于检查是否在父类别或其任何子类别的数组中：

  wpdocs_post_is_in_a_subcategory( array( 25, 28, 124, 297, 298, 299 ) );