这段时间开发了一个网站,网站里面,文章有两个级别的分类,其中父级分类是一个单独的模版,每个父级分类下面的二级分类用一个子分类模板,每个父级分类和子分类模版都是不一样的。这个需求最直接的方式是按照 WordPress 官方的教程,使用 “category-slug.php” 这样的模版文件,为每个分类指定模版。虽然能实现,但这是一个丑陋的实现方法,会导致每个子分类都要复制一个相同的模版。增加子分类的时候,还需要重再复制一次,产生了很多重复无意义的工作,后期维护起来也比较困难。
通过 category_template Filter 自动指定子分类模版
根据多年的 WordPress开发经验,我们凭直觉认为,肯定会有更好的实现方法,于是我们做了一些研究和测试,发现可以用 category_template Filter 来很简单的实现这个需求,下面就是实现这个需求的代码。首先获取当前分类,如果当前分类的父级分类是指定的某个分类,尝试获取指定的分类模版,如果分类模版存在,返回指定的分类模版,如果不存在,返回默认的模版。
add_filter( 'category_template', function ( $template )
{
$term = get_queried_object();
if ( $term->parent == 58 ) {
$new_template = locate_template( [ 'templates/archive/archive-topic.php' ] );
if ( '' != $new_template ) {
return $new_template;
}
}
return $template;
}, 99 );
上面的代码为父级分类为 「58」 的子分类设置了 templates/archive/archive-topic.php 文件作为分类模版。
如果需要为父级分类为 「68」 的子分类设置一个模版呢?把上面的 if 逻辑复制一次,修改其中的 「58」 和 「archive-topic.php」 就可以了。额,虽然笔文章开头的实现方法好了一些,但还是需要复制代码,并且使用分类 ID 作为指定分类的逻辑会有一些风险。
更好的实现方法、更好的扩展性和稳定性
我们的目标是做国内最专业的 WordPress 服务商,我们追求的是不但要实现需求,并且要以最简洁有效、最有扩展性的方法来实现这个需求,并且要让客户用起来方便。于是更进了一步,我们改造了一下上面的代码。首先获取当前分类的顶级分类,如果顶级分类存在,尝试在 「templates/category/」 目录中寻找顶级分类对应的「category-顶级分类 slug.php」文件,如果文件存在,返回这个模版作为二级分类模版,如果不存在,返回默认模版。
add_filter( 'category_template', function ( $template )
{
$term = get_queried_object();
$ancestors = get_ancestors( $term->term_id, 'category' );
if ( ! empty( $ancestors ) ) {
$ancestor = get_term( $ancestors[ 0 ] );
$new_template = locate_template( [ 'templates/category/category-'. $ancestor->slug .'.php' ] );
if ( '' != $new_template ) {
return $new_template;
}
}
return $template;
}, 99 );
这样一来,就方便多了,增加分类的时候,直接增加一个「category-顶级分类 slug.php」就可以设置子分类模版了,并且在迁移数据的时候,只要分类 Slug 不改变,就不需要修改代码来适配数据,操作方法和 WordPress 默认的指定模版方法类似。有需要的朋友,可以根据自己的需要改造以上代码。或者如果你有更好的实现,可以投稿过来,方便更多有需要的朋友。