VibeFox Mondial Relay for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。没有它，插件无法启用。
PHP：8.0 或更高版本。
Mondial Relay 账户：品牌代码（Enseigne）和 Private Key 随 Mondial Relay 企业账户提供：请查看 mondialrelay.fr 的专业人士页面、您的「Connect」客户专区或您的销售联系人。地图选择器只需要品牌代码。最近网点列表需要两者。用于测试时，Mondial Relay 提供品牌代码 BDTEST13 及 Private Key PrivateK。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥仅适用于一个域名。
安装
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。
配置
所有设置都在同一页面：WooCommerce > Settings > Shipping > VibeFox Mondial Relay。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口只有一个字段：
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：仅最近网点列表选择器需要。设置品牌代码和 Private Key 后，每次保存设置时都会测试与 Mondial Relay Web Service 的连接，并显示它们是否有效的消息。
取件点选择器
Selector：顾客如何选择 Point Relais。
运费（以您店铺的货币计）
Country prices：按目的地国家和包裹重量设置的价格。点击 + Add country 添加一行，点击叉号删除一行。对于所有其他国家，请使用 * Default 行。每行包含一个 Price 以及重量列：XS 1 公斤以下，S 1-2 公斤，M 2-3 公斤，L 3-5 公斤，XL 5 公斤以上。重量列为空或为 0 时使用 Price 列。小数点可用点或逗号（4.90 或 4,90）。保存时会删除没有任何价格的行；非数字的值会被提示并留空。
Fallback cost：用于表格中没有对应行的国家。留空则对这些国家隐藏该配送方式。
Calculation type：价格的计算方式。
Free shipping from：购物车小计（扣除折扣后，不含税）达到此金额即免运费。留空则不提供免运费。
可用性
Min weight (kg)：购物车重量低于此值时隐藏该配送方式。0 表示不限制。
Max weight (kg)：购物车重量高于此值时隐藏该配送方式。Mondial Relay 在 Points Relais 接受最重 30 公斤的包裹。默认：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 高性能订单存储（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 账户。
一个密钥仅适用于一个域名。从站点移除密钥不会释放其域名名额。请在您的 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 的错误，例如品牌代码或安全密钥无效。请与 Mondial Relay 核对品牌代码和 Private Key。
网点列表为空或不可用：顾客需要先输入邮编。若 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 修改脚本网址。支持的国家列表可通过过滤器 vfd_mrel_supported_countries 修改。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活该密钥。如果无法连接许可证服务器，插件将沿用最后已知的状态继续工作。
卸载
停用插件会保留所有设置。仅清除缓存的取件点列表。要删除插件，请先停用，然后在 Plugins 页面中删除。本插件的许可证密钥、许可证状态和缓存始终会被删除。只有在开启 Remove data on uninstall 的情况下，设置和区域配送方式才会被删除；否则它们会保留，以便日后重新安装。订单中保存的取件点会被保留，现有订单也会保留其配送行。
Mondial Relay 是其各自所有者的商标。本插件与 Mondial Relay 无关联，也未获得 Mondial Relay 的认可。