HUSKY - WooCommerce Product Filter Professional

如何折叠 WooCommerce 分类筛选器中的子分类

列出所有子分类的分类筛选器会变成一堵复选框之墙。大多数商店想要的是树形结构:父分类可见,子分类折叠在加号之下,有时父分类只显示为普通标题。要在使用 HUSKY 构建的 WooCommerce 分类筛选器中折叠子分类,您需要处理两种容易混淆的独立机制:有子项的分类旁边的小型 +/- 展开按钮,以及块标题中用于折叠整个筛选块的切换开关。它们的设置不同,保存状态的方式也不同,这就解释了大多数“它自己展开了”的意外情况。

在 WooCommerce 分类筛选器中折叠子分类

在插件的选项 (Options)选项卡中,将在复选框和单选框中隐藏子项 (Hide childs in checkboxes and radio) 设为是 (Yes)(新安装已默认开启)。此后每个子分类列表都会以隐藏状态输出,每个有子项的术语在名称后都会有一个展开按钮:一个小加号,分支展开时变成减号。它在每个层级都有效,所以有自己子项的子分类也会有自己的展开按钮。

  • 它只适用于复选框 (Checkbox) 和单选框 (Radio) 筛选器类型。下拉菜单类型从不折叠子分类(见最后一节)。
  • 设为否 (No) 时,所有子分类始终可见,也没有展开按钮。
  • 如果顶级分类列表很长,请打开该分类法的附加选项 (additional options)(结构 (Structure)选项卡中它旁边的齿轮按钮)并填写未折叠的术语数量 (Not toggled terms count):只会显示这么多个术语,其余的由显示更多 (Show more) 按钮展开。

如果某些父分类根本不应在筛选器中列出其子分类,可以用 woof_terms_where_hidden_childs 钩子将它们移除。它对复选框、单选按钮和下拉菜单都有效:

