VibeFox Mondial Relay for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 7.0 以降。インストールされて有効になっている必要があります。WooCommerce がない場合、プラグインは有効化できません。

PHP: 8.0 以降。

Mondial Relay アカウント: ブランドコード（Enseigne）と Private Key は、Mondial Relay のビジネスアカウントに付属します。mondialrelay.fr のプロフェッショナル向けセクション、「Connect」のお客様用エリア、または営業担当者をご確認ください。マップセレクターにはブランドコードだけが必要です。最寄りの拠点の一覧には両方が必要です。テスト用に、Mondial Relay はブランドコード BDTEST13 と Private Key PrivateK を提供しています。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

1. WordPress で Plugins > Add New > Upload Plugin に進み、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で vfd_mondialrelay フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます: WooCommerce > Settings > Shipping > VibeFox Mondial Relay。または、プラグインページのプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

5. ブランドコード（Enseigne）を入力し、リストモードの場合は Private Key も入力します。Country prices を入力します。

6. WooCommerce > Settings > Shipping > Shipping zones で、配送先の国のゾーンに VibeFox Mondial Relay を追加するか、Ignore shipping zones を有効にします。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Shipping > VibeFox Mondial Relay。設定はすべての配送ゾーンに適用されます。配送方法をゾーンに追加するとき、ゾーンのウィンドウには項目が 1 つだけあります:

Title (zone): 購入時に表示されるこのオプションの名前。空欄にすると、全体の Name を使用します。

ページ上部の警告には、配送方法が非表示になる原因が表示されます: ブランドコードの未入力、リストモードでの Private Key の未入力、フランス、ベルギー、スペインの料金未設定。

全般

Enable/Disable: Mondial Relay を全体で有効または無効にします。

Name: 購入時に購入者に表示される配送方法の名前。初期値: Mondial Relay Point Relais。

Tax status: Taxable は配送料に WooCommerce の税を加算し、None は加算しません。

Mondial Relay アカウント

Brand code (Enseigne): 必須。最大 8 文字。テスト用の例: BDTEST13。取り扱い拠点のマップと Web Service で使用されます。これがないと購入者は Point Relais を選択できず、購入時にこの配送方法は表示されません。

Private Key: List of nearest points セレクターにのみ必要です。ブランドコードと 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 列を使用します。小数点はドットまたはカンマ（4.90 または 4,90）。料金が 1 つもない行は保存時に削除され、数値ではない値は報告されて空欄になります。

Fallback cost: 表に行がない国に使用されます。空欄にすると、それらの国では配送方法を非表示にします。

Calculation type: 料金の計算方法。

Free shipping from: 配送料が無料になるカートの小計（割引後、税抜き）。空欄にすると送料無料はありません。

利用条件

Min weight (kg): カートがこれより軽い場合、配送方法を非表示にします。0 は制限なしを意味します。

Max weight (kg): カートがこれより重い場合、配送方法を非表示にします。Mondial Relay は Points Relais で最大 30 kg までの荷物を受け付けます。初期値: 30。0 は制限なしを意味します。

Minimum subtotal: カートの小計がこの金額以上の場合にのみ、配送方法を表示します。空欄にすると常に表示されます。

Disabled shipping classes: カートにこれらの WooCommerce 配送クラスの商品が含まれている場合、配送方法を非表示にします。

Ignore shipping zones: 下記の国に対して配送方法を提供します。リストが空の場合は、配送ゾーンにその国が含まれていなくても、対応するすべての国に提供します。

Countries (ignore zones): このモードの仕向け国。このフィールドは Ignore shipping zones が有効な場合にのみ使用されます。

詳細設定

Debug log: 料金計算と Web Service の呼び出しを WooCommerce > Status > Logs（ソース vfd-mondialrelay）に記録します。このオプションをオフにしても、エラーは常に記録されます。キーや購入者データは記録されません。

Remove data on uninstall: 有効にすると、プラグインを削除したときに設定と配送ゾーンの配送方法が削除されます。無効化では何も削除されません。注文に保存された受け取り拠点は保持されます。

購入時の仕組み

この配送方法は、Points Relais のある国、つまりフランス、ベルギー、ルクセンブルク、スペイン、ポルトガル、オランダに対してのみ提供されます。購入者が拠点を選べない場合は非表示になります: ブランドコードがない場合、またはリストモードで Private Key がない場合です。

