翻译 WooCommerce 产品筛选器标签:Polylang、WPML、Loco
在多语言商店中,产品筛选器经常只翻译了一半:颜色名称已经切换了语言,但区块标题、筛选 (Filter) 按钮或全部清除 (Clear All) 仍然是原文。筛选器显示的文本来自多个来源,每个来源的翻译位置都不同。本指南按来源逐一说明如何使用 Polylang、WPML 或 Loco Translate 翻译 WooCommerce 产品筛选器标签,并给出插件所要求的准确语法。
筛选器中每段文本的来源
| 筛选器中的文本 | 来源 | 翻译位置 |
|---|---|---|
| 术语名称:分类、颜色、尺寸 | WordPress 术语 | 您的多语言插件,与任何分类或属性术语相同 |
| 没有自定义标签的区块标题 | 分类法名称,属性则为“Product Color”之类 | 您的多语言插件,或者更好的做法是使用自定义标签(见下文) |
| 您在筛选器设置中输入的文本:自定义标签、按钮文本、占位符、折叠开关文本和显示更多 (Show more) 文本、工具提示、元数据筛选器的标题和选项、分区标题 | HUSKY 设置 | 高级 (Advanced) → 代码 (Code) 中的 WPML taxonomies labels translations |
| 内置界面字符串:筛选 (Filter)、重置 (Reset)、全部清除 (Clear All)、价格范围 (price range)、有货 (In stock)、显示产品筛选表单 (Show products filter form) | 文本域 woocommerce-products-filter | WPML 字符串翻译、Loco Translate 或 .po/.mo 文件 |
| 筛选器小工具的标题 | WordPress 小工具 | 您的多语言插件的小工具翻译功能 |
大多数失败的尝试都是把文本翻译到了错误的位置,例如在 Loco Translate 中翻译属性标题,或者在 WPML 字符串翻译中翻译自定义标签,而插件根本不会在那里注册这些文本。
使用 Polylang 或 WPML 翻译 WooCommerce 产品筛选器标签
筛选器标题以及输入到插件设置中的所有文本,都通过插件中的同一张对照表来翻译。它对 WPML 和 Polylang 的工作方式相同;只有当其中一个插件处于启用状态时,该字段才会出现。
- 为区块设定固定的原文。在结构 (Structure) 选项卡中,点击分类法旁边的齿轮图标(附加选项 (additional options)),填写分类法自定义标签 (Taxonomy custom label),例如
Color。如果没有自定义标签,原文就是 WordPress 以当前语言返回的分类法名称。对于属性,WooCommerce 会将其构建为“Product Color”,而翻译插件可能已经修改过它,因此针对某一种形式编写的条目在另一种语言下无法匹配。 - 打开高级 (Advanced) → 代码 (Code) → WPML taxonomies labels translations,为每个标签和每种语言添加一行:语言、冒号、原文、插入符号、译文。
- 使用正确的语言代码。使用 WPML 时,填写 WPML 的语言代码(
fr、de、pt-br)。使用 Polylang 时,填写该语言的区域设置(fr_FR、en_GB、uk),即 Polylang 语言列表中区域设置 (Locale) 列所显示的值。在运行en_GB的 Polylang 站点上使用en,是没有任何变化的最常见原因。 - 保存,然后清除页面缓存,并在另一种语言下检查页面。
对于使用英语、同时提供法语和德语的商店,在 WPML 上这样写:
fr:Color^Couleur
fr:Size^Taille
de:Color^Farbe
de:Size^Größe
在 Polylang 上的写法相同:
fr_FR:Color^Couleur
fr_FR:Size^Taille
de_DE:Color^Farbe
de_DE:Size^Größe
默认语言不需要添加任何行:没有匹配时,显示的就是原文。
对照表如何匹配
- 原文必须与区块在未翻译时显示的文本一致:即自定义标签;如果没有自定义标签,则为分类法名称。首尾的空格和字母大小写都不影响匹配,任何文字的标签均可使用。
- 每一行都需要语言前缀。像
Containertyp^Container type这样的行会被忽略。 - 原文中可以包含冒号,但不能包含插入符号:第一个
^即标志着原文的结束。 - 这是一张表,而不是针对每个字段的设置。一行就能在该文本经过筛选器的所有位置完成翻译:区块标题、已选筛选器面板中的标题、按钮或占位符。
同一张表也用于翻译您在设置中输入的文本:筛选按钮文本 (Filter button text) 和重置按钮文本 (Reset button text)、价格筛选器标题、文本搜索、SKU 搜索和作者搜索的占位符、折叠开关文本、显示更多 (Show more) 和显示更少 (Show less) 文本、工具提示、元数据和 ACF 筛选器的标题与选项,以及分区标题。请严格按照您输入的文本来编写该行,例如 fr:Sort by price^Trier par prix。
有一个副作用会影响自定义 CSS:每个区块还会获得一个根据其显示标题生成的类名,因此法语页面上是 woof_container_couleur,而英语页面上是 woof_container_color。请通过根据分类法别名生成的类来设置区块样式,例如 .woof_container_pa_color,它在每种语言中都相同。
界面字符串:Loco Translate、WPML 字符串翻译和 .po 文件
插件的内置文本是文本域 woocommerce-products-filter 中的普通 WordPress 字符串。有两项设置会影响它们:筛选按钮文本 (Filter button text) 和重置按钮文本 (Reset button text)。当这些字段为空时,按钮使用可翻译的默认值筛选 (Filter) 和重置 (Reset);一旦您输入了自己的文本,它就变成了设置文本,需要放入上面的对照表中。
WPML。在 WPML → 主题和插件本地化 (Theme and plugins localization) 中扫描该插件,然后在字符串翻译 (String Translation) 中翻译 woocommerce-products-filter 文本域的字符串。
Loco Translate,也是使用 Polylang 时的常规选择,因为 Polylang 的字符串列表不包含插件字符串:
- 前往 Loco Translate → 插件 (Plugins),打开 HUSKY 并添加一种新语言。
- 选择自定义 (Custom) 或系统 (System) 位置,而不是插件自带的
languages文件夹。插件更新会替换该文件夹,而且在 3.4.6 中插件不会从该文件夹加载翻译文件。 - 同步之前,打开 Loco Translate → 设置 (Settings),将跳过大于以下大小的 PHP 文件 (Skip PHP files larger than) 提高到至少 200 KB。插件的主文件约为 145 KB,其中包含 Clear All、price range、已选筛选器面板中的排序名称以及 Show products filter form 等字符串。在默认限制 100 KB 下,Loco 会跳过该文件,这些字符串就会缺失,而且同步会把它们从现有翻译中删除。
- 同步、翻译、保存。Loco 会在 .po 文件旁边编译出 .mo 文件。
适用于多种语言的现成翻译文件位于翻译页面。无论使用哪种工具,文件名都必须以您站点的确切区域设置结尾,例如 woocommerce-products-filter-de_DE.mo,文件应放在 wp-content/languages/plugins/ 或 Loco 的自定义文件夹中。常见问题使用 WPML 中有对照表语法的简要说明。
通过钩子按语言设置单个字符串
有些文本更适合用代码来设置,尤其是当同一段文本需要因语言而异时。以下钩子在 3.4.6 中可用:
- woof_filter_title:接收经过对照表的每一段文本,并在对照表处理之后执行,因此可以修改任何区块标题、按钮或占位符。
- woof_clear_all_text:已选筛选器面板中的全部清除 (Clear All) 链接。
- woof_start_filtering_btn_txt:显示产品筛选表单 (Show products filter form) 按钮。
woof_ext_custom_title_by_instock、woof_ext_custom_title_by_onsales、woof_ext_custom_title_by_featured、woof_ext_custom_title_by_backorder:“有货”、“促销中”、“精选”和“缺货补订”复选框的标签。
/*
* Product filter: per-language texts set in code.
* Child theme functions.php or a code snippets plugin.
*/
function my_filter_lang() {
if (function_exists('pll_current_language')) {
return pll_current_language(); // Polylang: language slug, e.g. "fr"
}
return apply_filters('wpml_current_language', null); // WPML: language code
}
add_filter('woof_filter_title', function ($title, $taxonomy_info, $index) {
$texts = array(
'en' => array('Formations' => 'Bands'),
'de' => array('Formations' => 'Besetzungen'),
);
return $texts[my_filter_lang()][$title] ?? $title;
}, 10, 3);
add_filter('woof_clear_all_text', function ($text) {
return my_filter_lang() === 'fr' ? 'Tout effacer' : $text;
});
请注意,这里的语言是 Polylang 的语言别名(fr),而不是对照表中使用的区域设置。
其他语言中的术语、术语顺序和色板
筛选器输出的是 WordPress 返回的当前语言的术语。如果某个值以原始语言显示,说明该术语本身尚未翻译:请在 WPML 中翻译(属性通过 WooCommerce Multilingual),或在 Polylang 中翻译。如果已经翻译但仍显示旧名称,请清除页面缓存,并使用高级 (Advanced) → 选项 (Options) 上的清除术语缓存 (clear terms cache) 按钮清除插件的缓存术语 (Cache terms)。
翻译后的术语是各自独立的术语,有各自的顺序。若要保持默认语言的顺序,请打开术语列表(产品 (Products) → 分类 (Categories),或 产品 (Products) → 属性 (Attributes) → 配置术语 (Configure terms)),切换管理界面语言,然后重新排列术语。颜色(Color)和图片类型的颜色与图片只需在默认语言的术语上设置:没有自己颜色或图片的翻译术语会使用其原始术语的颜色或图片。
检查清单
- 每个需要翻译标题的区块都有一个分类法自定义标签 (Taxonomy custom label),并且 WPML taxonomies labels translations 中的各行与该标签完全一致。
- 在 WPML 上,语言前缀是 WPML 语言代码;在 Polylang 上,则是完整的区域设置。
- 输入到设置字段中的文本位于对照表中;内置字符串在
woocommerce-products-filter文本域中翻译。 - Loco 文件位于“自定义”或“系统”位置,并且在同步之前已提高 PHP 文件大小限制。
- 自定义 CSS 通过分类法别名而不是标题来定位区块。
- 测试第二种语言之前,已清除页面缓存和术语缓存。
如果某个标签仍然无法改变,请在 HUSKY 支持论坛中发帖,并附上第二种语言页面的链接、您使用的翻译插件以及您添加的行。