/*
 * Product filter: list these parent categories without their subcategories.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_terms_where_hidden_childs', function ($term_id) {
    $parents = array(15, 27); // IDs of the parent categories
    return in_array((int) $term_id, $parents, true) ? 1 : 0;
});

对每个术语都返回 1,则只显示顶级。

为什么展开的子分类在重新加载后仍保持展开

当访客点击展开按钮时,插件会把该分支的状态保存在浏览器的本地存储中。每次页面加载以及筛选器每次 AJAX 重绘之后,被保存为展开的分支都会再次展开。本地存储不会过期,所以您上周测试时展开的分支今天在您的浏览器中仍然是展开的,而新访客看到的则全部是关闭的。请务必在隐私窗口中检查默认状态。

这种设计带来两个副作用:

  • 决定哪个分支展开的是保存的状态,而不是当前的选择。通过筛选后的链接到达的访客,例如来自指向某个子分类筛选的菜单项,可能会发现所选的子分类隐藏在一个关闭的分支里。
  • 状态保存在父级列表项的类名之下。顶级分类有各自的类(woof_term_15 等等),但第一层以下的条目没有,所以第一层以下的所有分支共享同一个保存的状态:展开一个二级分支,下次加载页面后,所有二级分支都是展开的。

没有可以关闭这种记忆的设置,过去建议为此修改的 js/front.js 也会在每次更新时丢失。下面的代码片段改为从您的主题中实现这一点。插件每次构建完筛选器(页面加载时以及 AJAX 重绘之后)都会触发 woof_init_search_form 事件;代码片段监听该事件并重新设置每个分支:如果包含已选中的术语就展开,否则关闭。

/*
 * Product filter: ignore remembered branches. A branch of subcategories is
 * open only when it contains a selected term.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <script>
    document.addEventListener('woof_init_search_form', function () {
        jQuery('ul.woof_childs_list').each(function () {
            var list = jQuery(this);
            var sign = list.parent('li').children('.woof_childs_list_opener').find('span');
            if (!sign.length) {
                return; // this list has no +/- opener
            }
            var open = list.find('input:checked').length > 0;
            list.toggle(open);
            sign.toggleClass('woof_is_opened', open).toggleClass('woof_is_closed', !open);
        });
    });
    </script>
    <?php
}, 100);

若要在保留展开按钮的同时让每个分支默认展开,请把 var open 那一行改为 var open = true;。

在标题下折叠整个筛选块

第二种机制会隐藏整个块,只留下标题。在结构 (Structure)选项卡上打开该分类法的附加选项,并将切换选项设为是,显示为关闭 (Yes, show as closed) 或是,显示为展开 (Yes, show as opened)。在 3.4.6 中,该选项在分类法弹窗里的标签是显示单选框的切换按钮 (Show toggle button for radio),但它其实是该分类法块的切换开关。标题必须可见(显示标题标签 (Show title label) = 是 (Yes)),因为切换开关位于标题之中。在设计 (Design)选项卡上,切换块类型 (Toggle block type) 选择文字或图片,旁边的字段设置文字(默认为 + 和 -)或两张约 20×20 px 的图片。

块的状态不会记在浏览器里。服务器在每个页面上设置它:设为“显示为关闭”的块,在其某个术语属于当前筛选条件时会展开,让访客看到已选的内容。若想在这种情况下仍保持块关闭,或强制它们展开,请使用 woof_block_toggle_state 钩子:

/*
 * Product filter: blocks with a toggle always start closed.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_block_toggle_state', function ($block_is_closed) {
    return true; // true = closed, false = opened
});

该钩子只接收状态,不接收分类法,所以它适用于每一个开启了切换开关的块。

让整个标题都可点击

默认情况下只有 +/- 能打开块。关于让切换开关包含标题的常见问题是在页面加载时绑定点击。下面的版本使用事件委托,因此在 AJAX 筛选重绘表单之后仍然有效,并且会忽略对 +/- 本身的点击,否则这会使块被切换两次:

/*
 * Product filter: a click anywhere on a block title opens or closes the block.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <style>.woof_container_inner > h4:has(> .woof_front_toggle) { cursor: pointer; }</style>
    <script>
    jQuery(document).on('click', '.woof_container_inner > h4', function (e) {
        if (jQuery(e.target).closest('.woof_front_toggle, .woof_tooltip_header').length) {
            return; // the +/- or the tooltip icon was clicked
        }
        jQuery(this).children('.woof_front_toggle').trigger('click');
    });
    </script>
    <?php
}, 100);

如果您用 woof_title_tag 钩子更改了标题标签,请把 h4 替换为您的标签。文字形式的切换开关是一个链接,所以它的颜色用 CSS 设置,例如 .woof_container_inner h4 a.woof_front_toggle { color: #222; }。

若要把多个块折叠在一个标题之下,例如把所有属性折叠在“更多筛选”之下,请使用分区 (Sections) 扩展。在扩展 (Extensions)选项卡上启用它之后,其位于高级 (Advanced) → 分区 (Sections) 的设置会把一段范围内的筛选元素包裹成可展开/收起的分区;分区行为 (Sections behavior) 设为作为复选框 (As checkbox) 时可同时展开多个分区,设为作为单选框 (As radio) 时只保持一个展开。

将父分类显示为没有复选框的标题

当产品只分配给子分类时,父分类更适合作为标题。在设计 (Design)选项卡上选择了单选框和复选框皮肤 (Radio and checkboxes skin) 时,真正的输入框会被包裹在一个 div 中,其类名是用连字符连接的皮肤名称:皮肤 square_blue 对应 icheckbox_square-blue(单选按钮则是 iradio_square-blue)。因此,用带下划线的 icheckbox_square_grey 编写的 CSS 什么也匹配不到。下面的规则适用于任何皮肤和普通输入框。插件的脚本会给每个有子项的条目(在每个层级)添加类 woof_childs_list_li。请把 CSS 放在高级 (Advanced) → 代码 (Code) → 自定义 CSS 代码 (Custom CSS code) 或您的主题中:

/* Product categories filter: parents become headings without a box */
.woof_container_product_cat li.woof_childs_list_li > input,
.woof_container_product_cat li.woof_childs_list_li > div[class*="icheckbox_"],
.woof_container_product_cat li.woof_childs_list_li > div[class*="iradio_"] {
    display: none !important;
}
.woof_container_product_cat li.woof_childs_list_li > label {
    font-weight: bold;
    cursor: pointer;
}

