WPML

このガイドは、カタログをWordPressの外部(スプレッドシート、PIM、ERP、またはサプライヤーのフィードなど)で管理しているストアを対象としています。商品はインポーター、REST API、またはスケジュールされたジョブによってWooCommerceに到達するため、商品エディタを開くことはほとんどありません。

WPML、WPML Multilingual & Multicurrency for WooCommerce、そして翻訳を含むインポートにはWPML エクスポートとインポートが必要です。

パート1:外部から管理される多言語ストアの仕組み

翻訳グループでリンクされる言語ごとの商品

各言語には独自のIDを持つ独自のWooCommerce商品があります。WPMLはこれらの言語を翻訳グループでリンクします。オリジナルはストアのデフォルト言語の商品であり、他の言語はその翻訳です。

この例のストアでは、Zip-Up Hoodieは英語で商品14、ドイツ語で121、フランス語で122です。これらのいずれに対するREST APIの応答も、同じマップ"translations": {"de":"121","en":"14","fr":"122"}を保持します。

  • SKUはすべての言語で同じです。バリエーション商品のバリエーションも、同じバリエーションSKUを保持します。
  • SKUは外部システムのキーです。WooCommerce独自の検索であるwc_get_product_id_by_sku()は、翻訳ではなくオリジナルの商品を返します。
  • リストは一度に1つの言語を返します。GET /wc/v3/products?sku=HP-HD-ZIPはデフォルト言語のみを返します。1つの言語には&lang=deを、すべての言語には&lang=allを追加します。

WPMLがすべての言語にコピーするものと翻訳するもの

商品エディタ、CSVインポート、またはREST APIを通じてオリジナルの商品が変更されると、WPMLは以下の値をすべての翻訳にコピーします。

  • 通常価格とセール価格
  • 在庫数と在庫ステータス
  • SKU、重量、寸法
  • 商品の画像とギャラリー(各言語に画像の独自のコピーが作成されます)
  • カテゴリーとタグ(翻訳されたカテゴリーまたはタグとして)
  • アップセルとクロスセル(同じ言語の商品を指します)
  • 公開ステータス
  • バリエーション商品の場合:各バリエーションの価格と在庫、価格帯、新しいグローバル属性のターム(Blackに対するSchwarzやNoirなどの翻訳として)、および新しいバリエーション

以下は翻訳されるため、各言語で異なる値が保持されます。

  • 名前、説明、短い説明
  • スラッグ(商品のアドレス、例:/de/produkt/kapuzenjacke-mit-reissverschluss/)
  • Blue、Blau、Bleuなどの属性ターム
  • この商品にのみ設定された「Material」などの商品固有の属性の値

在庫はすべての言語で共有されます。

価格と属性はオリジナルに書き込みます。システムが価格や属性を翻訳に書き込んだ場合でも、翻訳はオリジナルの値を保持します。在庫は共有されるため、いずれかの言語に書き込まれた在庫はすべての言語の在庫になります。

