# 翻訳: WCPOS Polylang

[Polylang](https://polylang.pro/) 対応を WCPOS に追加し、POS が単一言語の商品のみを表示するようにします。商品検索、カタロググリッド、レジ業務で翻訳の重複が発生しません。WCPOS Pro の店舗では店舗ごとに言語を固定できます。無料版では Polylang のデフォルト言語が適用されます。

## 機能概要[​](#what-it-does "機能概要への直接リンク")

* WCPOS の商品およびバリエーションの REST クエリを言語でフィルタリングします。
* WCPOS の**高速同期**ルート（POS がローカルインデックスを更新するために使用する軽量な `posts_per_page=-1` + `fields` リクエスト）をインターセプトし、翻訳の重複がクライアントに届かないようにします。
* 無料版では、Polylang のデフォルト言語が適用されます。
* Pro 版では、店舗エディタの新しい**言語**セクションから店舗ごとに言語を選択できます。
* 高速同期ペイロードの構築時に、WCPOS の **POS 限定**商品表示設定を考慮します。

Polylang が有効でない場合、この連携機能は何も行いません。Polylang を有効化する前にプラグインをインストールしても、エラーは発生しません。

## インストール[​](#installation "インストールへの直接リンク")

1

#### JA: Polylang のインストール

[Polylang](https://wordpress.org/plugins/polylang/)（または Polylang Pro）をインストールし、通常どおりサイトの言語を設定してください。少なくとも1つの言語がデフォルトとして設定されていることを確認してください。

2

#### JA: WCPOS Polylang のインストール

`WP Admin > POS > 設定 > 拡張機能` の WCPOS 拡張機能ディレクトリからインストールするか、[GitHub リリースページ](https://github.com/wcpos/wcpos-polylang/releases)から最新リリースをダウンロードし、`プラグイン > 新規追加 > プラグインのアップロード` からアップロードしてください。

3

#### JA: （Pro）店舗ごとの言語設定

WCPOS Pro で[複数の店舗](/ja/stores/.md)を運営している場合は、`POS > 店舗` に移動して店舗を編集し、**言語**サイドバーセクションから言語を選択してください。Polylang のデフォルト言語を使用するには、*デフォルト*のままにしてください。

## 店舗ごとの言語設定（Pro）[​](#per-store-language-pro "店舗ごとの言語設定（Pro）への直接リンク")

WCPOS Pro では、店舗エディターのサイドバーに**言語**セクションが追加されます。各店舗を Polylang の言語スラッグに固定でき、その店舗に提供される商品は該当言語のみにフィルタリングされます。*デフォルト*のままの店舗は、Polylang のデフォルト言語を使用します。

店舗ごとの値は店舗投稿の `_wcpos_polylang_language` メタとして保存され、WCPOS Pro 店舗 REST API (`/wcpos/v1/stores`) を通じて公開されるため、他の店舗設定と同様に POS を経由してラウンドトリップします。

## 互換性に関する注意事項[​](#compatibility-notes "互換性に関する注意事項への直接リンク")

* **POS 専用商品：** WCPOS 設定で POS 専用モードが有効になっている場合、オンライン専用の商品 ID は高速同期ペイロードから除外され、POS に漏れることはありません。
* **無料版：** 店舗ごとに言語を変更するUIはありません。プラグインはPolylangのデフォルト言語を使用します。店舗ごとの言語設定が必要な場合は、[WCPOS Pro](/ja/getting-started/pro-license.md)にアップグレードしてください。
* **プラグイン無効時：** Polylangが無効化されている場合、プラグインは何も動作しません。エラーが発生したり、POSがブロックされることはありません。

## 開発者向けフック[​](#developer-hooks "開発者向けフックへの直接リンク")

高度な用途向けに、プラグインはいくつかのフィルターを公開しています：

| フィルター                         | 用途                                                                                                    |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `wcpos_polylang_resolved_language` | リクエストに使用する言語をオーバーライドします。解決済みのスラッグと `WP_REST_Request` を受け取ります。 |
| `wcpos_polylang_default_language`  | 店舗ごとの値が設定されていない場合のフォールバック言語をオーバーライドします。                          |
| `wcpos_polylang_is_supported`      | Polylangの検出結果に関係なく、プラグインを強制的に有効または無効にします。                              |
| `wcpos_polylang_minimum_version`   | Polylangの最低バージョンを要求します（デフォルト：バージョン制限なし）。                                |

## 要件[​](#requirements "要件への直接リンク")

JA: WooCommerce

<!-- -->

: WooCommerceがインストールされ、有効化されていること

JA: Polylang

<!-- -->

: Polylang（無料版またはPro版）で、少なくとも1つの言語が設定されていること

JA: WCPOS

<!-- -->

: 無料版でも動作しますが、店舗ごとの言語選択にはWCPOS Proが必要です

## 関連項目[​](#related "関連項目への直接リンク")

* [WCPOS WPML](/ja/extensions/wpml.md)
* [WCPOS WP Multilang](/ja/extensions/wp-multilang.md)
* [マルチ店舗](/ja/stores/.md)
* ソースコード: [github.com/wcpos/wcpos-polylang](https://github.com/wcpos/wcpos-polylang)