VibeFox GLS ParcelShop for PrestaShop — 帮助
系统要求
PrestaShop：8.0 至 9.x。ParcelShop 选择功能适用于 Classic 和 Hummingbird 主题。
PHP：8.0 或更高版本。模块拒绝在更早的 PHP 版本上安装。
GLS：模块不使用、也不需要 GLS 账户或 API 密钥。ParcelShop 地图是公开的。要将包裹发送到所选的 ParcelShop，您需要与 GLS 签订合同。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥对应一个域名。
安装
1. 在后台进入 Modules > Module Manager，点击 Upload a module。选择模块的 ZIP 文件。
2. 上传完成后，点击 Configure；或者之后在模块列表中找到 VibeFox GLS ParcelShop，然后点击 Configure。
3. 在 Configure 页面顶部的许可证区块中，将您的 VibeFox 许可证密钥粘贴到 License key 中，然后点击 Activate（参见“许可证密钥”）。
4. 设置价格：至少添加一行 Country prices（例如 * Default），或设置 Fallback cost（参见“配置”），然后点击 Save。
安装时，模块会创建 GLS ParcelShop 承运商，其配送时效文本为 Delivery to a GLS ParcelShop of your choice。该承运商会分配给所有顾客群组以及 GLS 地图国家的区域（标准商店中通常为 Europe 和 Europe (non-EU)）。您可以在 Shipping > Carriers 中更改区域、顾客群组、配送时效文本和徽标。请不要在那里设置价格：价格始终来自模块。
配置
所有设置都位于模块页面：Modules > Module Manager > VibeFox GLS ParcelShop > Configure。每个部分都有自己的 Save 按钮，点击后会保存整个页面。
页面顶部的警告会指出配置问题：找不到承运商，模块无法识别商店的重量单位（请在 International > Localization 的 Local units 中设置 kg、g、lb 或 oz），未设置任何价格，或所选的 Countries (ignore zones mode) 中有部分或全部国家不在 GLS 地图覆盖范围内。无效或负数会被拒绝，并显示指出该字段的消息，同时保留其之前的值。其他字段仍会保存。
General
该部分列出 GLS 地图覆盖的国家。对于其他目的地国家，不提供该承运商。
Enable/Disable：开启或关闭 GLS ParcelShop。这与 Shipping > Carriers 中的承运商状态使用的是同一个开关。
Name：顾客看到的配送方式名称（即承运商名称）。默认：GLS ParcelShop。必填，最多 64 个字符。
Tax status：承运商的税务规则。None 表示运费不征税。选择一个税务规则即可对运费征税。
Prices
价格以商店的默认货币输入，不含税。小数可以使用逗号或小数点（4,99 或 4.99）。价格以购物车的货币显示给顾客。
Calculation type：价格的应用方式。
Country prices：一个表格，每个目的地国家占一行。点击 Add country 添加一行，点击垃圾桶图标删除一行。每行包含一个 Country、一个 Price，以及五个重量列：XS 为 1 kg 以内，S 为 1-2 kg，M 为 2-3 kg，L 为 3-5 kg，XL 为 5 kg 以上。使用与购物车重量对应的列。保持为 0 的重量列将使用 Price 列。没有单独行的国家使用 * Default 行。新行以 * Default 开始，每列均为 0；所有价格均为 0 的行会提供免费配送，因此请先选择国家并填写价格，再保存。如果表格中有某个值不是有效数字，则整个表格不会保存，消息会列出错误的值。
Fallback cost：当表格中没有目的地国家的行，并且没有 * Default 行时使用的价格。将其留空即可对这些国家隐藏该承运商。
Free shipping from：购物车小计（折扣后，不含税）达到此金额时，GLS ParcelShop 配送免费。如果从不免费配送，请留空。
Availability
Minimum weight (kg)：购物车重量低于此值时隐藏该承运商。重量按商店的重量单位换算。留空或为 0 表示无限制。
Maximum weight (kg)：购物车重量高于此值时隐藏该承运商。默认：20。GLS ParcelShop 通常接受最高 20 kg 的包裹，因此请核对您的 GLS 合同。留空或为 0 表示无限制。如果最低重量大于最高重量，两个值都会被拒绝并显示消息，同时保留之前的值。
Minimum cart subtotal：仅当购物车小计（折扣后，不含税）达到此金额时才提供该承运商。没有最低限额时请留空。
Ignore shipping zones：开启后，该承运商会关联所有区域（包括已禁用的区域），并针对下方所选国家提供，即使这些国家不在其区域中。之后创建的区域也会关联。关闭后，该承运商会恢复之前拥有的区域，并且只在这些区域中提供。默认：关闭。
Countries (ignore zones mode)：该模式下的目的地国家。留空则使用所有 GLS 地图国家。不在 GLS 地图覆盖范围内的国家会被跳过。仅当 Ignore shipping zones 开启时才使用此字段。
Advanced
Debug log：将运费计算和 ParcelShop 选择写入模块文件夹中的 logs/vfd_glps_debug.log.php。该文件无法通过网页打开。错误始终会被记录。日志中不记录顾客的个人数据。完成后请关闭日志。
Log：显示调试日志的大小和最新条目。点击 Clear log 可清空日志。
Remove data on uninstall：开启后，卸载模块会删除设置、承运商和日志。关闭后，所有内容都会保留，以便重新安装。订单中保存的 ParcelShop 始终会保留。
结账时的工作方式
当 PrestaShop 显示配送步骤时，它会向模块请求 GLS ParcelShop 的价格。只有实体商品才计算在内：虚拟商品不增加重量，也不计入购物车小计。模块首先检查条件：配送国家是否在 GLS 地图覆盖范围内（启用该模式时，还需在 Countries (ignore zones mode) 中被选中）、购物车重量以及最低购物车小计。如果购物车小计达到 Free shipping from，则免费配送。否则，价格取自该国家的行（或 * Default 行）中对应的重量列，或取自 Fallback cost。如果找不到价格，则隐藏该承运商。
当顾客选择 GLS ParcelShop 时，承运商下方会出现一个 GLS ParcelShop 框，其中有 Select GLS ParcelShop 按钮。点击后会打开配送国家对应的官方 GLS ParcelShop 地图。选择 ParcelShop 后，会显示其名称和地址，按钮变为 Change ParcelShop。所选结果保存在购物车中，因此配送步骤刷新或页面重新加载后仍会保留。如果收货地址更改为其他国家，顾客必须重新选择 ParcelShop。
当顾客在配送步骤中点击 Continue 时，模块会检查是否已选择 ParcelShop，以及该 ParcelShop 是否位于配送国家。否则，顾客会看到 Please select a GLS ParcelShop. 或 The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again.，并留在配送步骤。如果无法保存 ParcelShop，顾客会看到 The ParcelShop could not be saved. Please try again. 如果 GLS 地图脚本无法加载，顾客会看到提示，要求重新加载页面或选择其他配送方式。
GLS 地图在顾客的浏览器中运行。在结账页面，模块从 map.gls-croatia.com 加载地图脚本，地图则从 GLS 加载 ParcelShop 数据和地图图块。GLS 会收到访客的常规请求数据（IP 地址、浏览器）。您的服务器不会向 GLS 发送任何数据。
如果订单已存在后，您在 Shipping > Carriers 中编辑了该承运商，PrestaShop 会将其保存为新的承运商版本。模块会自动跟随新版本。
模块不会获取 GLS 的实时运费，不会创建 GLS 货件、打印面单或追踪包裹。它在您的服务器上没有 ParcelShop 列表，因此无法向 GLS 验证 ParcelShop ID。请以您平常的方式，将订单中的 ParcelShop ID 提供给 GLS（通过 MyGLS、您的 GLS 软件或其他模块）。
自提点
下单时，购物车中的 ParcelShop 会随订单一起保存：其 ID、名称及地址，以及所在国家。此后它不会随购物车而改变。
后台订单页面：一个 GLS ParcelShop 区块会显示 ParcelShop 的名称和地址，以及 ParcelShop ID 和国家。如果某个 GLS ParcelShop 订单没有 ParcelShop，该区块会显示 No ParcelShop was selected for this order.
顾客页面：ParcelShop 会显示在订单确认页面，以及顾客账户中的订单详情页面。
邮件：在发给顾客的订单确认邮件中，ParcelShop 会被添加到承运商名称中。发给商家的新订单邮件（Mail alerts 模块）也会包含 ParcelShop ID。
许可证密钥
本模块需要使用来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块 License — VibeFox GLS ParcelShop 是 Modules > Module Manager > VibeFox GLS ParcelShop > Configure 页面中位于设置上方的第一个区块。将密钥粘贴到 License key 中，然后点击 Activate。之后，该区块会以掩码形式显示密钥、状态（例如许可证有效期截止日期和您的域名），以及以下按钮：Check now（重新检查状态）、Change key（输入其他密钥）和 Remove key（从本店铺中移除密钥）。其下方是一行 Product: presta-shipping-gls-parcelshop 以及链接 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 账户中释放该名额。
没有有效的密钥时，GLS ParcelShop 承运商不会在结账时向顾客显示，也不会计算任何运费。PrestaShop 前台无法得知您已登录后台，因此该承运商对您也会被隐藏：您可以在购买密钥前设置模块，但无法在结账时测试。Modules > Module Manager 的 Alerts 选项卡中会出现提醒。现有订单不受影响。
许可证到期后，模块仍会继续运行，但更新和支持需要续费。在您使用后台期间，状态会自动重新检查：输入密钥后的前 14 天每天一次，之后每周一次。无需 cron 任务。卸载或重置模块时，始终会删除许可证密钥和许可证状态。
故障排除
结账时没有显示 GLS ParcelShop：请检查许可证是否有效，并且 Enable/Disable 已开启。在 Shipping > Carriers 中，检查该承运商是否覆盖顾客所在国家的区域和顾客群组（或开启 Ignore shipping zones 并检查 Countries (ignore zones mode)）。检查目的地国家是否属于 GLS 地图国家，并且有价格（国家行、* Default 行或 Fallback cost）。检查重量限制和 Minimum cart subtotal。商品也可能在商品页面中被限制为特定承运商。开启 Debug log，并查看 Log 字段以了解原因。
地图无法打开：当 GLS 脚本被广告或隐私拦截器、内容安全策略（CSP）阻止，或 GLS 服务中断时，顾客会看到“The GLS ParcelShop map could not be loaded...”。请在您的内容安全策略中允许 map.gls-croatia.com。
某个国家的配送误显示为免费：请检查 Country prices 中该国家的行。如果 Price 和所有重量列都为 0，则该行会提供免费配送。
表格或某个字段未保存：某个值不是有效数字。页面顶部的消息会指出该值。请使用数字，并以逗号或小数点作为小数分隔符。
页面提示找不到 GLS ParcelShop 承运商：该承运商已在 Shipping > Carriers 中被删除。请在 Modules > Module Manager 中重置模块以重新创建。重置会保留现有承运商的状态：已禁用的承运商仍保持禁用。
某个订单没有 ParcelShop，且日志显示购物车的 ParcelShop 已保存在另一个订单中：一个购物车变成了两个订单。第一个订单保留该 ParcelShop。请手动将第二个订单交给 GLS。
卸载
前往 Modules > Module Manager，打开 VibeFox GLS ParcelShop 旁边的菜单，然后选择 Uninstall。许可证密钥和许可证状态始终会被删除。如果 Remove data on uninstall 已开启，承运商将被删除（订单保留其历史记录），并且设置、日志以及没有订单的购物车中的 ParcelShop 都会被删除。如果已关闭，承运商仅会被禁用，所有设置都会保留。重新安装模块后，已保存的承运商会恢复其之前的状态。订单中保存的 ParcelShop 始终会保留。
GLS 是其各自所有者的商标。本模块与 GLS 无关联，也未获得 GLS 的认可。