WordPress分类存档页添加子分类选择列表

2020年5月2日07:19:38 发表评论 63 views

这里说的WordPress分类存档页,其实就是我们说的分类文章列表页。最近有人开发了一个分类存档页子分类选择功能,单纯文字说的不太清楚,配合下面的图片做说明吧。

功能说明

当访问一级分类(顶级分类),比如下图的【作文】,就显示【作文】下的子分类列表:

WordPress分类存档页添加子分类选择列表

当访问二级分类,【作文】-【动物作文】时,显示它的子分类,同时还保留和它同级的二级分类,同时高亮显示【动物作文】:

WordPress分类存档页添加子分类选择列表

当访问三级分类,【作文】-【动物作文】-【小鸡】时,显示的分类列表和上面一样,只不过将【动物作文】和【小鸡】高亮显示:

WordPress分类存档页添加子分类选择列表

此外,对子分类做一个高度限制,分类过多就显示一个【点击查看更多】的功能。

功能实现

我们需要通过php代码去获取数据,然后配合js实现一些交互,以及通过css美化一下。

php部分

先贴下代码,代码中重要的部分都有注释说明:

  1. if( !class_exists('WPKJ_Get_Terms_List') ) :
  2.     /**
  3.      * 获取当前分类的子分类列表
  4.      */
  5.     class WPKJ_Get_Terms_List{
  6.         function __construct()
  7.         {
  8.             add_action( 'wp_enqueue_scripts', array$this, 'wpkj_enqueue_terms_list_scripts'), 10 );
  9.         }
  10.         public function wpkj_enqueue_terms_list_scripts(){
  11.             if( is_category() || is_tax() ) {
  12.                 wp_enqueue_style( 'terms-list-style', get_template_directory_uri() . '/assets/css/terms-list.css', array(), filemtime(get_template_directory().'/assets/css/terms-list.css') );
  13.                 wp_enqueue_script( 'terms_list', get_template_directory_uri() . '/assets/js/terms-list.js', array('jquery'), '', true );
  14.             }
  15.         }
  16.         public function wpkj_terms_list( $hide_empty = false ){
  17.             //如果不是分类或自定义分类页面,不执行
  18.             if( !is_category() && !is_tax() ) return;
  19.             //获取当前查询的对象
  20.             $object = get_queried_object();
  21.             //如果对象不存在,不执行
  22.             if( !$object ) return;
  23.             $taxonomy = $object->taxonomy; //获取分类法
  24.             $current_id = $object->term_id; //获取分类id
  25.             if$current_id ){
  26.                 //设置一下内容缓冲
  27.                 ob_start();
  28.                 echo '<div class="wpkj-terms-list">';
  29.                 //获取当前分类对象
  30.                 $current = get_term( $current_id$taxonomy );
  31.                 //获取当前分类的父级分类
  32.                 $parent_id = $current->parent;
  33.                 if ( $parent_id ) { // 存在父级分类,说明非顶级分类
  34.                     $parent = get_term( $parent_id$taxonomy );
  35.                     $grand_parent_id = $parent->parent;
  36.                     if$grand_parent_id ){ //有祖父类,显示父级分类兄弟
  37.                         $this->wpkj_get_term_children( $grand_parent_id$parent_id$taxonomy$hide_empty, 'term-parents' );
  38.                     }
  39.                     //如果有父类,显示同级分类
  40.                     $this->wpkj_get_term_children( $parent_id$current_id$taxonomy$hide_empty, 'term-brothers' );
  41.                     //如果有子分类,显示子分类
  42.                     $this->wpkj_get_term_children( $current_id, false, $taxonomy$hide_empty, 'term-children' );
  43.                 } else { // 顶级分类时
  44.                    //如果有子分类,显示子分类
  45.                    $this->wpkj_get_term_children( $current_id, false, $taxonomy$hide_empty, 'term-children' );
  46.                 }
  47.                 echo '</div>';
  48.                 //输出缓冲内容并清除缓冲
  49.                 echo $result = ob_get_clean();
  50.             }
  51.         }
  52.         /**
  53.          * 通过父级id获取并输入子分类数据
  54.          * $parent_id  为父级id
  55.          * $term_id 为当前分类id,用于对比循环中哪个是当前分类,添加特定的css类名来适配高亮样式
  56.          */
  57.         public function wpkj_get_term_children( $parent_id$term_id = false, $taxonomy$hide_empty$class = '' ){
  58.             $args = array(
  59.                 'taxonomy' => $taxonomy,
  60.                 'hide_empty' => $hide_empty,
  61.                 'child_of' => $parent_id,
  62.                 'parent' => $parent_id// child_of 和 parent 指定为同一个id,将只获取一个级别的数据
  63.             );
  64.             $terms = get_terms( $args );
  65.             if( !is_wp_error( $terms ) ){
  66.                 $html = '<ul class="terms-ul '.$class.'">';
  67.                 foreach ( $terms as $term) {
  68.                     $id = $term->term_id;
  69.                     //如果是当前分类,就添加一个类名,用于适配高亮样式
  70.                     if$term_id && $id === $term_id ){
  71.                         $html .= '<li class="current"><a href="'. get_term_link( $id, $taxonomy ) .'">'. $term->name .'</a></li>';
  72.                     } else {
  73.                         $html .= '<li><a href="'. get_term_link( $id, $taxonomy ) .'">'. $term->name .'</a></li>';
  74.                     }
  75.                 }
  76.                 $html .= '</ul>';
  77.                 echo $html;
  78.             }
  79.         }
  80.     }
  81. endif;
  82. new WPKJ_Get_Terms_List();

