VibeFox GLS ParcelShop for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并已启用。未安装时插件无法启用。
PHP：8.0 或更高版本。
GLS：本插件不使用也不需要 GLS 账户或 API 密钥。ParcelShop 地图是公开的。要将包裹配送到所选的 ParcelShop，您需要与 GLS 签订合同。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_gls_parcelshop 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop，或在插件页面上点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 设置名称和价格：至少添加一行 Country prices（例如 * Default），或设置 Fallback cost（参见配置）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中将 VibeFox GLS ParcelShop 添加到一个配送区域，或开启 Ignore shipping zones。
配置
所有设置都在同一页面：WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：顾客在该区域看到的配送方式名称。留空则使用全局的 Name。
设置页面顶部的警告会指出配置问题，例如未设置任何价格，或所选国家均不在 GLS 地图覆盖范围内。无效数字会被拒绝并显示提示信息，同时保留之前的值。
常规
本部分列出了 GLS 地图覆盖的国家。对于其他目的地国家，不会提供该配送方式。
Enable/Disable：同时在所有区域中启用或停用该配送方式。默认：开启。
Name：向顾客显示的配送方式名称。某个区域可以用自己的 Title 覆盖它。默认：GLS ParcelShop。
Tax status：Taxable 会在配送费用上加收 WooCommerce 税费，None 则不加收。默认：Taxable。
价格
价格以店铺货币输入。小数可使用小数点或小数逗号（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 行。新增的行所有列默认为 0，所有价格均为 0 的行表示免运费，因此请在保存前填写价格。
Fallback cost：当价格表中没有目的地国家的行，也没有 * Default 行时使用的价格。留空则对这些国家隐藏该配送方式。
Free shipping from：购物车小计（扣除折扣后，不含税）达到此金额时，GLS ParcelShop 配送免费。如果从不免运费，请留空。
可用性
Minimum weight (kg)：购物车重量低于此值时隐藏该配送方式。重量会从店铺的重量单位换算。留空或为 0 表示无限制。
Maximum weight (kg)：购物车重量高于此值时隐藏该配送方式。默认：20。GLS ParcelShop 通常接受最高 20 kg 的包裹，请对照您的 GLS 合同确认。留空或为 0 表示无限制。
Minimum cart subtotal：仅当购物车小计（扣除折扣后，不含税）达到此金额时才提供该配送方式。如果没有最低限额，请留空。
Excluded shipping classes：购物车中包含某个 WooCommerce 配送类别的商品时，隐藏该配送方式。
Ignore shipping zones：开启后，即使该配送方式未添加到对应的配送区域，也会针对下方所选国家提供。关闭时，仅在已添加该方式的区域中提供。默认：关闭。
Countries (ignore zones mode)：该模式下的目的地国家。留空则使用 GLS 地图的所有国家。不在 GLS 地图覆盖范围内的国家会被跳过。仅当 Ignore shipping zones 开启时才使用此字段。
高级
Debug log：将运费计算过程和 ParcelShop 选择记录到 WooCommerce > Status > Logs（来源 vfd-gls-parcelshop）。不记录任何顾客个人数据。使用完毕后请关闭日志。
Remove data on uninstall：开启后，删除插件时会移除该配送方式的设置和区域实例。停用插件从不删除任何内容。订单中保存的 ParcelShop 始终保留。
结账时的工作方式
顾客输入收货地址后，WooCommerce 会向插件请求运费。插件首先检查条件：收货国家是否在 GLS 地图覆盖范围内、购物车重量、购物车最低小计以及排除的配送类别。如果购物车小计达到 Free shipping from，则免运费。否则，价格取自该国家的行（或 * Default 行）中对应的重量列，或取自 Fallback cost。如果找不到价格，则隐藏该配送方式。
顾客选择 GLS ParcelShop 后，该配送方式下方会出现 Select GLS ParcelShop 按钮。点击后会打开该收货国家的官方 GLS ParcelShop 地图。选定 ParcelShop 后，会显示其名称和地址，按钮变为 Change ParcelShop。该选择会保存在顾客的会话中，因此结账页面刷新或页面重新加载后仍然保留。
下单时，插件会检查是否已选择 ParcelShop，以及它是否位于收货国家。否则，顾客会看到 请选择一个 GLS ParcelShop。 或 所选的 GLS ParcelShop 不在您的收货国家。请重新选择 ParcelShop。，订单也不会被提交。如果无法加载 GLS 地图脚本，顾客会看到提示，请其重新加载页面或选择其他配送方式。
GLS 地图在顾客的浏览器中运行。在结账页面，插件会从 map.gls-croatia.com 加载 GLS 地图脚本，地图则从 GLS 加载 ParcelShop 数据和地图瓦片。GLS 会收到访客的常规请求数据（IP 地址、浏览器）。您的服务器不会向 GLS 发送任何数据。
该配送方式适用于经典结账页面以及购物车和结账区块。它兼容 WooCommerce 高性能订单存储（HPOS）。
插件无法获取 GLS 的实时运费，不会创建 GLS 货件、打印面单或追踪包裹。服务器上没有 ParcelShop 列表，因此无法向 GLS 核实 ParcelShop ID。请按您平时的方式（MyGLS、您的 GLS 软件或其他插件）将订单中的 ParcelShop ID 提供给 GLS。
取货点
所选的 ParcelShop 会随订单一起保存：其 ID、名称和地址，以及所在国家。
后台订单页面：ParcelShop 的名称和地址，以及其 ID 和国家，会显示在收货地址下方。如果某个 GLS ParcelShop 订单没有 ParcelShop，页面会显示 未为此订单选择 ParcelShop。
顾客页面：ParcelShop 会显示在感谢页面以及顾客账户中的订单查看页面上。
邮件：ParcelShop 会添加到订单邮件中，同时包含 HTML 和纯文本版本。发送给店铺管理员的邮件还会包含 ParcelShop ID。
开发者可以从订单元数据 _vfd_glps_parcelshop_id、_vfd_glps_parcelshop_name 和 _vfd_glps_parcelshop_country 中读取 ParcelShop 信息。
许可证密钥
本插件需要使用来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将密钥从本站点移除。Manage licenses and domains in your account 链接可打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效的密钥时，GLS ParcelShop 不会在结账时显示给顾客。已登录的店铺管理员仍可看到它，但会标注 （未授权 — 仅管理员可见），以便您在购买密钥之前设置和测试插件。插件页面和 WooCommerce 页面上会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
结账时不显示 GLS ParcelShop：请检查许可证是否有效、Enable/Disable 是否开启、该配送方式是否已添加到顾客所在国家的区域（或已开启 Ignore shipping zones 且该国家被允许）。请检查目的地国家是否属于 GLS 地图国家，并且是否设置了价格（国家行、* Default 行或 Fallback cost）。请检查重量限制、Minimum cart subtotal 和 Excluded shipping classes。开启 Debug log 后，可在 WooCommerce > Status > Logs 中查看原因。
地图无法打开：当 GLS 脚本被广告或隐私拦截器、内容安全策略阻止，或 GLS 服务中断时，顾客会看到「无法加载 GLS ParcelShop 地图……」。请在您的内容安全策略中允许 map.gls-croatia.com。
某个国家的运费错误地免费：请检查 Country prices 中该国家的行。Price 和所有重量列均为 0 的行会导致免运费。
表格或某个字段未保存：某个值不是有效数字。页面顶部的提示会指出该值。请使用数字，并以逗号或小数点作为小数分隔符。
开发者过滤器：vfd_glps_map_countries 用于更改 GLS 地图的国家列表，vfd_glps_widget_url 用于更改 GLS 地图脚本的 URL。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 以便为新域名激活该密钥。如果无法连接许可证服务器，插件将继续使用最后已知的状态运行。
卸载
停用插件会保留所有数据。要彻底删除，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥和许可证状态始终会被删除，同时还会删除旧缓存以及 1.0 版本的日志文件。只有在开启了 Remove data on uninstall 的情况下，该配送方式的设置和区域实例才会被删除；否则它们会保留，以便日后重新安装时使用。订单中保存的 ParcelShop 始终保留，现有订单也会保留其配送项目。
GLS 是其各自所有者的商标。本插件与 GLS 无关联，也未获得 GLS 的认可。