Commerce Currency Resolver

概要

Features

• 複数の通貨解決戦略：ストアベース（デフォルト）、Cookieベースのユーザー選択、言語ベースのマッピング、GeoIPまたはSmart IPによるジオロケーション
• 3つの価格処理モード：通貨ごとの専用価格フィールド、為替レートによる自動変換、または両方のアプローチを組み合わせたコンボモード
• 注文処理時の注文アイテム、プロモーション、手数料、カスタム調整、送料の自動通貨変換
• 訪問者がCookieに保存される希望の通貨を手動で選択できる通貨セレクターブロック
• 各サイト言語に通貨を割り当てる管理UIを備えた言語から通貨へのマッピング
• 柔軟なマトリックス設定を備えたジオロケーションサービス（GeoIPまたはSmart IP）による国から通貨へのマッピング
• 多通貨金額をサポートするためのCommerce Core promotionオファー（OrderFixedAmountOff、OrderItemFixedAmountOff）のオーバーライド
• 多通貨手数料計算のためのCommerce Feeプラグイン（OrderFixedAmount、OrderItemFixedAmount）のオーバーライド
• 送料の自動通貨変換のためのCommerce Shipping定額配送方法のオーバーライド
• 通貨依存コンテンツの適切なキャッシュのためのカスタムキャッシュコンテキスト（currency_resolver）
• 通貨の不一致を検出し、必要に応じて注文の再計算をトリガーするOrder Processor
• 注文の読み込みを監視し、ユーザーの解決された通貨が注文の通貨と異なる場合に通貨を更新するEvent Subscriber
• 通貨ごとの専用価格フィールドを作成するための設定可能なフィールドプレフィックスパターン（例：field_price_eur、field_price_usd）
• 割引価格の互換性のためのCommerce VADOとの統合

Use Cases

Tips

• 最適なキャッシュパフォーマンスのために、現在の通貨に依存するrender arrayには'currency_resolver'キャッシュコンテキストを使用してください。
• 通貨選択のCookie名はsettings.phpでSettings::set('commerce_currency_cookie', 'your_cookie_name')を使用してカスタマイズできます。
• プログラムで注文アイテムを追加する場合、注文アイテムを作成する前にcommerce_currency_resolver.price_resolverサービスを使用して正しい価格を解決してください。
• 通貨リゾルバの優先度が優先順位を決定：Cookie（1000）> GeoIP/Smart IP（900）> Language（800）> Store（デフォルト）。優先度の高いリゾルバが最初にチェックされます。
• Cookieサブモジュールを使用したリバースプロキシ設定では、Cookieを直接読み取る代わりにXヘッダー（デフォルトはX_COMMERCE_CURRENCY）を介して通貨を渡すことができます。
• プロモーション、手数料、配送方法の'fields'設定を使用して、通貨ごとの特定金額を設定してください。空のフィールドは自動変換にフォールバックします。
• CURRENCY_RESOLVER_SKIP_REFRESHフラグを注文データに設定して、特定の注文の自動通貨更新を防止できます。
• CURRENCY_RESOLVER_FORCE_REFRESHフラグを使用して、通常は更新をトリガーしない注文でもプログラムで通貨更新を強制できます。