封装了一个简单的类 WPKJ_Get_Terms_List,为避免可能在以后的项目中有名称冲突,所以在外围判断一下是否存在同名的类。

在 WPKJ_Get_Terms_List 这个类中,除了构造方法以外,包含三个方法:

  • wpkj_enqueue_terms_list_scripts:用于引入功能所需的css和js文件。当前的设置是将css和js放在主题的 assets 对应的目录中,如果你的文件放在不同的路径,自己修改路径。
  • wpkj_terms_list:查询和判断当前分类的数据,然后进行输出。参数 $hide_empty 用来设定是否输出不含文章的空分类,默认为 false,即输出,如果不需要输出空分类,在调用时,设置为 true
  • wpkj_get_term_children:用来获取指定分类id的子分类数据,里面的前两个参数在注释中有说明,其余参数是为了传递一些必要的参数值。

这次开发,没有找到直接获取同级分类兄弟的方法,所以只能转变方式,先获取到父级分类id,然后再获取子分类。刚开始尝试过 get_term_children() ,发现它会获取所有子分类,包括子分类的子分类,实在是没有办法仅限定为下一级的子分类。

然后想到了 get_terms() ,它的所有参数继承自 WP_Term_Query 类,里面有参数 child_of ,如果仅仅设置这个参数,会和 get_term_children() 一样包含了子分类的子分类。然后在网上看到有朋友指出,还需要同时设置 parent 参数为同一个父级分类id,才能限制只显示下一级子分类。

JS部分

为了实现“点击查看更多”的功能,需要配合js代码操作,以下就是 terms-list.js 文件的代码:

  1. jQuery(document).ready(function($) {
  2.     // 这部分是为了设置哪个部分列表才是显示在下方的第二部分子分类,
  3.     // 以及做一些样式设置,并限定在手机端对父分类列表隐藏
  4.     if( $(".term-parents").length>0 ){
  5.         var ulClass = ".wpkj-terms-list .term-brothers";
  6.         $(".wpkj-terms-list .term-parents li").css("background""rgb(242,242,242)");
  7.         if ($(window).width() < 860) {
  8.             $(".wpkj-terms-list .term-parents").hide();
  9.         }
  10.     } else if( $(".term-children").length>0) {
  11.         var ulClass = ".wpkj-terms-list .term-children";
  12.         $(".wpkj-terms-list .term-brothers li").css("background""rgb(242,242,242)");
  13.         if ($(window).width() < 860) {
  14.             $(".wpkj-terms-list .term-brothers").hide();
  15.         }
  16.     } else {
  17.         var ulClass = ".wpkj-terms-list .term-brothers";
  18.     }
  19.     // 子分类部分超过设置的高度 117px 就显示“点击查看更多”
  20.     $(ulClass).each(function () {
  21.         if ($(this).height() > 117) {
  22.             var moreHtm = '<span class="more-item js_more">点击查看更多</span>';
  23.             $(moreHtm).appendTo($(this).parent());
  24.             $(this).css("height""117px");
  25.         }
  26.     });
  27.     $(document).on("click"".wpkj-terms-list > .js_more"function () {
  28.         $(this).prev(ulClass).css("height""auto");
  29.         $(this).removeClass("js_more").addClass("js_less");
  30.         $(this).html('点击隐藏更多');
  31.     });
  32.     $(document).on("click"".wpkj-terms-list > .js_less"function () {
  33.         $(this).prev(ulClass).css("height""117px");
  34.         $(this).removeClass("js_less").addClass("js_more");
  35.         $(this).html('点击查看更多');
  36.     });
  37. });

