VibeFox Mondial Relay for PrestaShop — ヘルプ
要件
PrestaShop：8.0 ～ 9.x。チェックアウトは Classic と Hummingbird テーマで動作します。
PHP：8.0 以降。モジュールは古い PHP バージョンではインストールできません。
Mondial Relay アカウント：ブランドコード（Enseigne）と Private Key は、Mondial Relay のビジネスアカウントに付属します。mondialrelay.fr のプロフェッショナル向けセクション、「Connect」のお客様エリア、または営業担当者をご確認ください。マップセレクターにはブランドコードだけが必要です。最寄りの拠点の一覧には両方が必要です。テスト用に Mondial Relay は、ブランドコード BDTEST13 と Private Key PrivateK を提供しています。
VibeFox ライセンスキー：vibefox.net で購入します。1つのキーは1つのドメインで使用できます。
インストール
1. 管理画面で Modules > Module Manager に移動し、Upload a module をクリックします。モジュールの ZIP ファイルを選択します。
2. アップロードが完了したら、Configure をクリックします。後で VibeFox Mondial Relay をモジュール一覧から探し、Configure をクリックすることもできます。
3. Configure ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを入力し、Activate をクリックします（「ライセンスキー」を参照）。
4. ブランドコード（Enseigne）を入力し、リストモードの場合は Private Key を入力します。Country prices を入力し、Save をクリックします。
インストール時に、モジュールは配送業者 Mondial Relay Point Relais を作成します。配送時間のテキストは Delivery to a Mondial Relay Point Relais of your choice です。この配送業者は、すべての顧客グループと、フランス、ベルギー、ルクセンブルク、スペイン、ポルトガル、オランダの配送ゾーンに割り当てられます。ゾーン、顧客グループ、配送時間、ロゴ、サイズ制限は Shipping > Carriers で変更できます。そこで価格を設定しないでください。価格は常にモジュールから取得されます。
設定
すべての設定はモジュールのページにあります：Modules > Module Manager > VibeFox Mondial Relay > Configure。各セクションには個別の Save ボタンがあり、ページ全体が保存されます。保存するたびに、キャッシュされた拠点リストも消去されます。
ページ上部の警告には、配送業者を非表示にする問題が表示されます。ブランドコードがない、リストモードで Private Key がない、フランス、ベルギー、スペインの料金がない、配送業者が削除されている、などです。保存できない値は Save の後に報告されます。数値フィールドに数値ではない値（または負の値）を入力すると、以前の値が保持されます。64 文字を超える名前、または Min weight (kg) が Max weight (kg) より大きい場合は拒否され、何も保存されません。ショップの重量単位がモジュールの対応単位でない場合、商品の重量は kg として扱われるという警告が表示されます。
一般
Enable/Disable:Mondial Relay を有効または無効にします。これは Shipping > Carriers の配送業者のステータスと同じスイッチです。
Name:チェックアウト時に購入者に表示される配送業者名。デフォルト：Mondial Relay Point Relais。必須、64 文字まで。
Tax status:None は、表の料金が最終価格であることを意味します。税ルール名を持つ Taxable オプションは、そのルールの配送税を PrestaShop が料金に加算することを意味します。
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 をクリックします。ブランドコードと Private Key が設定されている場合、設定を保存するたびに Mondial Relay Web Service への接続がテストされ、有効かどうかのメッセージが表示されます。
拠点セレクター
Selector:購入者が Point Relais を選択する方法。
料金（ショップのデフォルト通貨、税抜き）
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 を意味します。Min weight (kg) より小さくすることはできません。
Minimum subtotal:カートの小計（配送が必要な商品、割引後、税抜き）がこの金額以上の場合にのみ配送業者を表示します。空欄の場合は常に表示します。
Ignore shipping zones:下記の国に配送業者を提供します。リストが空の場合は、配送業者のゾーンに含まれていなくても、サポートされているすべての国に提供します。有効な間、配送業者は後から作成するゾーンも含め、有効なすべてのゾーンに紐付けられます。無効にすると、配送業者は以前のゾーンに戻ります。
Countries (ignore zones):このモードの仕向け国。このフィールドは Ignore shipping zones が有効な場合にのみ使用されます。リストには Points Relais がある国のみが含まれます。
詳細設定
Debug log:料金計算と Web Service の呼び出しを、モジュールフォルダ内の logs/vfd_mrel_debug.log.php に書き込みます。このファイルはウェブから開けません。このオプションがオフでも、エラーは常に記録されます。キーや購入者データは記録されません。
Log:ログのサイズと最新のエントリを表示します。Clear log をクリックすると空になります。
Remove data on uninstall:オンの場合、モジュールをアンインストールすると設定と配送業者が削除されます。オフの場合、アンインストールは配送業者をオフにするだけです。注文に保存された拠点は保持されます。
チェックアウトでの動作
配送業者は、Points Relais がある国、つまりフランス、ベルギー、ルクセンブルク、スペイン、ポルトガル、オランダでのみ提供されます。購入者が拠点を選択できない場合は非表示になります。ブランドコードがない場合、またはリストモードで Private Key がない場合です。
配送ステップで、PrestaShop はモジュールに料金を問い合わせます。物理的な商品のみが対象です。仮想商品は重量を加算せず、小計にも含まれません。モジュールはカートの重量と最低小計を確認します。料金は、その国の行（または * の行）から取得されます：重量列、なければ Price。行がない場合は代替送料が使用されます。料金がない場合、配送業者は非表示になります。小計が Free shipping from に達すると、料金は 0 になります。料金はショップのデフォルト通貨で計算され、その後、購入者のカート通貨で表示されます。
注文が入った後で Shipping > Carriers で配送業者を編集すると、PrestaShop は新しいバージョンの配送業者として保存します。モジュールは新しいバージョンに自動的に従います。
モジュールはリアルタイムの料金を取得しません。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. と表示されます。拠点が見つからない場合やリストが利用できない場合、「現在、受け取り拠点の一覧をご利用いただけません。マップをご利用ください。」のようなメッセージが表示され、マップが提示されます。
選択した拠点はすぐにカートに保存されます。拠点は必須です。拠点がない場合、購入者には Please choose a Mondial Relay pickup point. と表示され、支払いに進めません。配送先住所と異なる国の拠点は拒否されます。リストモードでは、拠点は住所のリストとも照合されます。
注文が行われると、拠点は注文に紐付いたままになります。管理画面の注文ページには、拠点名、住所、Point Relais number（例：FR-066974）を含む Mondial Relay pickup point ブロックが表示されます。購入者は注文確認ページと、アカウントの注文詳細で拠点を確認できます。注文確認メールと、メールアラートモジュールの新規注文メールでは、配送業者名の後に拠点が追加されます。
ライセンスキー
モジュールは vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox Mondial Relay は、Modules > Module Manager > VibeFox Mondial Relay > Configure ページで設定の上に表示される最初のブロックです。キーを License key に貼り付け、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（ライセンスの有効期限日やドメインなど）、そして次のボタンが表示されます。Check now（ステータスを再確認）、Change key（別のキーを入力）、Remove key（このショップからキーを削除）。その下には、Product: presta-shipping-mondialrelay の行と、Manage licenses and domains in your account のリンクがあり、vibefox.net のアカウントが開きます。キーを変更できるのは、モジュールの Configure 権限を持つスタッフだけです。ブロックの文言は、バックオフィスの言語に従います（英語とロシア語が含まれます）。
キーが受け付けられない場合、ブロックに理由が表示されます（例：Key not found、This key belongs to another product、Domain limit reached、または License expired on と日付）。ショップのアドレスを変更した後、またはアカウントでドメイン枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、モジュールは最後に確認できたステータスで動作を続けます。
1つのキーは1つのドメインで使用できます。これはマルチストア構成でもメインショップのドメインです。ショップからキーを削除しても、ドメイン枠は解放されません。vibefox.net アカウントで枠を解放してください。
有効なキーがない場合、Mondial Relay 配送業者はチェックアウトで購入者に表示されず、料金も計算されません。PrestaShop のストアフロントは、バックオフィスにログインしていることを認識しないため、配送業者は管理者にも非表示になります：キーを購入する前にモジュールを設定することはできますが、チェックアウトでテストすることはできません。Modules > Module Manager の Alerts タブにリマインダーが表示されます。既存の注文には影響しません。
ライセンスの有効期限が切れた場合も、モジュールは動作を続けますが、アップデートとサポートには更新が必要です。バックオフィスで作業している間、ステータスは自動的に再確認されます。キー入力後最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは必要ありません。モジュールのアンインストールまたはリセットを行うと、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
Mondial Relay がチェックアウトに表示されない：ライセンスが有効で、Enable/Disable がオンになっているか確認してください。Shipping > Carriers で、配送業者が購入者の国のゾーンと顧客グループを対象にしているか確認するか、Ignore shipping zones をオンにしてください。モジュールページ上部の警告を確認してください。配送業者は、ブランドコードがない場合、リストモードで Private Key がない場合、料金がない国の場合、重量と小計の制限を超えた場合、Points Relais のない国の場合に非表示になります。商品ページで、特定の配送業者のみに制限されている場合もあります。
保存後の Web Service テストに失敗した：メッセージに Mondial Relay のエラーが表示されます。たとえば、ブランドコードや安全キーが無効な場合です。Mondial Relay でブランドコードと Private Key を確認してください。
拠点のリストが空、または利用できない：購入者はまず配送先の郵便番号を入力する必要があります。Web Service が失敗した場合は、代わりにマップが提示されます。Debug log をオンにし、チェックアウトを再読み込みして、モジュールページの Log フィールドで理由を確認してください。
マップが開かない：マップは widget.mondialrelay.com と unpkg.com から読み込まれます。プライバシーまたはスクリプトのブロッカーによってブロックされていないか確認してください。マップを読み込めない場合、購入者には「Mondial Relay のマップを読み込めませんでした。後でもう一度お試しいただくか、別の配送方法をお選びください。」と表示されます。
注文ページに No Point Relais was saved for this order と表示される：配送先の国の拠点なしで注文が行われました。理由はログに書き込まれています。配送を作成する前に、購入者に Point Relais を確認してください。
ページに Mondial Relay 配送業者が見つからないと表示される：Shipping > Carriers で配送業者が削除されています。Modules > Module Manager でモジュールをリセットすると、再作成されます。
アンインストール
Modules > Module Manager に移動し、VibeFox Mondial Relay の横のメニューを開いて Uninstall を選びます。ライセンスキーとライセンスステータスは常に削除されます。キャッシュされた拠点リストは常に削除されます。Remove data on uninstall がオンの場合、配送業者は削除されます（注文の履歴は残ります）。また、設定、ログ、注文のないカートの拠点も削除されます。オフの場合、配送業者はオフになるだけで、すべての設定は保持されます。モジュールを再インストールすると、配送業者の以前のステータスが復元されます。注文に保存された拠点は常に保持されます。
Mondial Relay は、各所有者の商標です。本モジュールは Mondial Relay と提携しておらず、Mondial Relay による推奨も受けていません。