第2通貨の価格もオリジナルに従います(WooCommerceのマルチ通貨を参照してください)。REST API("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}})のcustom_prices、またはCSV列のMeta: _wcml_custom_prices_status、Meta: _regular_price_USD、Meta: _sale_price_USD、Meta: _price_USDを使用して、これらをオリジナルに設定します。これにより、すべての言語でその通貨の価格が表示されます。

custom_pricesは、マルチ通貨がオンになっており、その通貨がストアの通貨の1つである場合に保存されます。次のように送信します。

  1. 最初にマルチ通貨をオンにします。WPML設定マルチ通貨に移動し、「マルチ通貨モードを有効にする」にチェックを入れて「変更を保存する」をクリックします。「通貨の表示基準」でオプション(「サイト言語」など)を選択し、「変更を保存する」をクリックします。次に、「通貨を追加」で各通貨を追加します。マルチ通貨がオフの場合、WPMLはcustom_pricesから何も保存しません。
  2. ストアの通貨コードを使用します。WPMLはストアの通貨の価格のみを保存します。他のコードの価格は保存されません。
  3. バリエーション商品の場合は、親ではなく各バリエーションにcustom_pricesを送信します。WPMLはこれをオリジナルのバリエーションに保存し、すべての言語で表示されます。親に送信された場合は保存されません。
  4. 保存された価格はmeta_dataから読み取ります(_regular_price_USD、_sale_price_USD、_price_USD)。REST呼び出しの応答にはcustom_pricesフィールドは含まれません。

複製または個別の翻訳

WPMLには2種類の翻訳された商品があります。どちらを使用しているかによって、インポートするテキストの処理が決定されます。

複製個別の翻訳
概要WPMLが維持するコピー独自のテキストを持つ翻訳
オリジナルの次回の保存後のテキストオリジナルのテキストに置き換えられる「すべてを翻訳する」がオフの場合、または「商品」が「なし」に設定されている場合にのみ保持される
価格と在庫オリジナルに従うオリジナルに従う
  • 表示される場所: 複製の「言語」ボックスに「This document is a duplicate of ... and it is maintained by WPML.」と表示され、個別に翻訳ボタンが配置されています。
  • 複製を個別の翻訳に変換する: 複製の「言語」ボックスで個別に翻訳をクリックするか、複数の商品の場合は、商品すべての商品に移動し、翻訳の言語に切り替えて商品にチェックを入れ、一括操作個別に翻訳を選択します。
  • パート2のプロセスで作成されるもの: プロセスAでは、すべてを翻訳するを使用して翻訳を作成します。プロセスBでは、個別の翻訳をインポートします。どちらも複製を必要としません。

最初の商品を追加する前のストアのセットアップ

  1. WooCommerce Multilingualのセットアップウィザードを実行します。 WPML Multilingual & Multicurrency for WooCommerceを有効化すると開きます。画面にはストアページ、グローバル属性、マルチ通貨があります。最初の画面では、すべての言語でショップ、カート、チェックアウト、マイアカウントを作成します。
  2. グローバル属性を翻訳可能にします。 ウィザードの「Which product attributes should be translatable?(どの商品属性を翻訳可能にしますか?)」画面で、色やサイズなどの各属性にチェックを入れます。後から設定する場合は、商品属性編集のTranslatable?チェックボックスを使用します。
  3. 商品の前に属性タームを翻訳します。 WPML翻訳に移動してタクソノミータブを開き、「Select the taxonomy to translate」の下の属性を選択して各タームを翻訳します。プロセスAで「すべてを翻訳する」をオンにしている場合、WPMLが新しいタームを自動的に翻訳します。

パート2. コードなしでの構築

プロセスの選択: 1つの言語またはすべての言語

プロセスA: WPMLが翻訳プロセスB: すべての言語をインポート
システムが保持するものストアのデフォルト言語のみすべての言語
インポートするもの元の言語の商品元の言語の商品とその翻訳(SKUでリンク)
翻訳者Private Translation Cloud (PTC) (新しいタブで開く)を使用した「すべてを翻訳する」インポート前の翻訳者
元のテキストが変更された場合「すべてを翻訳する」が変更を翻訳WPMLが翻訳を更新待ちとしてマークし、次のファイルで新しいテキストを提供
価格と在庫元の言語に従う元の言語に従う

プロセスAは、1つの言語を維持し、翻訳ファイルなしで他のすべての言語を追加したいストアに適しています。プロセスBは、PIMや翻訳者がすでにすべての言語のテキストを保持しているストアに適しています。

WooCommerce CSVインポーターまたはWP All Importを使用したプロセスA

「すべてを翻訳する」を一度オンにします:

  1. WPML翻訳に移動し、すべてを翻訳するをセットアップするをクリックします。
  2. コンテンツを選択します。 「翻訳するコンテンツ」ですべての商品を選択したままにし、続行をクリックします。
  3. 翻訳の公開方法を選択します。 「公開方法」でレビューなしで公開を選択したままにします。
  4. すべてを自動翻訳するを有効化をクリックします。

ストアのデフォルト言語でのみ商品をインポートします。 商品インポート(WooCommerceのCSVインポーター)またはAll Import新規インポート(WP All ImportとWooCommerceアドオン)を使用します。ファイルにWPMLの列は必要ありません。

インポート自体によって翻訳がキューに追加されます。その後、WPMLがすべての商品、バリエーション、カテゴリー、新しい属性タームを各言語に翻訳して公開します。手動で開始する必要はなく、WPMLの管理画面を開いておく必要もありません。進行状況はWPML翻訳で確認できます。

元のテキストを編集した場合、「すべてを翻訳する」は変更された部分のみを翻訳します。翻訳の残りの部分はそのまま維持されます。

「すべてを翻訳する」は、外部商品を含む公開済みの商品を翻訳します。非公開の商品は翻訳しません。下書きも待機状態になります。WPML設定AI 翻訳の「高度な翻訳エディタ」ボックス内にある下書きを自動的に翻訳はデフォルトでオフになっており、これをオンにした場合、WPMLは下書きを再度保存したときにのみ翻訳します。下書きや非公開の商品を翻訳するには、WPML翻訳から送信してください(トラブルシューティングを参照)。

翻訳を変更したい場合、商品の「言語」ボックスから開いて(...の翻訳を編集)、高度な翻訳エディタで編集し、保存して完了をクリックします。後で元のテキストが変更されても、変更されていない文に対する編集内容は維持されます。

WooCommerce CSVインポーターを使用したプロセスB

プロセスBでは、ファイルにすべての言語が含まれます。

最初のインポートの前に、インポートする翻訳に対して「すべてを翻訳する」を設定します:

  1. WPML翻訳に移動します。 「すべてを翻訳する」がオフの場合は、オフのままにしてファイルに進みます。
  2. ページ、投稿、文字列をWPMLに自動翻訳させたい場合は、すべてを翻訳するをセットアップするをクリックします。「翻訳するコンテンツ」で、商品をなしに設定します。続行をクリックし、レビューなしで公開を選択したままにして、すべてを自動翻訳するを有効化をクリックします。
  3. 「すべてを翻訳する」がすでにオンになっている場合は、「すべてを自動翻訳するが有効になっています」ボックスの3点メニューをクリックし、コンテンツ制限の調整を選択して、商品をなしに設定し、変更を保存するをクリックします。すでに進行中の翻訳は引き続き完了します。

商品をなしに設定することで、WPMLはインポートされた商品の翻訳をそのまま維持します。元のテキストが変更されると、WPMLは該当する翻訳を更新待ちとしてマークし、次のファイルで新しいテキストがインポートされます。

すべての言語を含む1つのファイルを準備します。 WooCommerceの通常の列を使用し、WPMLの4つの列を追加します。

列保持する内容例
Meta: _wpml_import_translation_group言語をリンクする値。SKUを使用します。HP-JK-SHELL
Meta: _wpml_import_language_code行の言語de
Meta: _wpml_import_source_language_code元の言語(ストアのデフォルト言語)。元の言語の行では空にします。en
Meta: _wpml_import_after_process_post_statusWPMLが商品をリンクした後のステータスpublish
  • 言語ごとに行を並べ替え、元の言語を最初に配置します。各言語内で、商品はバリエーションの前に配置します。
  • 商品を下書きとしてインポートします: 商品ではPublished = -1、バリエーションでは1とします。
  • 各言語に独自のテキストを指定します: 名前、説明、カテゴリー(Kleidung > Jacken)、属性値(Blau, Grün)などです。
  • ストアの属性名(Color、Size)はすべての言語で維持します。属性ラベルはWPML翻訳タクソノミーで翻訳します。
  • 関連商品と親商品をSKUで指定し、すべての言語で同じSKUを使用します。

サンプルファイルにあるバリエーション商品のドイツ語の行:

Type,SKU,Name,Published,...,Categories,...,Parent,Attribute 1 name,Attribute 1 value(s),...,Meta: _wpml_import_translation_group,Meta: _wpml_import_language_code,Meta: _wpml_import_source_language_code,Meta: _wpml_import_after_process_post_status
variable,HP-JK-SHELL,Verstaubare Regenjacke,-1,...,Kleidung > Jacken,...,,Color,"Blau, Grün",...,HP-JK-SHELL,de,en,publish
variation,HP-JK-SHELL-BLU-S,,1,...,,...,HP-JK-SHELL,Color,Blau,...,HP-JK-SHELL-BLU-S,de,en,publish

インポートします:

  1. 商品インポートに移動し、「コンピューターから CSV ファイルを選択:」の下にあるファイルを選択します。「既存の商品を更新」のチェックは外したままにします。「続ける」をクリックします。
  2. マッピングを確認します。4つのMeta:列は、「メタデータとしてインポート」にマッピングされます。「インポーターの実行」をクリックします。
  3. WPMLWPML エクスポートとインポートに移動します。画面には「Good job. We see 33 posts that are imported and need language information.(よくできました。インポートされ、言語情報を必要とする33件の投稿があります。)」と表示されます。「WPMLインポートを実行」をクリックします。
  4. 「Multilingual Import Complete(多言語インポート完了)」と表示されるまで待ちます。

ステップ3までは、すべての商品は英語の下書きであり、すべてのバリエーションは英語のバリエーションで、どれも元の言語にリンクされていません。ステップ3の後は以下のようになります。

  • 各商品と各バリエーションは、言語間でリンクされます。
  • すべて公開されます。
  • 翻訳は独立した翻訳になります。
  • カテゴリーと属性タームは言語間でリンクされ、各言語のバリエーションは独自のタームを使用します。
  • アップセルは同じ言語の商品を指し、各言語には独自の画像のコピーが用意されます。

カテゴリーと属性タームは商品の行に含まれるため、このインポーターでは個別のタクソノミーのインポートは必要ありません。翻訳された属性タームがすでにストアに存在する場合、インポーターはそれらを使用し、「WPMLインポートを実行」によって元の言語に接続されます。

商品が「None」に設定されている状態で、選択した商品をWPMLに自動翻訳させるには、以下の手順に従います。

  1. 「すべてを翻訳する」をオンにしたままにします。
  2. 翻訳する各商品の値を1にして、ファイルにMeta: _wpml_import_tea列を追加します。
  3. 同じファイルにMeta: _wpml_import_translation_groupを保持します。
  4. ファイルをインポートし、WPMLWPML エクスポートとインポートに移動して「WPMLインポートを実行」をクリックします。進行状況リストに「Sending Posts for Automatic Translation(自動翻訳のために投稿を送信中)」と表示され、WPMLがそれらの商品を翻訳して公開します。

WP All Importを使用したプロセスB

WP All Import ProとそのWooCommerceアドオンが必要です。無料版ではカスタムフィールドをインポートできませんが、WPMLの列はカスタムフィールドです。

作業の順序は、まず属性タームとその翻訳を接続し、次に商品を処理します。これにより、翻訳された商品ページでは、各属性値がそれぞれの言語(たとえばNavyではなくBleu marineなど)で提供されます。

  1. ストアにすでに存在する翻訳済みタームを接続します。ストアにすでに存在する翻訳済みの各属性タームについて、商品属性に移動し、属性の「タームの設定」をクリックします。管理バーをタームの言語に切り替え、ターム名をクリックします。「言語」ボックスで、「これは以下の翻訳です」の下にある元の言語を選択し、「更新」をクリックします。接続された各タームは、WPML翻訳タクソノミーで、その言語の下に鉛筆アイコンが表示されます。
  2. インポートを実行する前に、管理バーの言語スイッチャーで管理画面の言語をストアのデフォルト言語に設定します。
  3. カテゴリーをインポートします。All ImportNew ImportUpload a fileに移動し、TaxonomiesProduct categoriesを選択します。「タームメタ」の下に_wpml_import_language_code、_wpml_import_source_language_code、_wpml_import_translation_groupの3つの行を追加し、それぞれをファイルの同名の列にマッピングします。Other Category OptionsParent Termで親を設定します。
  4. 同じ方法で属性タームをインポートします。たとえば、同じ3つのタームメタの行を使用して、TaxonomiesProduct Colorをインポートします。
  5. タームを接続します。WPMLWPML エクスポートとインポートに移動し、「WPMLインポートを実行」をクリックします。WPML翻訳タクソノミー(「Select the taxonomy to translate(翻訳するタクソノミーを選択)」でタクソノミーを選択)で、各タームの各言語の国旗の下に鉛筆アイコンがある1つの行があることを確認します。鉛筆アイコンにカーソルを合わせると、翻訳された名前が表示されます。「+」は、その言語に翻訳がないことを意味します。独自の行にリストされている翻訳済みタームは接続されていません。
  6. 商品をインポートします。「WooCommerce Products」を選択します。「WooCommerce Add-On」セクションで、SKU、価格、在庫、属性をマッピングします。「カスタムフィールド」の下に、3つの_wpml_import_*行を追加します。
  7. もう一度「WPMLインポートを実行」をクリックし、「Multilingual Import Complete(多言語インポート完了)」と表示されるまで待ちます。

サンプルのタームファイル:

name,_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group
Navy,en,,color-navy
Marineblau,de,en,color-navy

すべての言語を保持する商品ファイルの2つの設定:

  • バリエーションの行は、「Set Product Type With XPath」にマッピングする列で、親と同じvariableタイプを持ちます。
  • 言語ごとのキーを使用して、バリエーションを親にリンクします。「Variations」の下で、「All my variable products have SKUs or some other unique identifier...」を選択し、「SKU element for parent」と「Parent SKU element for variation」をHP-OW-RAIN-deなどのキーにマッピングします。すべての言語で同じ実際のSKUを、GeneralSKUと翻訳グループにマッピングします。もう1つの方法は、言語ファイルごとに1回のインポートを行うことです。

この順序は、WP All Importのインポートをwp-admin、WP-CLI、またはスケジュールのいずれから開始する場合でも機能します。

スケジュールに基づく在庫と価格の更新

元の商品を更新します。WPMLは在庫と価格をすべての言語にすぐにコピーします。

WooCommerce CSVインポーターを使用する場合:

  1. 変更する列のみを送信します。空のセルのある列は、空の値を書き込みます。サンプルファイル:
    SKU,Stock,Regular price,Meta: _wpml_import_language_code
    HP-JK-FIELD,11,95,en
    HP-JK-SHELL-BLU-S,5,72,en
  2. すべての行に、元の言語のMeta: _wpml_import_language_codeを追加します。これにより、各行はその言語(元の言語)の商品を更新します。この列がない場合、行は管理画面の現在の言語で商品を更新するため、結果は管理画面の言語スイッチャーに依存します。
  3. 管理バーの言語スイッチャーで、管理画面の言語をストアのデフォルト言語に設定します。
  4. 商品インポートに移動し、ファイルを選択して「既存の商品を更新」にチェックを入れ、「続ける」をクリックして「インポーターの実行」をクリックします。

インポートの直後、すべての言語で新しい在庫、価格、および価格帯が表示されます。

WP All Importを使用してスケジュール実行する場合:

  1. サプライヤーのフィードURLを使用して、All ImportNew ImportDownload a fileFrom URLに移動します。WooCommerce Productsを選択します。
  2. WooCommerce Add-Onセクションで、SKU、Regular Price、Stock Qtyをマッピングします。
  3. Import Settingsで、Attempt to match to existing WooCommerce products before creating new onesにチェックを入れ、Custom fieldの_skuで照合します。Create new WooCommerce products from records newly present in this import fileをオフにします。Update existing WooCommerce products with the data in this import fileをオンにします。
  4. Choose which data to updateで、Custom Fields以外をすべてオフにし、Update only these Custom Fields, leave the rest aloneを選択して_regular_price, _price, _stock, _manage_stockを指定します。
  5. スケジュールを設定します。All ImportManage ImportsScheduling OptionsのManual Schedulingに、サーバーのcronジョブ用のTrigger URLとProcessing URLが表示されます。

実行するたびに行が元の製品(商品)と照合され、すべての言語で各商品およびバリエーションの新しい価格と在庫が反映されます。

プロセスBの完全なファイルをアップデートとして再度インポートする場合、すべての行でPublishedを1に設定します。そうしないと、Run WPML Importを実行するまで公開中の商品が下書きになります。Update existing productsにチェックを入れ、Run WPML Importをクリックします。商品は公開済みのまま維持され、ファイル内のテキストが即座に翻訳に置き換わります。

既存のカタログへの言語の追加

プロセスA:

  1. WPML言語に移動し、サイト言語の管理と非表示をクリックして、言語を検索して追加…を使用して言語を選択します。
  2. コストを計算をクリックします。「コンテンツを...に翻訳するためのコスト」ダイアログに、アイテムと単語がリスト表示されます。保存をクリックします。

次回WPML管理画面が読み込まれたときに、すべてを翻訳する機能が新しい言語の翻訳を自動的に開始します。WPMLは、新しい言語ですべての商品とバリエーションを翻訳して公開します。既存の言語には影響しません。

プロセスB:

  1. 新しい言語の行のみを含むファイルを準備します。SKUを翻訳グループとして、元の言語を翻訳元言語として使用し、Published = -1、および最終ステータスとしてpublishを使用します。
  2. 商品インポートに移動します。Update existing productsのチェックは外したままにします。インポーターを実行します。
  3. WPMLWPML エクスポートとインポートに移動し、Run WPML Importをクリックします。

各新しい商品とバリエーションは、SKUで照合され、元の商品の翻訳グループに参加します。これは、これまでインポートされたことのないカタログも含め、どのカタログでも機能します。新しい言語は、ファイルから独自のカテゴリーと属性タームを取得します。

Update existing productsでは言語は追加されません。インポーターはそれらの行をスキップします。新しい言語の各商品には「No matching product exists to update.」、新しい言語の各バリエーションには「A new variation cannot be created without a parent product.」と表示されます。

大規模なカタログのインポート

  • 言語ごとに1つのファイルをインポートします。元の言語を最初にします。
  • 最後のファイルの後に、Run WPML Importを1回実行します。
  • 長時間の実行には、WP-CLIを使用します。wp wpml import processはボタンと同じステップを実行し、各ステップのカウントを表示します。

私たちのラボで、WooCommerceのインポーターと1回のRun WPML Importを使用して、3つの言語のカタログを処理した場合の所要時間は次のとおりです。

言語ごとの商品数インポート全体そのうちのRun WPML Import
500約30分数分
1,000約1時間約10分
2,000約2時間約30分

どのサイズも1回の実行で完了し、すべての言語ですべての商品とバリエーションが存在し、接続されていました。各数値は、共有ラボサーバーでの1回の実行結果です。ほとんどの時間はWooCommerceインポーターによるものであり、サーバーに依存します。これらの数値は目安としてお考えください。

言語を含む商品のエクスポート(WP All Export)

WP All Exportは、デフォルトでWooCommerce商品のエクスポートにWPMLの列_wpml_import_language_code、_wpml_import_source_language_code、および_wpml_import_translation_groupを追加します。そのWPMLセクションでは、すべての言語または1つの言語をエクスポートできます。手動で実行するエクスポートとスケジュールされたエクスポートの両方で、これらの列が入力されます。詳しくは、WP All Exportを使用した多言語ウェブサイトのエクスポートをお読みください。

ERPまたはPIMからの同期

ERP(企業資源計画システム)は、企業が在庫、価格、注文を管理するソフトウェアです。PIM(商品情報管理システム)は、商品のテキストやデータを管理する場所です。

このようなシステムとWooCommerce間のコネクタは、通常次のように機能します。

  • カタログをSKUをキーとして1つの言語で保持する
  • SKU(GET /wc/v3/products?sku=...)によって各商品を検索する
  • WooCommerce REST APIを通じて、既存商品の在庫と価格を更新し、新規商品を作成する
  • スケジュールに従って実行される

WPMLで機能するフローは次のとおりです。

  1. コネクタはストアのデフォルト言語にのみ書き込みます。
  2. 同じリクエスト内で、WPMLが在庫と価格をすべての言語にコピーします。
  3. すべてを翻訳するが新規商品をすべての言語に翻訳します(プロセスA)。
  4. コネクタが下書きに設定した商品は、すべての言語で下書きになります。
  5. コネクタが削除した商品は、WPML設定コンテンツの削除の商品行の設定に従います。同期中は確認メッセージが表示されないため、元の言語のコンテンツの削除を希望する動作に設定してください。すべての言語を削除するを選択すると翻訳も一緒に削除され、その言語のみを選択すると翻訳は公開されたままになります。

コネクタのベンダーに次の3つの質問をしてください。

  1. WooCommerceを通じて書き込みますか、それともデータベースに直接書き込みますか。データベースに直接書き込まれた変更は、元の言語にのみ反映されます。翻訳には古い在庫と価格が保持されます。
  2. どの言語に書き込みますか。元の言語に書き込む必要があります。翻訳に書き込まれた価格は保存されず、翻訳には元の言語の価格が保持されます。
  3. 言語ごとに1つの商品を作成しますか。WooCommerceは、同じSKUを持つ2つ目の商品を拒否します。SKUがない場合、コピーは別々の商品となり、在庫や価格の更新が行われません。コネクタには元の言語のみを作成させ、翻訳はWPMLに行わせてください。

パート3. カスタムフローの構築(開発者向け)

WooCommerce REST APIを使用した商品とその翻訳の作成

最初にタームを作成し、次に元の言語を作成してから、langとtranslation_ofを使用して各翻訳を作成します。

  1. カテゴリー(および任意の属性ターム)を翻訳します:POST /wp-json/wc/v3/products/categories
    JSON
    {
      "name": "Wohnen und Geschenke",
      "slug": "wohnen-und-geschenke",
      "lang": "de",
      "translation_of": 32
    }

    属性タームの場合は、各タームで同じ2つのフィールドを持つPOST /wc/v3/products/attributes/<id>/terms/batchを使用します。

  2. 元の言語を作成します:POST /wp-json/wc/v3/products
    JSON
    {
      "name": "Stoneware Coffee Mug",
      "type": "simple",
      "status": "publish",
      "sku": "HP-HG-MUG",
      "regular_price": "16.00",
      "manage_stock": true,
      "stock_quantity": 60,
      "categories": [ { "id": 32 } ],
      "lang": "en"
    }
  3. 各翻訳を作成します:POST /wp-json/wc/v3/productsを使用し、翻訳されたテキスト、翻訳されたカテゴリー、lang、およびtranslation_of(元の言語のID)を指定します。SKU、価格、在庫は送信しないでください。WPMLが元の言語からこれらをコピーします。
    JSON
    {
      "name": "Steingut-Kaffeebecher",
      "slug": "steingut-kaffeebecher",
      "status": "publish",
      "categories": [ { "id": 38 } ],
      "lang": "de",
      "translation_of": 120
    }
  4. GETで結果を読み取ります。作成呼び出しに対する応答では、SKU、価格、在庫が空で表示されます。これは、応答が構築された後にWPMLがこれらをコピーするためです。直後にGET /wc/v3/products/121を実行すると、これらが表示されます。

バリエーション商品の場合は、元の言語のバリエーションを元の言語にのみ作成します(POST /wc/v3/products/<id>/variations/batch)。次に、langとtranslation_ofを使用して翻訳された各親商品を作成します。WPMLは翻訳されたバリエーションを自動的に作成し、それぞれを元の言語のバリエーションにリンクして、その言語でのSKU、価格、在庫、および属性タームをコピーします。翻訳にバリエーションをPOSTしないでください。

?lang=を使用して翻訳のバリエーションを読み取ります:GET /wc/v3/products/137/variations?lang=fr。各バリエーションには、lang、そのtranslationsマップ、およびその言語でのオプション名が含まれます。

言語ごとに1つの商品翻訳。すでに翻訳が存在する言語で2つ目の商品翻訳を作成しようとすると、HTTP 400 wcml_translation_existsで拒否され、何も作成されません。メッセージには既存の翻訳のIDが記載されます。代わりに既存の翻訳を更新してください。

完全なフィールドリファレンス:WooCommerce Multilingual REST API。

WooCommerce REST APIを使用した商品の更新

元の言語を更新します。同じリクエスト内で、WPMLがすべての言語に変更をコピーします。

  • {"regular_price": "59.00", "stock_quantity": 3}を指定したPUT /wc/v3/products/123/variations/124により、すべての言語でそのバリエーションの価格と在庫が変更され、価格帯もそれに従います。
  • 新しい通常価格、セール価格、または在庫を指定したPUT /wc/v3/products/120により、すべての言語でこれらが変更されます。
  • 新しい属性タームは元の言語の属性に作成され、上記の手順1と同様にlangとtranslation_ofを使用して翻訳されます。
  • 元の言語に追加された新しいバリエーション(POST /wc/v3/products/123/variationsまたは.../variations/batch)は、リンクされた状態で、価格と在庫とともに同じリクエスト内ですべての言語に反映されます。呼び出しに対する応答には元の言語のみがリストされますが、直後にGET /wc/v3/products/130/variations?lang=deを実行すると、新しく翻訳されたバリエーションがリストされます。
  • 翻訳に送信された価格や属性は保存されません。翻訳には元の言語の値が保持されます。任意の言語に送信された在庫値は、すべての言語の在庫になります。

APIを通じた削除:DELETE /wc/v3/products/<id>は、WPML設定コンテンツの削除の商品行の設定に従います。APIは確認を行いません。確認するに設定されている場合は元の言語のみを削除します。元の言語のコンテンツの削除をストアが希望する動作に設定してください。すべての言語を削除するに設定すると、削除によってすべての言語がゴミ箱に移動し、?force=trueですべての言語が完全に削除されます。

独自のインポーターまたはコネクタの作成

WooCommerceの商品関数を使用します。WPMLが変更を検知し、それをすべての言語にコピーします。

PHP
$id      = wc_get_product_id_by_sku( 'HP-HG-MUG' ); // returns the original
$product = wc_get_product( $id );
$product->set_regular_price( '19.00' );
$product->set_stock_quantity( 33 );
$product->save();

save()の実行後、翻訳には新しい価格と在庫が表示されます。

商品データをデータベースに直接書き込まないでください(update_post_meta()やSQLなど)。元の言語は変更されますが、翻訳には古い値が保持されたままになります。

WPMLの列を含むインポートの後に、コードからWPMLインポート手順を実行します:wp wpml import process。これは「WPMLインポートを実行」ボタンと同じ手順を実行し、それぞれの手順とそのカウントを出力します。

スケジュールされたジョブ

WooCommerceの商品関数を使用して元の言語を変更するスケジュールされたジョブ(WP-Cron)は、ジョブ自体のリクエスト内のすべての言語に以下の変更を適用します。

  • 通常価格、セール価格、在庫、およびそれに伴う在庫ステータス
  • 商品に追加されたカテゴリー(翻訳されたカテゴリーとして)
  • バリエーション商品に対する新しい属性ターム(その翻訳として)
  • バリエーション商品の価格帯

パート4. トラブルシューティング

インポートされた翻訳がリンクされていない個別の商品として表示される問題

現象:翻訳された行が欠落しているか、英語(デフォルト言語)の商品として配置され、多くの場合非公開になっており、元の言語へのリンクがありません。

原因:

  • ファイルにWPMLの列がありません。この場合、WooCommerceはSKUがすでに存在するすべての行をスキップします。「A product with this SKU already exists.(このSKUを持つ商品はすでに存在します。)」
  • ファイルにはWPMLの列がありますが、WPMLインポートを実行が実行されていません。実行されるまで、すべての行は元の言語へのリンクがないデフォルト言語の商品であり、ステータスはファイルのPublished列で指定されたもの(0の場合は非公開、-1の場合は下書き)になります。WPMLエクスポートとインポートには「Good job. We see 12 posts that are imported and need language information.(よくできました。インポートされ、言語情報を必要とする12件の投稿が見つかりました。)」と表示されます。

今すぐ修正する方法:

  • WPMLインポート手順が実行されていない場合:WPMLエクスポートとインポートに移動し、WPMLインポートを実行をクリックします。
  • WPMLの列がない場合:翻訳行に4つのWPMLの列を追加し、既存の商品を更新のチェックを外して、新しいインポートとして再度インポートします。その後、WPMLインポートを実行をクリックします。各翻訳はSKUによって元の言語に結合されます。

回避方法:常にWPMLの列を含め、すべてのインポートの後にWPMLインポートを実行を実行します。

インポートされた翻訳が元の言語のテキストに置き換えられる問題

現象:翻訳された名前と説明をインポートしましたが、次に元の言語を保存した後、元の言語に戻ってしまいます。

原因:翻訳が複製でした。WPMLは、元の言語が保存されるたびに複製を上書きします。

今すぐ修正する方法:

  1. 個別に翻訳するように設定します。商品すべての商品に移動し、翻訳の言語に切り替えて、商品にチェックを入れ、一括操作個別に翻訳を選択します。
  2. 「すべてを翻訳する」がオンになっている場合は、商品を「なし」に設定します。WPML翻訳で、「Translate Everything Automatically is enabled(すべてを自動翻訳するが有効です)」ボックスの3点メニューをクリックし、コンテンツ制限の調整を選択して、商品をなしに設定し、変更を保存するをクリックします。
  3. 翻訳を再度インポートします。

その後、元の言語を保存してもインポートされたテキストは保持されます。

回避方法:既存の翻訳にテキストをインポートする前に、それらを個別に翻訳に設定します。または、WPMLの列を使用して翻訳を新しい商品としてインポートします(プロセスB)。

翻訳された商品に元の言語の属性値が表示される問題

現象:翻訳された商品ページに、翻訳されたタームの代わりに「Blue」や「Green」が表示されます。

原因: 属性のタームが翻訳される前に商品が翻訳されました。

今すぐ修正する方法:

  1. WPML翻訳に移動し、タクソノミータブを開きます。
  2. 「翻訳するタクソノミーを選択」で、属性(商品の色など)を選択します。
  3. 各言語の各タームを翻訳し、保存をクリックします。同じ画面で属性のラベルも翻訳します。

既存の翻訳済み商品は、保存するたびに各タームを反映します。商品を再度保存する必要はありません。タームが最初に元の名前のコピーとして作成された場合、そのスラッグは元のテキストを保持します。同じダイアログで変更してください。

回避策: 商品を翻訳またはインポートする前に、属性のタームを翻訳します。

インポート後、翻訳済みのカテゴリーやタームが元の名前を保持する

症状: 翻訳されたショップで、翻訳済みの商品が「Sunglasses」というカテゴリーに配置されているか、「Blue」というオプションを提供しています。

原因: 翻訳の行が元のエクスポートからコピーされ、そのカテゴリー、タグ、属性のターム名が保持されました。WPMLはそれらの名前で翻訳されたタームを作成し、正しくリンクしますが、名前の変更は行いません。元のIDで指定されたアップセル、クロスセル、画像、ギャラリー、バリエーションの親は、適切な言語に再マッピングされます。

今すぐ修正する方法: 上記のセクションと同様に、WPML翻訳タクソノミーでタームの名前を変更します。パンくずリスト、タームのリンク、アーカイブの見出し、属性のオプションには新しい名前がすぐに表示され、商品を再度保存する必要はありません。同じダイアログで変更しない限り、スラッグは元のテキストを保持します。

回避策: 翻訳の行には、翻訳されたカテゴリー、タグ、属性のターム名を元と同じ順序で記述します。関連商品や親はSKUで指定します。

他の言語の在庫や価格が元の言語より遅れている

症状: 元の言語には新しい在庫や価格が表示され、翻訳には古いものが表示されます。

原因: 変更がWooCommerceまたはWPMLをバイパスしました。

  • コネクタがデータベースに直接書き込みました。
  • WPMLが無効化されている間にインポートが実行されました。

確認方法: 商品エディタで元の言語を開きます。説明エディタの下に「Last edited on」と日時が表示されます。その時間が「商品データ」ボックスの新しい価格や在庫よりも古い場合、またはWPMLが無効な間に変更が行われた場合、更新は同期をバイパスしています。

今すぐ修正する方法:

バリエーション商品の場合:

  1. WPMLサポートWCML 翻訳を修正に移動します。「WCML 翻訳を修正」は、別のプラグインであるWPML Troubleshootingの一部です。
  2. 商品バリエーションを同期にチェックを入れ、選択したツールを実行をクリックします。

これにより、すべての言語で元のバリエーション価格と在庫、および商品の価格帯が表示されます。

シンプルな商品の場合、以下のいずれかの方法を使用します。それぞれ、元の価格と在庫をすべての言語に反映します。

  • 1回に1商品ずつ行う場合: 変更された元の言語をそれぞれ開き、更新をクリックします。
  • インポートで複数の商品を行う場合: 管理画面の言語をデフォルト言語に設定した状態で、商品インポートを使用し、既存の商品を更新するにチェックを入れて商品を再度インポートします。ファイルには、元の言語がすでに持っている値を含めることができます。これにより、バリエーション商品も再調整されます。
  • RESTで複数の商品を行う場合: 各商品の価格とともにPUT /wc/v3/products/<id>を送信します(例: {"regular_price": "19.50"})。
  • 複数の商品を同じ価格にする場合: 商品すべての商品で商品にチェックを入れ、一括操作編集を選択して適用をクリックします。価格で変更:を選択し、価格を入力して更新をクリックします。チェックを入れたすべての商品にその価格が設定されます。

元の言語がすでに持っている値でwp wc product updateを実行しても、翻訳には反映されません。

回避策: コネクタがWooCommerce(REST APIまたは商品機能)を介して書き込むようにし、インポート中はWPMLを有効にしておきます。

REST APIを通じて作成された商品が間違った言語やグループに配置される

症状: 翻訳が間違った言語で表示されるか、SKUや元の言語へのリンクがない別の商品として表示されます。

原因:

  • 不明な言語コードはHTTP 422 Invalid language parameter: "ge"で拒否され、何も作成されません。
  • "lang": "fr"で送信されたドイツ語のテキストなど、有効だが間違っているコードは、その言語で翻訳を作成します。
  • translation_ofが欠落していると、SKUやコピーされた価格、在庫がない独自のグループに商品が作成されます。

今すぐ修正する方法: 適切な言語とリンク、そしてPUT /wc/v3/products/<id>を指定して商品を再度送信します。

JSON
{
  "lang": "de",
  "translation_of": 38
}

商品は元の言語のグループに移動し、そのSKU、価格、在庫を取得します。バリエーション商品の場合、WPMLはリンクなしで作成されたバリエーションを、リンクされた新しいバリエーションに置き換えます。新しいバリエーションIDを読み取ってください。

回避策: すべての翻訳でlangとtranslation_ofを送信し、最初にタームを作成して、WPMLに翻訳のバリエーションを作成させます。

新しくインポートされた商品が自動的に翻訳されない

症状: インポートされた商品が元の言語のままになります。

原因: インポート中に「すべてを翻訳する」がオフになっていたか、商品が非公開(「すべてを翻訳する」では翻訳されません)であるか、下書き(下書きを自動翻訳するがオンで、下書きが再度保存された場合にのみ翻訳されます)であるためです。

今すぐ修正する方法:

  • 商品を送信する: WPML翻訳に移動して商品セクションを開き、商品にチェックを入れます。各言語で自動的に翻訳を選択し、「WPML がコンテンツの自動翻訳を完了したとき、どうしますか?」でレビューなしで公開を選択して、コンテンツを翻訳をクリックします。これは下書きや非公開商品にも機能し、翻訳は元のステータスを引き継ぎます。
  • または「すべてを翻訳する」をオンにする: まだ翻訳されていないすべての公開済み商品を翻訳します。WPMLの管理画面が読み込まれる間にWPMLがそれらを送信します。
    1. WPML翻訳すべてを翻訳するをセットアップする続行すべてを自動翻訳するを有効にするに移動します。
    2. 「コンテンツの翻訳が完了しました」と表示されるまで、WPML翻訳に留まります。

回避策: インポートの前に「すべてを翻訳する」をオンにし(プロセスA)、公開済みとして商品をインポートします。

執筆者:Amir