購入者が配送先住所を入力すると、WooCommerce はプラグインに料金を問い合わせます。プラグインは、カートの重量、最低小計、除外される配送クラスを確認します。料金は、その国の行（または * 行）から取得されます: 重量の列、なければ Price。行がない場合は代替送料が使われます。料金がない場合は、配送方法が非表示になります。小計が Free shipping from に達すると、料金は 0 になります。

この配送方法は、クラシックチェックアウトと、カートおよびチェックアウトブロックで動作します。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。

プラグインはリアルタイムの料金を取得しません。Mondial Relay には公開された料金 API がないためです。荷物の作成、ラベルの印刷、追跡は行いません。注文に表示される Point Relais の番号を使用して、Mondial Relay の「Connect」スペースで発送を作成してください。自宅配送（Domicile）は提供されません。

受け取り拠点

マップモード: 購入者が Mondial Relay を選択すると、配送方法の下に 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 秒です。リストを利用できない場合、購入者には "The list of pickup points is not available right now. Please use the map." と表示され、マップが提供されます。

拠点は必須です。拠点がない場合、購入者には Please choose a Mondial Relay pickup point. と表示され、注文は確定されません。配送先住所と異なる国の拠点は拒否されます。リストモードでは、拠点はその住所のリストと照合されます。

Point Relais の番号、国、名称、住所は注文に保存されます。注文画面の配送先住所の下（Point Relais の番号を含む）、サンクスページ、My account > Orders、注文メール（HTML とプレーンテキスト）に、Mondial Relay pickup point として表示されます。

ライセンスキー

プラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Shipping > VibeFox Mondial Relay のページ上部にあります。キーを License key に貼り付けて Activate をクリックします。ブロックには、ライセンスの有効期限日や、お使いのドメインなど、ステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから、vibefox.net のアカウントを開けます。

1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、ドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、購入時の購入者には Mondial Relay が表示されません。ログインしたストア管理者には (unlicensed — visible to admins only) と表示された状態で表示されるため、キーを購入する前にプラグインを設定し、テストできます。プラグインページと WooCommerce のページに通知が表示されます。既存の注文には影響しません。

ライセンスの期限が切れても、プラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。

トラブルシューティング

購入時に Mondial Relay が表示されない: ライセンスが有効であること、Enable/Disable が有効であること、配送方法が購入者の国のゾーンに追加されていること（または Ignore shipping zones が有効で、その国が許可されていること）を確認してください。設定ページ上部の警告も確認してください。ブランドコードがない場合、リストモードで Private Key がない場合、料金がない国の場合、重量や小計の制限を超えた場合、Points Relais のない国の場合に、配送方法は非表示になります。

保存後の Web Service テストに失敗した: メッセージには Mondial Relay のエラーが表示されます。例えば、ブランドコードや安全キーが無効な場合です。ブランドコードと Private Key を Mondial Relay で確認してください。

拠点の一覧が空、または利用できない: 購入者は先に郵便番号を入力する必要があります。Web Service に障害が発生した場合は、代わりにマップが表示されます。原因を確認するには、Debug log を有効にし、WooCommerce > Status > Logs を開いて、ソース vfd-mondialrelay を確認してください。

マップが開かない: マップは widget.mondialrelay.com と unpkg.com から読み込まれます。プライバシー保護やスクリプトのブロッカーによってブロックされていないか確認してください。開発者は、フィルター vfd_mrel_widget_script_url、vfd_mrel_leaflet_script_url、vfd_mrel_leaflet_style_url でスクリプトの URL を変更できます。対応国のリストは、フィルター vfd_mrel_supported_countries で変更できます。

ライセンスブロックにエラーが表示される: ブロックのメッセージに従ってください。例えば、そのキーが別のドメインで既に使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックします。サイトのアドレスが変わった場合は、Check now をクリックして、新しいドメインのキーを有効にします。ライセンスサーバーに接続できない場合、プラグインは最後に確認された状態で動作を続けます。

アンインストール

プラグインを無効化しても、すべての設定は保持されます。消去されるのはキャッシュされた受け取り拠点の一覧だけです。削除するには、プラグインを無効化してから Plugins ページで削除してください。このプラグインのライセンスキー、ライセンスステータス、キャッシュは常に削除されます。設定とゾーンの配送方法は、Remove data on uninstall が有効な場合にのみ削除されます。それ以外の場合は、後で再インストールするために残ります。注文に保存された受け取り拠点は保持され、既存の注文は配送の行を保持します。

Mondial Relay は各所有者の商標です。本プラグインは Mondial Relay と提携しておらず、Mondial Relay による推奨もされていません。