翻訳: WCPOS Polylang
Polylang 対応を WCPOS に追加し、POS が単一言語の商品のみを表示するようにします。商品検索、カタロググリッド、レジ業務で翻訳の重複が発生しません。WCPOS Pro の店舗では店舗ごとに言語を固定できます。無料版では Polylang のデフォルト言語が適用されます。
機能概要
- WCPOS の商品およびバリエーションの REST クエリを言語でフィルタリングします。
- WCPOS の高速同期ルート（POS がローカルインデックスを更新するために使用する軽量な
posts_per_page=-1+fieldsリクエスト）をインターセプトし、翻訳の重複がクライアントに届かないようにします。 - 無料版では、Polylang のデフォルト言語が適用されます。
- Pro 版では、店舗エディタの新しい言語セクションから店舗ごとに言語を選択できます。
- 高速同期ペイロードの構築時に、WCPOS の POS 限定商品表示設定を考慮します。
Polylang が有効でない場合、この連携機能は何も行いません。Polylang を有効化する前にプラグインをインストールしても、エラーは発生しません。
インストール
JA: Polylang のインストール
Polylang（または Polylang Pro）をインストールし、通常どおりサイトの言語を設定してください。少なくとも1つの言語がデフォルトとして設定されていることを確認してください。
JA: WCPOS Polylang のインストール
WP Admin > POS > 設定 > 拡張機能 の WCPOS 拡張機能ディレクトリからインストールするか、GitHub リリースページから最新リリースをダウンロードし、プラグイン > 新規追加 > プラグインのアップロード からアップロードしてください。
JA: （Pro）店舗ごとの言語設定
WCPOS Pro で複数の店舗を運営している場合は、POS > 店舗 に移動して店舗を編集し、言語サイドバーセクションから言語を選択してください。Polylang のデフォルト言語を使用するには、デフォルトのままにしてください。
店舗ごとの言語設定（Pro）
WCPOS Pro では、店舗エディターのサイドバーに言語セクションが追加されます。各店舗を Polylang の言語スラッグに固定でき、その店舗に提供される商品は該当言語のみにフィルタリングされます。デフォルトのままの店舗は、Polylang のデフォルト言語を使用します。
店舗ごとの値は店舗投稿の _wcpos_polylang_language メタとして保存され、WCPOS Pro 店舗 REST API (/wcpos/v1/stores) を通じて公開されるため、他の店舗設定と同様に POS を経由してラウンドトリップします。
互換性に関する注意事項
- POS 専用商品： WCPOS 設定で POS 専用モードが有効になっている場合、オンライン専用の商品 ID は高速同期ペイロードから除外され、POS に漏れることはありません。
- 無料版： 店舗ごとに言語を変更するUIはありません。プラグインはPolylangのデフォルト言語を使用します。店舗ごとの言語設定が必要な場合は、WCPOS Proにアップグレードしてください。
- プラグイン無効時： Polylangが無効化されている場合、プラグインは何も動作しません。エラーが発生したり、POSがブロックされることはありません。
開発者向けフック
高度な用途向けに、プラグインはいくつかのフィルターを公開しています：
| フィルター | 用途 |
|---|---|
wcpos_polylang_resolved_language | リクエストに使用する言語をオーバーライドします。解決済みのスラッグと WP_REST_Request を受け取ります。 |
wcpos_polylang_default_language | 店舗ごとの値が設定されていない場合のフォールバック言語をオーバーライドします。 |
wcpos_polylang_is_supported | Polylangの検出結果に関係なく、プラグインを強制的に有効または無効にします。 |
wcpos_polylang_minimum_version | Polylangの最低バージョンを要求します（デフォルト：バージョン制限なし）。 |