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タクソノミーラベル翻訳 (WPML taxonomies labels translations)
組み込みのインターフェース文字列:フィルター (Filter)、リセット (Reset)、すべてクリア (Clear All)、価格帯 (price range)、在庫あり (In stock)、商品フィルターフォームを表示 (Show products filter form)テキストドメインwoocommerce-products-filterWPML String Translation、Loco Translate、または.po/.moファイル
フィルターウィジェットのタイトルWordPressのウィジェット多言語プラグインのウィジェット翻訳

失敗する原因の多くは、翻訳する場所の間違いです。たとえば、属性のタイトルをLoco Translateで翻訳したり、カスタムラベルをWPML String Translationで翻訳したりしても、プラグインはそこに文字列を登録しないため反映されません。

PolylangまたはWPMLでWooCommerce商品フィルターのラベルを翻訳する

フィルターのタイトルと、プラグイン設定に入力したすべてのテキストは、プラグイン内の1つの対応表で翻訳します。WPMLでもPolylangでも同じように動作し、このフィールドはどちらかが有効なときだけ表示されます。

  1. ブロックに固定の原文を設定します。構造 (Structure)タブでタクソノミーの横にある歯車(追加オプション (additional options))をクリックし、タクソノミーのカスタムラベル (Taxonomy custom label)に、たとえばColorと入力します。カスタムラベルがない場合の原文は、WordPressが現在の言語で返すタクソノミー名になります。属性の場合、WooCommerceは「Product Color」という名前を作りますが、翻訳プラグインがすでに変更していることもあるため、ある形式で書いた行が別の言語では一致しません。
  2. 詳細設定 (Advanced) → コード (Code) → WPMLタクソノミーラベル翻訳 (WPML taxonomies labels translations)を開き、ラベルと言語ごとに1行ずつ追加します。書式は、言語、コロン、原文、キャレット、翻訳の順です。
  3. 正しい言語コードを使います。WPMLではWPMLの言語コード(fr、de、pt-br)を使います。Polylangでは、Polylangの言語一覧のロケール (Locale)列に表示される言語のロケール(fr_FR、en_GB、uk)を使います。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のような行は無視されます。
  • 原文にコロンを含めることはできますが、キャレットは含められません。最初の^で原文が終わります。
  • これは項目ごとの設定ではなく、1つの対応表です。1行でそのテキストを、フィルターを通るあらゆる場所で翻訳します。ブロックタイトル、選択中フィルターのパネルのタイトル、ボタン、プレースホルダーが対象です。

同じ対応表で、設定に入力したテキストも翻訳できます。フィルターボタンのテキスト (Filter button text)とリセットボタンのテキスト (Reset button text)、価格フィルターのタイトル、テキスト検索・SKU検索・投稿者検索のプレースホルダー、トグルのテキスト、もっと見る (Show more)と表示を減らす (Show less)のテキスト、ツールチップ、メタフィルターやACFフィルターのタイトルと選択肢、セクションタイトルです。入力したテキストと完全に同じ内容で行を書いてください。たとえばfr:Sort by price^Trier par prixのようにします。

カスタムCSSでは、1つ副作用に注意が必要です。各ブロックには表示されるタイトルから作られたクラスも付くため、フランス語のページではwoof_container_couleur、英語のページではwoof_container_colorになります。ブロックのスタイルは、.woof_container_pa_colorのようにタクソノミーのスラッグから作られるクラスで指定してください。こちらはどの言語でも同じです。

インターフェース文字列:Loco Translate、WPML String Translation、.poファイル

プラグイン組み込みのテキストは、テキストドメインwoocommerce-products-filterの通常のWordPress文字列です。これに関わる設定はフィルターボタンのテキスト (Filter button text)とリセットボタンのテキスト (Reset button text)の2つです。これらのフィールドが空の場合、ボタンには翻訳可能なデフォルトのフィルター (Filter)とリセット (Reset)が使われます。独自のテキストを入力すると設定のテキストとなり、上記の対応表で翻訳します。

WPML。WPML → テーマとプラグインのローカライゼーション (Theme and plugins localization)でプラグインをスキャンし、String Translationでwoocommerce-products-filterドメインの文字列を翻訳します。

Loco Translateは、プラグインの文字列が文字列一覧に含まれないPolylangでも、通常はこちらを使います。

  1. Loco Translate → プラグイン (Plugins)に移動し、HUSKYを開いて新しい言語を追加します。
  2. 保存場所には、プラグイン自身のlanguagesフォルダーではなく、カスタム (Custom)またはシステム (System)を選びます。プラグインの更新でそのフォルダーは置き換えられ、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のカスタムフォルダーに置きます。表の書式の簡単な説明は、FAQWPMLとの連携にあります。

フックで言語ごとに個別の文字列を設定する

一部のテキストは、とくに言語ごとに内容を変えたい場合、コードで設定するほうが簡単です。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タイプとImageタイプの色や画像は、デフォルト言語の用語にだけ設定すれば十分です。独自の色や画像がない翻訳済みの用語は、元の用語のものを使います。

チェックリスト

  • タイトルを翻訳したいブロックにはすべてタクソノミーのカスタムラベル (Taxonomy custom label)があり、WPMLタクソノミーラベル翻訳 (WPML taxonomies labels translations)の行はそのラベルと完全に同じ内容を繰り返している。
  • 言語プレフィックスは、WPMLではWPMLの言語コード、Polylangでは完全なロケールになっている。
  • 設定フィールドに入力したテキストは対応表に入っており、組み込みの文字列はwoocommerce-products-filterドメインで翻訳されている。
  • Locoのファイルは「Custom」または「System」の場所にあり、同期の前にPHPのサイズ制限を引き上げた。
  • カスタムCSSは、タイトルではなくタクソノミーのスラッグでブロックを指定している。
  • 2つ目の言語をテストする前に、ページキャッシュと用語キャッシュを削除した。

それでもラベルが変わらない場合は、HUSKYサポートフォーラムでトピックを立て、2つ目の言語のページへのリンク、使っている翻訳プラグイン、追加した行を記載してください。