判断 WordPress 文章是否归属特定分类

我们在进行 WordPress 主题开发时,有时会遇到这样的要求,就是判断某些文章是否归属特定分类,那么就会用…

我们在进行 WordPress 主题开发时,有时会遇到这样的要求,就是判断某些文章是否归属特定分类,那么就会用到函数:in_category() 这个函数,简单地说,in_category() 是一个布尔函数,作用是检查当前或者指定页面是否归属于某个指定的分类,通常用于给不同的分类目录设置不同的文章模板。

值得注意的是:in_category()考虑只有一篇文章的类别被直接分配(检查类别在写/编辑文章面板),而不是指定类别的父分类(请看下面的重点:如果一篇文章在后代分类下)。在循环内部,这个标签可以用来测试当前的文章;或在循环外的单篇文章请求。如果您指定你想要测试的那篇文章,可以在任何地方使用它。

用法

  1. <?php in_category( $category, $_post ) ?>

参数

$category

(混合的)(必选的)一个或多个被指定分类 ID,分类别名或 slug,或一个数组。

默认: 无

$_post

(混合的)(可选的)文章,默认为在主循环内的当前文章或在主查询中的文章。

默认: 无
概述中已经说了这个函数是布尔函数,所以它返回的值要么是真(True),要么是假(False),某篇文章是否属于特定的分类。

举例

在循环内测试当前文章 in_category 函数通常用于主循环中,根据当前文章的类别采取不同的行动,例如:

  1. < ?php
  2. if ( in_category( 'internet' )) {
  3. // 如果这篇文章属于internet分类,此处添加要执行的内容。
  4. } elseif ( in_category( array( 'ec', 'tmt' ) )) {
  5. // 如果这篇文章同时属于ec和tmt分类,此处添加要执行的内容。
  6. } else {
  7. // 添加默认动作,也可以不要。
  8. }
  9. ?>

在循环外测试当前文章,如果你要实现一种功能,根据不同的分类调取不同的模板,不妨试试下面的这个示例:

  1. < ?php
  2. if (  in_category(1) ) {
  3. include 'single-1.php';
  4. } elseif ( in_category('ec') ) {
  5. include 'single-ec.php';
  6. } else {
  7. include 'single-default.php';
  8. }
  9. ?>

重点

测试如果一篇文章在后代分类下,这里要注意的是,in_category()函数只能指定一级目录,如果该目录有子孙目录则无效。如”fruits”下还有子目录’apples’, ‘bananas’, ‘cantaloupes’, ‘guavas’,则需全部目录列出来:

  1. <?php if ( in_category( array( 'fruits', 'apples', 'bananas', 'cantaloupes', 'guavas' /*etc*/ ) )) {
  2.     // These are all fruits
  3. }
  4. }
  5. ?>

但是每次你移去或添加任何水果类别,你都不得不编辑代码。更灵活的方法是使用或适应下面定义的 post_is_in_descendant_category 函数(在使用它之前,你需要复制下面的自定义函数到一个模板,插件,或主题函数文件):一般把此代码放入主题函数文件 functions.php

  1. <?php
  2. if ( ! function_exists( 'post_is_in_descendant_category' ) ) {
  3.     function post_is_in_descendant_category( $cats, $_post = null ) {
  4.         foreach ( (array) $cats as $cat ) {
  5.             // get_term_children() accepts integer ID only
  6.             $descendants = get_term_children( (int) $cat, 'category' );
  7.             if ( $descendants && in_category( $descendants, $_post ) )
  8.                 return true;
  9.         }
  10.         return false;
  11.     }
  12. }
  13. ?>

然后可以跟 in_category()一起使用,调用 post_is_in_descendant_category()函数来指定某目录下的所有子孙目录的文章页都使用某个模板:

  1. <?php if ( in_category( 'fruit' ) || post_is_in_descendant_category( 'fruit' ) ) {
  2.     // These are all fruits…
  3. }
  4. ?>
类别:WordPress教程

本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。

评论 (0)COMMENT

登录 账号发表你的看法,还没有账号?立即免费 注册