移除 WooCommerce 筛选器标题的 Product 前缀并重命名
Product Color、Product Size、Product Material:当商店筛选器中的每个属性区块都以同一个词开头时,说明筛选器只是原样输出了 WooCommerce 给属性起的名称。要移除 WooCommerce 筛选器标题中的 Product 前缀,需要为区块设置自己的标题,既可以在筛选器设置中逐个设置,也可以用几行代码一次性处理所有属性。筛选器中的其他文本也由同样的位置控制:区块标题、下拉菜单的第一个选项、全部清除 (Clear All)、重置 (Reset)、筛选 (Filter)、显示更多 (Show more),甚至单个术语的名称。所有这些都可以在不编辑插件文件的情况下修改。
筛选器中每段文本的来源
HUSKY 不会为分类法存储自己的名称。除非您设置了自定义标签,否则它会向 WordPress 请求该分类法的复数名称并原样输出。WooCommerce 用复数名称 Product %s 注册每个全局属性,因此属性颜色 (Color) 就成了名为“Product Color”的分类法,而它的单数名称仍然是“Color”。分类和标签的情况相同:它们的复数名称是“Product categories”和“Product tags”。下表列出了每段可见文本的来源以及修改位置。
| 页面上的文本 | 来源 | 修改位置 |
|---|---|---|
| 整个筛选器上方的标题(“HUSKY Filter”) | 小工具标题 | 小工具的标题 (Title) 字段 |
| 区块标题(Product Color、Product categories) | 分类法名称 | 分类法自定义标签 (Taxonomy custom label),或 woof_filter_title 钩子 |
| 下拉菜单的第一个选项 | 同一个分类法名称 | 区块标题,或下拉菜单模板的副本 |
| 价格筛选器的标题 | 价格筛选器的标题文本 (Title text) | 按价格搜索 (Search by Price) 的附加选项 |
| 有货 (In stock)、促销中 (On sale)、精选产品 (Featured products) | 各扩展的文本 | woof_ext_custom_title_* 钩子 |
| 活动筛选器面板中的全部清除 (Clear All) | 插件字符串 | woof_clear_all_text 钩子 |
| 筛选 (Filter) 和重置 (Reset) 按钮,orderby 标签 | 插件字符串和选项 | “选项 (Options)”选项卡,或翻译 |
| 显示更多 (Show more) / 显示更少 (Show less),移动端打开筛选器 (Open filter) / 关闭筛选器 (Close filter) | “设计 (Design)”选项卡中的选项 | “设计 (Design)”选项卡 |
| 单个术语的名称 | 术语本身 | woof_sort_terms_before_out 钩子 |
移除 WooCommerce 筛选器标题中的 Product 前缀
共有三种方法,影响范围从最窄到最宽。选择其中一种即可,不需要全部使用。
逐个区块设置:分类法自定义标签
- 打开 WooCommerce > 设置 (Settings) > Products Filter,进入结构 (Structure) 选项卡。
- 在属性所在的行(例如
pa_color)点击齿轮图标,即附加选项 (additional options)。 - 在分类法自定义标签 (Taxonomy custom label) 中输入您想要的标题,例如
Color。将该字段留空即可恢复为 WooCommerce 的名称。 - 点击弹出窗口中的应用 (Apply),然后点击设置页面底部的保存更改 (Save changes)。
自定义标签会替换筛选器用到分类法名称的所有位置:区块标题、下拉菜单的第一个选项、多选框的占位符,以及活动筛选器面板中所选值的标签。您也可以用同样的方法把“Product categories”改名为“Categories”或“Shop by type”,或为品牌分类法设置不同的标题。对于分层下拉菜单,同一个字段保存各级的标题;年份、品牌和型号筛选器指南介绍了这种格式。
一次处理所有属性:woof_filter_title 钩子
如果有二十个属性,逐个输入标签会很繁琐,而且每新增一个属性都得重来一遍。筛选器的每个区块标题都会经过 woof_filter_title 钩子,因此一段代码就能把每个属性的“Product ...”名称替换为它的单数名称:
/*
* HUSKY: show "Color" instead of "Product Color" in attribute filter titles.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
if (is_object($taxonomy_info)
&& isset($taxonomy_info->name, $taxonomy_info->labels->name, $taxonomy_info->labels->singular_name)
&& 0 === strpos($taxonomy_info->name, 'pa_')
&& $title === $taxonomy_info->labels->name) {
// No custom label is set: use the attribute name without the prefix
return $taxonomy_info->labels->singular_name;
}
return $title;
}, 10, 3);
检查条件 $title === $taxonomy_info->labels->name 会保留您已设置的所有分类法自定义标签 (Taxonomy custom label):这段代码只处理仍然是 WooCommerce 原名称的标题。它不会改动筛选器之外的任何内容。该钩子还会收到一些 $taxonomy_info 为空的按钮文本,所以代码先检查了 is_object()。
全站范围:修改 WooCommerce 字符串
如果您希望在所有显示属性分类法名称的地方都去掉该前缀,包括其他小工具和后台页面,就需要修改 WooCommerce 的字符串本身。前缀来自 _x( 'Product %s', 'Product Attribute', 'woocommerce' ),因此可以用一个翻译过滤器只返回名称本身:
/*
* Remove the "Product" prefix from WooCommerce attribute names site-wide.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('gettext_with_context', function ($translation, $text, $context, $domain) {
if ('woocommerce' === $domain && 'Product Attribute' === $context && 'Product %s' === $text) {
return '%s';
}
return $translation;
}, 10, 4);
也可以借助 Loco Translate 达到相同的效果:在 WooCommerce 文本域中把 Product %s 翻译为 %s;请将文件保存在 Loco 的自定义位置,这样 WooCommerce 更新时就不会覆盖它。在使用其他语言的站点上,您看到的是翻译后的字符串(例如“Produkt %s”),但这段代码比较的是原始英文文本,因此对任何站点语言都有效。
任何重命名方法都有一个副作用:每个区块还会获得一个根据其标题生成的 CSS 类,例如 woof_container_productcolor。重命名之后它会变成 woof_container_color。如果您的自定义 CSS 针对的是旧类名,请改用基于别名的类 woof_container_pa_color,它永远不会改变。
修改或隐藏筛选器标题和小工具标题
整个筛选器上方的“HUSKY Filter”文本并不是插件设置:它是小工具的标题。请打开外观 (Appearance) > 小工具 (Widgets)(或区块小工具编辑器),打开 HUSKY 小工具,修改其标题 (Title) 字段或将其清空。标题为空时不会输出任何内容。使用 [woof] 短代码放置的筛选器则完全没有这样的标题。
要隐藏某个区块的标题,请在其附加选项中将显示标题标签 (Show title label) 设置为否 (No)。这对下拉菜单很常见,因为其第一个选项已经说明了该下拉菜单的用途。价格筛选器有自己的字段:打开按价格搜索 (Search by Price) 的附加选项并填写标题文本 (Title text);留空时,价格区块没有标题。对于下拉式价格筛选器,同一弹出窗口中的下拉式价格筛选器文本 (Drop-down price filter text) 用于设置它的第一个选项。
一个分类法在整个商店中只有一个标题。如果某个分类需要不同的标题,例如在“鞋子”分类上显示“Shoe size”,按分类设置标签的常见问题对此有说明;最简单的代码是在 woof_filter_title 中加一个条件:
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
if (is_object($taxonomy_info) && 'pa_size' === $taxonomy_info->name && is_product_category('shoes')) {
return 'Shoe size';
}
return $title;
}, 10, 3);
当每次更改筛选条件后页面都会重新加载时,这种方式有效。在 AJAX 模式下,筛选表单由后台请求重新构建,而在该请求中 is_product_category() 为 false,因此标题在第一次选择之后会恢复为默认值。
修改下拉菜单的占位符文本
分类法下拉菜单的第一个选项,即表示“未选择任何内容”的那一项,输出的文本与区块标题相同。因此,自定义标签会同时改变这两处。如果您希望两者不同,例如标题为颜色 (Color),而第一个选项为任意颜色 (Any colour),请使用下拉菜单模板的副本。插件通过 woof_html_types_view_select 钩子加载该模板,因此副本可以放在您的子主题中,并且在插件更新后依然保留。
- 将
wp-content/plugins/woocommerce-products-filter/views/html_types/select.php复制到wp-content/themes/your-child-theme/husky/select.php。 - 告诉插件使用该副本:
/* * HUSKY: load the drop-down template from the child theme. * Child theme functions.php. */ add_filter('woof_html_types_view_select', function ($path) { $custom = get_stylesheet_directory() . '/husky/select.php'; return file_exists($custom) ? $custom : $path; }); - 在副本中找到
<option value="0">这一行,将其替换为您自己的文本。那里可以使用$tax_slug,因此一个模板就能服务于所有下拉菜单:<option value="0"><?php echo esc_html( 'pa_color' === $tax_slug ? 'Any colour' : 'All' ); ?></option>
多选区块把标题显示为占位符;它们的模板是 views/html_types/mselect.php,通过 woof_html_types_view_mselect 以同样的方式加载。插件更新之后,请将您的副本与新的原始文件对比,并同步其中的更改。
修改“全部清除”、“重置”、“筛选”等内置文本
插件自带的文本分为三组。
选项。在选项 (Options) 选项卡中,筛选按钮文本 (Filter button text) 和重置按钮文本 (Reset button text) 用于设置表单的两个按钮;在重置按钮文本 (Reset button text) 中填入 none 即可隐藏该按钮。在免费版中,这两个字段都会被忽略,显示的是默认文字;请使用下面的翻译代码来修改。在设计 (Design) 选项卡中,您会找到区块展开时的更多/更少文本 (Text for block more/less opened) 和区块收起时的更多/更少文本 (Text for block more/less closed)(默认为显示更多 (Show more) 和显示更少 (Show less),在区块设置了未折叠的术语数量 (Not toggled terms count) 时使用),以及移动端筛选按钮文本 (Text for mobile filter button) 和关闭移动端筛选器的文本 (Text to close mobile filter)。
钩子。活动筛选器面板中的全部清除 (Clear All) 有自己的 woof_clear_all_text 钩子,复选框类扩展则有 woof_ext_custom_title_* 钩子:woof_ext_custom_title_by_instock、_by_onsales、_by_featured、_by_backorder 和 woof_ext_custom_title_stock_quantity。
/*
* HUSKY: rename built-in texts. Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_clear_all_text', function ($text) {
return 'Remove all filters';
});
add_filter('woof_ext_custom_title_by_instock', function ($title) {
return 'Only products in stock';
});
add_filter('woof_ext_custom_title_by_onsales', function ($title) {
return 'Discounted products';
});
全部清除 (Clear All) 的文本会被写入一个用双引号括起来的 JavaScript 字符串,因此其中不要使用双引号。
翻译。其他所有文本,例如活动筛选器面板中的 orderby、per page 和价格范围 (price range) 标签,以及 popularity 之类的排序值,都是 woocommerce-products-filter 文本域中的可翻译字符串。在单语言商店中,最简单的工具是带有精确字符串列表的 gettext 过滤器:
/*
* HUSKY: replace front-end strings. Child theme functions.php or a code snippets plugin.
*/
add_filter('gettext', function ($translation, $text, $domain) {
if ('woocommerce-products-filter' !== $domain || (is_admin() && ! wp_doing_ajax())) {
return $translation;
}
$texts = array(
'Filter' => 'Show products',
'Reset' => 'Start over',
'orderby' => 'Sort by',
'popularity' => 'Popularity',
'rating' => 'Rating',
);
return isset($texts[$text]) ? $texts[$text] : $translation;
}, 20, 3);
字符串必须完全匹配,包括大小写:默认的按钮文本是 Clear All,而不是“Clear all”。is_admin() 条件会让插件的设置页面保持原有措辞,同时仍然覆盖重绘筛选器的 AJAX 请求。被替换的字符串会在插件输出它的所有位置发生变化:Filter 同时也是 WooCommerce 风格价格滑块的按钮,以及滑出式标签页的默认文本。Loco Translate 无需代码即可完成同样的操作。将筛选器翻译成多种语言是另一项任务,详见使用 WPML、Polylang 或 Loco Translate 翻译筛选器标签。
仅在筛选器内重命名术语
有时,某个分类或属性值在筛选器中的显示应与商品页面上不同,例如过长的分类名称会破坏侧边栏布局。每个术语列表在输出之前都会经过 woof_sort_terms_before_out,复选框、单选按钮、下拉菜单、标签、颜色和图片类型均不例外:
/*
* HUSKY: show other names for some terms in the filter only.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_sort_terms_before_out', function ($terms, $type) {
$new_names = array(
1019 => 'Garden tools', // term ID => name shown in the filter
1697 => 'Kids (4-12)',
);
foreach ($terms as $key => $term) {
if (isset($term['term_id'], $new_names[$term['term_id']])) {
$terms[$key]['name'] = $new_names[$term['term_id']];
}
}
return $terms; // always return the whole array
}, 99, 2);
要找到术语 ID,可以在产品 (Products) > 分类 (Categories) 或属性的配置术语 (Configure terms) 页面上将鼠标悬停在术语上:链接中的 tag_ID 就是它。该钩子对子术语同样生效,因此子分类也可以用同样的方式重命名。优先级 99 运行时,列表已经排好序,所以被重命名的术语会保持其原名称所在的位置。务必返回完整的数组:只返回被修改的术语,会把其余所有术语从筛选器中移除。
如果新名称没有出现
- 未保存。附加选项弹出窗口中的应用 (Apply) 只是填写表单;只有在设置页面上点击保存更改 (Save changes) 时,标签才会被保存。
- 术语缓存。如果在高级 (Advanced) > 选项 (Options) 下启用了缓存术语 (Cache terms),筛选器会保留它缓存的术语名称。在 WooCommerce 中重命名的术语会一直显示旧名称,直到您点击清除术语缓存 (clear terms cache) 或自动清除周期结束。
- 页面缓存。已缓存的页面会保留旧的 HTML。请清除缓存插件、服务器或 CDN 的缓存,并在无痕窗口中测试。
- 代码片段未运行。请确认代码位于当前启用的(子)主题的
functions.php中或某个已启用的代码片段里,并且过滤器名称、参数数量和字符串都与上文完全一致。
如果您筛选器中的某段文本没有在这里涉及,请在 HUSKY 支持论坛中提问,并附上确切的文本及其出现的位置。