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. 在后台进入 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)，都会被拒绝，且不会保存任何内容。如果商店的重量单位不是模块支持的单位，会显示警告，说明商品重量按千克计算。
常规
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。它不创建运单、不打印面单，也不追踪包裹。请在您的 Mondial Relay “Connect” 空间中，使用订单中显示的 Point Relais 编号创建运单。不提供上门配送（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. 且无法继续付款。不在配送地址所在国家的取件点会被拒绝。在列表模式下，取件点还会与该地址的列表进行核对。
下单后，取件点会保留在订单中。后台订单页面会显示 Mondial Relay pickup point 区块，包含取件点名称、地址和 Point Relais number（例如 FR-066974）。顾客可以在订单确认页面以及其账户的订单详情中看到该取件点。在订单确认邮件以及邮件提醒模块的新订单邮件中，取件点会添加在承运商名称之后。
许可证密钥
模块使用来自 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。如果无法连接许可证服务器，模块将继续按最后已知的状态运行。
一个密钥只能用于一个域名：主店铺的域名，即使在多店铺设置中也是如此。从店铺中移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，Mondial Relay 承运商不会在结账时向顾客显示，也不会计算任何运费。PrestaShop 前台无法得知您已登录后台，因此该承运商对您也会隐藏：您可以在购买密钥前设置模块，但无法在结账时测试。Modules > Module Manager 中的 Alerts 选项卡会显示提醒。现有订单不受影响。
许可证到期后，模块仍会继续工作，但更新和支持需要续费。您在后台工作时，系统会自动重新检查状态：输入密钥后的前 14 天每天一次，之后每周一次。无需 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 的认可。