为WordPress子分类自动设置指定的分类模版

创客云

这段时间开发了一个网站,网站里面,文章有两个级别的分类,其中父级分类是一个单独的模版,每个父级分类下面的二级分类用一个子分类模板,每个父级分类和子分类模版都是不一样的。这个需求最直接的方式是按照 WordPress 官方的教程,使用 “category-slug.php” 这样的模版文件,为每个分类指定模版。虽然能实现,但这是一个丑陋的实现方法,会导致每个子分类都要复制一个相同的模版。增加子分类的时候,还需要重再复制一次,产生了很多重复无意义的工作,后期维护起来也比较困难。

根据多年的 WordPress 开发经验,我们凭直觉认为,肯定会有更好的实现方法,于是我们做了一些研究和测试,发现可以用 category_template Filter 来很简单的实现这个需求,下面就是实现这个需求的代码。首先获取当前分类,如果当前分类的父级分类是指定的某个分类,尝试获取指定的分类模版,如果分类模版存在,返回指定的分类模版,如果不存在,返回默认的模版。

  1. add_filter( 'category_template', function ( $template )
  2. {
  3.    $term = get_queried_object();
  4.  
  5.    if ( $term->parent == 58 ) {
  6.       $new_template = locate_template( [ 'templates/archive/archive-topic.php' ] );
  7.  
  8.       if ( '' != $new_template ) {
  9.          return $new_template;
  10.       }
  11.    }
  12.  
  13.    return $template;
  14. }, 99 );

上面的代码为父级分类为 「58」 的子分类设置了 templates/archive/archive-topic.php 文件作为分类模版。如果需要为父级分类为 「68」 的子分类设置一个模版呢?把上面的 if 逻辑复制一次,修改其中的 「58」 和 「archive-topic.php」 就可以了。额,虽然笔文章开头的实现方法好了一些,但还是需要复制代码,并且使用分类 ID 作为指定分类的逻辑会有一些风险。

我们的目标是做国内最专业的 WordPress 服务商,我们追求的是不但要实现需求,并且要以最简洁有效、最有扩展性的方法来实现这个需求,并且要让客户用起来方便。于是更进了一步,我们改造了一下上面的代码。首先获取当前分类的顶级分类,如果顶级分类存在,尝试在 「templates/category/」 目录中寻找顶级分类对应的「category-顶级分类 slug.php」文件,如果文件存在,返回这个模版作为二级分类模版,如果不存在,返回默认模版。

  1. add_filter( 'category_template', function ( $template )
  2. {
  3.    $term      = get_queried_object();
  4.    $ancestors = get_ancestors( $term->term_id, 'category' );
  5.  
  6.    if ( ! empty( $ancestors ) ) {
  7.       $ancestor = get_term( $ancestors[ 0 ] );
  8.       $new_template = locate_template( [ 'templates/category/category-'. $ancestor->slug .'.php' ] );
  9.  
  10.       if ( '' != $new_template ) {
  11.          return $new_template;
  12.       }
  13.    }
  14.  
  15.    return $template;
  16. }, 99 );

这样一来,就方便多了,增加分类的时候,直接增加一个「category-顶级分类 slug.php」就可以设置子分类模版了,并且在迁移数据的时候,只要分类 Slug 不改变,就不需要修改代码来适配数据,操作方法和 WordPress 默认的指定模版方法类似。有需要的朋友,可以根据自己的需要改造以上代码。或者如果你有更好的实现,可以投稿过来,方便更多有需要的朋友。

本文由 CityMall 整理发布如需转载,请注明出处:https://www.22vd.com/47081.html
云模板

发表评论