注意代码中 23、26、35 三行的数字 117,是高度设置值,你可能需要根据你的需要,修改这个高度,超过这个高度就显示“点击查看更多”。

这里js是比较弱的,所以逻辑可能有些复杂,见笑了。

CSS样式

我们还需要为列表添加一些样式,以下就是 terms-list.css 的代码:

  1. .wpkj-terms-list{
  2.     margin: 15px 0;
  3. }
  4. .wpkj-terms-list .terms-ul{
  5.     list-style: none;
  6.     border-top: 1px solid rgba(0,0,0,.04);
  7.     border-left: 1px solid rgba(0,0,0,.04);
  8.     padding: 0;
  9.     overflow-y: hidden;
  10. }
  11. .wpkj-terms-list .terms-ul li{
  12.     width: 16.66%;
  13.     display: inline-block;
  14.     border-right: 1px solid rgba(0,0,0,.04);
  15.     border-bottom: 1px solid rgba(0,0,0,.04);
  16.     text-align: center;
  17.     background: #fff;
  18. }
  19. .wpkj-terms-list .terms-ul li a{
  20.     padding: 0;
  21.     display: block;
  22.     line-height: 2;
  23.     color: #333;
  24. }
  25. .wpkj-terms-list .terms-ul li.current a{
  26.     color: #ff6700;
  27. }
  28. .wpkj-terms-list .more-item{
  29.     width: 100px;
  30.     margin: 10px auto;
  31.     display: block;
  32.     cursor: pointer;
  33.     color: #ff6700;
  34. }
  35. @media screen and (max-width:860px){
  36.     .wpkj-terms-list .terms-ul li{
  37.         width: 20%;
  38.     }
  39. }
  40. @media screen and (max-width:640px){
  41.     .wpkj-terms-list .terms-ul li{
  42.         width: 25%;
  43.     }
  44. }
  45. @media screen and (max-width:480px){
  46.     .wpkj-terms-list .terms-ul li{
  47.         width: 33.33%;
  48.     }
  49. }
  50. @media screen and (max-width:360px){
  51.     .wpkj-terms-list .terms-ul li{
  52.         width: 50%;
  53.     }
  54. }

样式不可能适配所有主题,需要大家根据自己的需要去调整。

使用方法

一般来说,我们只需要在分类列表的文件,比如 category.php 的适当位置添加下面的代码即可:

  1. <?php
  2.     ifclass_exists('WPKJ_Get_Terms_List') ) {
  3.         $list = new WPKJ_Get_Terms_List();
  4.         $list->wpkj_terms_list(); // 如果需要隐藏空分类,在左边的括号内填入 true
  5.     }
  6. ?>

先判断是否存在我们的类,然后实例化并输出。

从一开始,就考虑到兼容自定义分类法的,也就是说不仅仅可用于文章的分类,还可以是其他自定义文章类型的自定义分类法。你只需要将上面的代码添加到自定义分类法的列表文件中即可。

©里维斯社,本站推荐使用的主机:阿里云腾讯云;本站推荐使用的WP主题:WordPress主题

晨会游戏

发表评论

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: