HUSKY - WooCommerce Product Filter Professional

翻译 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-filterWPML 字符串翻译、Loco Translate 或 .po/.mo 文件
筛选器小工具的标题WordPress 小工具您的多语言插件的小工具翻译功能

大多数失败的尝试都是把文本翻译到了错误的位置,例如在 Loco Translate 中翻译属性标题,或者在 WPML 字符串翻译中翻译自定义标签,而插件根本不会在那里注册这些文本。

使用 Polylang 或 WPML 翻译 WooCommerce 产品筛选器标签

筛选器标题以及输入到插件设置中的所有文本,都通过插件中的同一张对照表来翻译。它对 WPML 和 Polylang 的工作方式相同;只有当其中一个插件处于启用状态时,该字段才会出现。

  1. 为区块设定固定的原文。在结构 (Structure) 选项卡中,点击分类法旁边的齿轮图标(附加选项 (additional options)),填写分类法自定义标签 (Taxonomy custom label),例如 Color。如果没有自定义标签,原文就是 WordPress 以当前语言返回的分类法名称。对于属性,WooCommerce 会将其构建为“Product Color”,而翻译插件可能已经修改过它,因此针对某一种形式编写的条目在另一种语言下无法匹配。
  2. 打开高级 (Advanced) → 代码 (Code) → WPML taxonomies labels translations,为每个标签和每种语言添加一行:语言、冒号、原文、插入符号、译文。
  3. 使用正确的语言代码。使用 WPML 时,填写 WPML 的语言代码(fr、de、pt-br)。使用 Polylang 时,填写该语言的区域设置(fr_FR、en_GB、uk),即 Polylang 语言列表中区域设置 (Locale) 列所显示的值。在运行 en_GB 的 Polylang 站点上使用 en,是没有任何变化的最常见原因。
  4. 保存,然后清除页面缓存,并在另一种语言下检查页面。

对于使用英语、同时提供法语和德语的商店,在 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 的字符串列表不包含插件字符串:

  1. 前往 Loco Translate → 插件 (Plugins),打开 HUSKY 并添加一种新语言。
  2. 选择自定义 (Custom) 或系统 (System) 位置,而不是插件自带的 languages 文件夹。插件更新会替换该文件夹,而且在 3.4.6 中插件不会从该文件夹加载翻译文件。
  3. 同步之前,打开 Loco Translate → 设置 (Settings),将跳过大于以下大小的 PHP 文件 (Skip PHP files larger than) 提高到至少 200 KB。插件的主文件约为 145 KB,其中包含 Clear All、price range、已选筛选器面板中的排序名称以及 Show products filter form 等字符串。在默认限制 100 KB 下,Loco 会跳过该文件,这些字符串就会缺失,而且同步会把它们从现有翻译中删除。
  4. 同步、翻译、保存。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 支持论坛中发帖,并附上第二种语言页面的链接、您使用的翻译插件以及您添加的行。