VibeFox Mondial Relay for OpenCart — ヘルプ
要件
OpenCart: 3.0.x（3.0.5.0 で検証済み）または 4.0.2 以降（4.1.0.3 で検証済み）、デフォルトテーマ。
PHP: 8.0 以降。
Mondial Relay アカウント: ブランドコード（Enseigne）とプライベートキーは、Mondial Relay のビジネスアカウントに付属します。mondialrelay.fr のプロフェッショナル向けセクション、「Connect」のお客様専用エリア、または営業担当者をご確認ください。マップ選択にはブランドコードのみが必要です。ポイント一覧には両方が必要です。テスト用に、Mondial Relay はブランドコード BDTEST13 とプライベートキー PrivateK を提供しています。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
このダウンロードは、両方の OpenCart バージョン用のパッケージが入った zip ファイル 1 つです。コンピュータで解凍してください。README.txt、OpenCart 3 用パッケージ vfd_mondialrelay-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ vfd_mondialrelay.ocmod.zip が含まれています。お使いの OpenCart のバージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_mondialrelay-oc3-(version).ocmod.zip を選択します。この拡張機能は OCMOD の変更を追加しないため、Extensions > Modifications を更新する必要はありません。Installer を使う代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。
2. Extensions > Extensions に移動し、拡張機能の種類として Shipping を選択します。VibeFox Mondial Relay を見つけて、Install（緑色の + ボタン）をクリックします。
3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。
4. Edit ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（ライセンスキーを参照）。
5. ブランドコード（Enseigne）を入力し、リストモードの場合はプライベートキーも入力します。Country prices（例: フランスの行）または Fallback cost を入力し、Enable/Disable をオンにして、Save をクリックします。
OpenCart 4
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル vfd_mondialrelay.ocmod.zip を選択します。ファイル名を変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から読み取るため、名前を変更したパッケージは動作しません。
2. パッケージは同じページのインストール済み拡張機能の一覧に表示されます。その横の Install（緑色の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、拡張機能の種類で Shipping を選択します。VibeFox Mondial Relay を見つけ、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆のボタン）をクリックします。
4. ライセンスキーと設定は、OpenCart 3 の手順 4 と 5 と同じように入力します。設定ページとその項目は両方のバージョンで同じです。
インストール後は、Enable/Disable をオンにして保存するまで、この配送方法はオフのままです。拡張機能をアンインストールしてから再インストールした場合、保持されていた設定が再び使用されます。
設定
すべての設定は拡張機能のページにあります：Extensions > Extensions > Shipping > VibeFox Mondial Relay > Edit。セクションは左側に一覧表示されます。Save ボタンを 1 回押すと、ページを再読み込みせずにページ全体が保存されます。保存するたびに、キャッシュされたポイント一覧も消去されます。この拡張機能の変更権限を持つ管理者ユーザーのみが設定を保存できます。
ページ上部の警告には、配送方法を非表示にする問題が表示されます。ブランドコードがない、リストモードでプライベートキーがない、フランス、ベルギー、スペインの料金がない、そして拡張機能が認識しないストアの重量単位（その場合、商品の重量は kg として扱われます）などです。Name が空、64 文字を超える、または文字 < > ; = # { } のいずれかを含む場合、Min weight (kg) が Max weight (kg) より大きい場合、またはブランドコードが無効な場合は、ページにエラーが表示され、何も保存されません。数値フィールドの値が数値でない（または負の）場合は、Save 後に通知され、以前の値が保持されます。他の設定は保存されます。
一般
フランス、ベルギー、ルクセンブルク、スペイン、ポルトガル、オランダ向けの Mondial Relay Point Relais 配送です。この方式は、そのジオゾーン内（Availability を参照）、または Ignore shipping zones を使用する場合は記載された国で提供されます。
Enable/Disable: チェックアウトで Mondial Relay を表示または非表示にします。初期値：オフ。
Name: カートとチェックアウトで顧客に表示される配送方法の名前。初期値：Mondial Relay Point Relais。必須、最大 64 文字。
Tax status: None（初期値）は、表の料金が最終的な料金であることを意味します。税クラス名を持つ Taxable オプションは、OpenCart がその税クラスの配送税を料金に上乗せすることを意味します。
Sort order: チェックアウトの配送方法の中で Mondial Relay を表示する位置。整数です。
Mondial Relay アカウント
Brand code (Enseigne): 必須、最大 8 文字の英字と数字。例: テスト用の BDTEST13。ポイントのマップと Web Service で使用されます。これがないと顧客は Point Relais を選択できないため、この配送方法はチェックアウトに表示されません。
Private Key: List of nearest points 選択時にのみ必要です。保存後、フィールドは空のままとなり、Saved - leave empty to keep it. と表示されます。変更する場合のみ新しい値を入力してください。保存されたキーを削除するには、Remove the saved Private Key にチェックを入れて Save をクリックします。ブランドコードとプライベートキーが設定されている場合、設定を保存するたびに Mondial Relay Web Service への接続がテストされ、それらが有効かどうかがメッセージで表示されます。
受け取りポイントの選択
購入者は、支払い段階に進む前に Point Relais を選択する必要があります。ポイントは注文に保存されます。
選択方法: 購入者が Point Relais を選ぶ方法。
料金（ストアの初期設定通貨、税抜き）
Mondial Relay には公開された料金 API がないため、料金はこの表から算出されます。
Country prices: 配送先の国と荷物の重量ごとの料金。Add country をクリックすると行が追加され、削除ボタンで行を削除できます。他のすべての国には、国として * Default を選択します。各行には Price と重量列があります：XS は 1 kg まで、S は 1-2 kg、M は 2-3 kg、L は 3-5 kg、XL は 5 kg 超。空または 0 の重量列は Price 列を使用します。Price も空の場合、その重量の配送は無料になるため、一部の重量列のみを使用する場合は Price を入力してください。小数はピリオドまたはカンマで入力できます（4.90 または 4,90）。料金のない行や不明な国の行は保存時に削除され、数字ではない値は通知されて空欄になります。
Fallback cost: 表に行がない国に使用されます。その国で方式を非表示にするには、空欄のままにします。
Calculation type: 料金の計算方法。
Free shipping from: 配送が無料になるカートの小計（割引適用後、税抜き）。送料無料にしない場合は空欄にします。
利用可能条件
Min weight (kg): カートがこれより軽い場合は、この配送方法を非表示にします。0 は制限なし（初期値）を意味します。
Max weight (kg): カートがこれより重い場合は、配送方法を非表示にします。Mondial Relay は Points Relais で最大 30 kg の荷物を受け付けます。初期値：30。0 は制限なしを意味します。空欄は 30 kg を意味します。
Minimum subtotal: カートの小計（配送が必要な商品、割引適用後、税抜き）がこの金額以上の場合にのみ、配送方法を表示します。常に表示する場合は空欄にします。
Geo zone: このジオゾーン内の住所に対してのみ、この配送方法を提供します。All zones（初期値）は全域を意味します。ジオゾーンは System > Localisation > Geo Zones で管理されます。Ignore shipping zones がオンの場合は確認されません。
Ignore shipping zones: オンの場合、Geo zone は確認されません。この配送方法は、以下に記載された国のみで提供されます。一覧が空の場合は、サポートされているすべての国で提供されます。
Countries (ignore zones): このモードの宛先の国。このフィールドは Ignore shipping zones がオンの場合にのみ使用されます。一覧には Points Relais のある国のみが含まれます。
詳細設定
Debug log: 料金計算、Web Service の呼び出し、ポイントの選択を storage/logs/vfd_mrel_debug.log.php（OpenCart 4 では system/storage/logs/vfd_mrel_debug.log.php）に書き込みます。このファイルは Web から読み取ることはできません。このオプションがオフでも、エラーは常に記録されます。キーと顧客データは記録されません。ファイルが 5 MB に達すると、vfd_mrel_debug.old.log.php に移動され、新しいログが開始されます。
Log: デバッグログのサイズと最新のエントリを表示します。Clear log をクリックすると消去されます。
Remove data on uninstall: オンの場合、拡張機能をアンインストールすると、設定とログが削除されます。オフ（初期値）の場合は、再インストール用に保持されます。キャッシュされたポイント一覧は常に削除されます。注文に保存された受け取りポイントは保持されます。
インポート / エクスポート
Export: Download JSON をクリックすると、プライベートキーを除いて設定が JSON ファイルとして保存されます。
Import: 以前にエクスポートした JSON を貼り付け、Import をクリックすると、設定が復元されます（例: 別のストアで）。Save と同じチェックが適用されます。保存済みのプライベートキーは保持されます。
チェックアウトでの動作
この配送方法は、Points Relais のある国、つまりフランス、ベルギー、ルクセンブルク、スペイン、ポルトガル、オランダに対してのみ提供されます。購入者がポイントを選択できない場合は非表示になります：ブランドコードがない場合、またはリストモードでプライベートキーがない場合です。Geo zone が設定されていて、住所がその外にある場合は、この配送方法は提供されません。Ignore shipping zones がオンの場合、ジオゾーンは確認されず、そのリストの国のみが対象になります（リストが空の場合は、サポートされているすべての国）。
OpenCart が配送方法を表示するとき、拡張機能に料金を問い合わせます。Requires Shipping が Yes に設定された商品のみが対象です。それ以外の商品は重量を加えず、小計にも含まれません。商品の重量は、OpenCart の重量クラスから kg に変換されます。小計は、配送が必要な商品の価格で、クーポン割引適用後、税抜きです。拡張機能はカートの重量と最低小計を確認します。料金は国の行（または * の行）から取得されます：重量列、なければ Price。行がない場合はフォールバック料金が使用されます。料金がない場合、配送方法は非表示になります。小計が Free shipping from に達した場合、料金は 0 になります。料金はストアの初期設定通貨で計算され、小数点以下の桁数に丸められ、選択された Tax status の税金を加えた上で、顧客の通貨で表示されます。料金の計算のために Mondial Relay へのリクエストは送信されません。
OpenCart 4 では、購入者はチェックアウトページの配送方法ブロックで Choose をクリックし、Shipping method options のウィンドウで Mondial Relay を選択します。料金は OpenCart 3 と同じです。
この拡張機能はリアルタイム料金を取得しません。Mondial Relay には公開された料金 API がないためです。配送の作成、ラベルの印刷、荷物の追跡は行いません。配送は、注文に表示された Point Relais 番号を使用して、Mondial Relay の「Connect」スペースで作成してください。宅配（Domicile）は提供しません。
受け取りポイント
購入者が配送方法の段階で Mondial Relay のオプションを選択すると、その下に Mondial Relay pickup point のボックスが表示されます。
マップモード: Choose a Point Relais ボタンをクリックすると、配送先の国、郵便番号、荷物の重量に合わせて、公式の Mondial Relay マップがウィンドウで開きます。購入者がポイントを選択すると、Selected: として表示され、ボタンは Change Point Relais に変わります。マップウィジェットは、購入者がマップを開いたときにのみ widget.mondialrelay.com から、マップライブラリは unpkg.com から読み込まれます。プライバシーポリシーに記載してください。
リストモード: ドロップダウン - Choose a Point Relais - には、配送先の郵便番号に最も近い 10 件のポイントが距離とともに表示されます。選択されたポイントは営業時間とともに表示されます。一覧はストアのサーバーが読み込むため、ブラウザでサードパーティのスクリプトは実行されません。一覧は 12 時間、空の応答は 1 時間キャッシュされ、失敗したリクエストは 5 分間記憶されます。Web Service のタイムアウトは 10 秒です。郵便番号がない場合、購入者には Enter your postcode to see the nearest pickup points. が表示されます。ポイントが見つからない場合や一覧が利用できない場合、購入者には「受け取りポイントの一覧は現在利用できません。マップをご利用ください。」のようなメッセージが表示され、マップが提供されます。
選択されたポイントは、購入者のセッションに直ちに保存されます。ポイントは必須です。購入者が Continue をクリックすると、ストアはポイントを再度確認します。ポイントがない場合、購入者には Please choose a Mondial Relay pickup point. が表示され、支払いに進めません。配送先住所とは別の国のポイントは、そのポイントが配送先の国にないという内容のメッセージとともに拒否されます。リストモードでは、ポイントは住所のリストとも照合されます。注文が完了すると選択内容は消去されるため、次のカートでは改めて選択します。
OpenCart 4 では、Mondial Relay pickup point のボックスが Shipping method options のウィンドウに、Mondial Relay のオプションの下に表示され、マップはそのウィンドウ内で開きます。Escape キーではマップのみが閉じます。ウィンドウの Continue ボタンは、有効なポイントがないと先に進めず、同じメッセージが表示されます。
注文が完了すると、ポイントは注文に紐付けられたままになります。注文の配送方法には、方法の名前に続けてポイントの名称、住所、番号が表示されます。例: Mondial Relay Point Relais: TABAC DU LOUVRE, 12 RUE DE RIVOLI, 75001 PARIS (FR-066974)。これにより、購入者は注文メールとアカウントの注文履歴でこれを確認できます。ストア向けの新規注文メールには、コメントブロックにポイントとその番号が表示されます。Sales > Orders では、注文ページに、ポイントの名称、住所、Point Relais 番号を含む Mondial Relay pickup point パネルが表示されるか、No Point Relais was saved for this order. と表示されます。 OpenCart 4 では、パネルは History の上に表示されます。OpenCart 4 は、チェックアウトごとに注文を 1 つ保持し、購入者が再度確定するたびにその注文を更新します。注文のポイントも一緒に更新されます。購入者がその注文を別の配送方法に切り替えると、そのポイントは削除されます。
ライセンスキー
この拡張機能は、vibefox.net の VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Mondial Relay は、Extensions > Extensions > Shipping > VibeFox Mondial Relay > Edit ページで設定の上にある最初のブロックです。License key にキーを入力し、Activate をクリックしてください。その後、ブロックにはキーがマスク表示され、ステータス（例: ライセンスの有効期限日とお使いのドメイン）と、ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key のボタンが表示されます。その下には Product: opencart-shipping-mondialrelay の行と、vibefox.net アカウントを開く Manage licenses and domains in your account のリンクがあります。キーを変更できるのは、この拡張機能の変更権限を持つ管理者ユーザーのみです。ブロックの表示テキストは管理画面の言語に従います（英語とロシア語が含まれます）。
キーが受け付けられない場合、ブロックに理由が表示されます。例: Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認された状態で動作を続けます。
1 つのキーは 1 つのドメインで使用できます：OpenCart の設定にあるストアのアドレスです。ストアからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net アカウントで解放してください。
有効なキーがない場合、Mondial Relay はチェックアウトで購入者に表示されず、料金も計算されません。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアでこの配送方法が (unlicensed — visible to admins only) と表示された状態で引き続き見えるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 ではこのプレビューは利用できません。ストアは管理画面のログインを認識しないため、有効なキーがない場合は全員にこの方法が非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると 7 日間非表示になります。既存の注文は影響を受けません。
ライセンスの期限が切れても、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。管理画面の Dashboard または Edit ページを開くと、ステータスが自動的に再確認されます。キーの入力後最初の 14 日間は 1 日に 1 回、その後は 1 週間に 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスのステータスは常に削除されます。
トラブルシューティング
Mondial Relay がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであることを確認してください。Geo zone を確認するか、Ignore shipping zones をオンにして、その国のリストを確認してください。拡張機能のページ上部の警告を確認してください。ブランドコードがない、リストモードでプライベートキーがない、料金のない国、重量と小計の制限外、Points Relais のない国の場合、この方式は非表示になります。商品の Requires Shipping が Yes に設定されていることを確認してください。
保存後に Web Service のテストが失敗する: メッセージには Mondial Relay のエラーが表示されます。例: ブランドコードが無効、またはセキュリティキーが無効。Mondial Relay でブランドコードとプライベートキーを確認してください。
ポイントの一覧が空、または利用できない: 購入者はまず配送先の郵便番号を入力する必要があります。Web Service が失敗した場合は、代わりにマップが表示されます。Debug log をオンにし、チェックアウトを再読み込みして、拡張機能のページの Log フィールドで理由を確認してください。
マップが開かない: マップは widget.mondialrelay.com と unpkg.com から読み込まれます。プライバシーまたはスクリプトのブロッカー、またはストアのコンテンツセキュリティポリシー（Content Security Policy）によってブロックされていないか確認してください。マップを読み込めない場合、購入者には「Mondial Relay のマップを読み込めませんでした。後でもう一度お試しいただくか、別の配送方法をお選びください。」と表示されます。
注文ページに No Point Relais was saved for this order と表示される: この注文は、配送先の国のポイントなしで行われました。理由はログに記録されています。配送を作成する前に、購入者に Point Relais を確認してください。
ページに "Warning: You do not have permission to modify VibeFox Mondial Relay!" と表示される: 管理者のユーザーグループは、設定を表示のみできる可能性があります。System > Users > User Groups で、そのグループに extension/shipping/vfd_mondialrelay（OpenCart 3）または extension/vfd_mondialrelay/shipping/vfd_mondialrelay（OpenCart 4）の変更権限を付与してください。
アンインストール
Extensions > Extensions に移動し、種類 Shipping を選んで、VibeFox Mondial Relay の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は常に Enable/Disable、Sort order、Tax status、Geo zone をリセットします。キャッシュされたポイント一覧は常に削除されます。Remove data on uninstall がオンの場合、その他の設定とデバッグログも削除されます。オフの場合は保持され、拡張機能を再インストールしたときに再び使用されます。注文に保存された受け取りポイントは常に保持され、既存の注文は配送方法と料金を保持します。
OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox Mondial Relay の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、アップロードしたパッケージを削除するために Delete（赤いゴミ箱ボタン）をクリックしてください。
Mondial Relay は、その所有者の商標です。この拡張機能は Mondial Relay と提携しておらず、Mondial Relay による推奨も受けていません。