如果只针对一个顶级分类,请使用它的术语类,例如 .woof_term_123 > div[class*="icheckbox_"]。第一层以下的条目没有术语类;请通过其父级的列表来定位它们:ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"]。

父分类的名称仍然是其隐藏输入框的标签,因此点击它会选中该父分类。下一段代码片段把这次点击变为展开和收起该分支。如果您保留复选框,但希望点击分类名称就展开其子分类,这也是答案:

/*
 * Product filter: a click on the name of a parent category opens or closes
 * its subcategories instead of selecting it.
 * Child theme functions.php or a code snippets plugin.
 */
add_action('wp_footer', function () {
    ?>
    <script>
    document.addEventListener('click', function (e) {
        var label = e.target.closest ? e.target.closest('.woof_container_product_cat li.woof_childs_list_li > label') : null;
        if (!label) {
            return;
        }
        e.preventDefault(); // do not select the parent
        e.stopPropagation();
        jQuery(label).siblings('.woof_childs_list_opener').find('span').trigger('click');
    }, true);
    </script>
    <?php
}, 100);

对于其他分类法,请把 product_cat 替换为它的别名,例如 .woof_container_pa_brand。

子分类没有缩进,或排在同一行

插件会让每个子分类列表缩进 17 px。当子分类像父分类一样对齐在父级下方时,是主题针对小工具或侧边栏中列表的规则用更强的选择器去掉了这个内边距。请恢复它:

.woof .woof_block_html_items .woof_childs_list {
    padding: 0 0 0 17px !important;
}

子分类并排显示在同一行,通常来自块选项单行显示项目 (Display items in a row):它会让所有没有子项的术语(包括子分类)以行内方式显示。要显示树形结构,请将其设为否 (No)。如果该选项已关闭,请查找让列表具有 display: flex 或让列表项具有 display: inline-block 的主题规则。

如果展开按钮的加号和减号在您的背景上难以辨认,请在设计 (Design)选项卡上用子分类展开图片 (Image for subcategories open)(加号)和子分类收起图片 (Image for subcategories close)(减号)替换它们。它们显示在 13×13 px 的框中,所以请使用简洁、高对比度的图标。

下拉菜单形式的分类筛选器

下拉菜单 (Drop-down) 和多选下拉菜单 (Multi drop-down) 类型无法折叠子分类。单选下拉菜单用空格缩进子分类;多选下拉菜单则平铺列出它们。每个子分类选项都带有表示其深度的类,woof-padding-1、woof-padding-2 等等,而顶级选项没有。浏览器对原生选项几乎不允许设置样式,但当下拉菜单皮肤 (Drop-down skin) 设为 Chosen 时,这些类会作用到可见的列表上,因此您可以标出各个层级:

/* Category drop-downs with the Chosen skin: bold top level */
.woof_container_product_cat .chosen-results li.active-result:not([class*="woof-padding-"]) {
    font-weight: bold;
}
/* Multi drop-down: indent subcategories by level */
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-1 { padding-left: 20px; }
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-2 { padding-left: 34px; }

如果访客应先选择父分类,再在第二个下拉菜单中选择它的子分类,请使用层级下拉菜单 (Hierarchy drop-down)扩展;年份、品牌和型号筛选器一文展示了具体设置。

检查清单

  • 分类块使用复选框 (Checkbox) 或单选框 (Radio) 类型,并且在复选框和单选框中隐藏子项 (Hide childs in checkboxes and radio) 为是 (Yes)。
  • 默认状态是在隐私窗口中检查的,而不是在会记住已展开分支的浏览器中。
  • 如果分支必须跟随当前选择,而不是访客之前的点击,已经加入了分支代码片段。
  • 块的切换开关在分类法的附加选项中设置,标题已显示;只有在不需要“选中时默认展开”时,才使用 woof_block_toggle_state。
  • 自定义 CSS 使用带连字符的皮肤类,或 [class*="icheckbox_"] 形式;并且每次更改之后都清除了页面和浏览器缓存。

如果这棵树的表现仍与上述描述不符,请在 HUSKY 支持论坛上发起主题,附上筛选器页面的链接和分类块的设置。