VibeFox DHL Packstation for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，须已安装并启用。未安装时插件无法激活。
PHP：8.0 或更高版本。
DHL API key：取件点列表来自免费的 DHL Location Finder API。请在 DHL 开发者门户（developer.dhl.com）注册，创建应用，添加“Location Finder - Unified” API，然后复制应用的 API 密钥。使用该 API 无需 DHL 商务合同。没有密钥时，结账页面会隐藏该配送方式。请注意您 DHL 应用的请求上限：每次搜索新的邮编或城市都会消耗一次 API 请求。
VibeFox license key：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_dhl_packstation 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > DHL Packstation，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 粘贴 DHL API 密钥，保存，点击 Test API key，选择取件点类型，并输入各国价格（参见配置）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 DHL Packstation 添加到配送区域（例如德国），或开启 Ignore shipping zones。
配置
所有设置都在同一页面：WooCommerce > Settings > Shipping > DHL Packstation。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：该区域结账时此配送选项的名称。留空则使用全局的 Name。
设置上方的警告会提示 DHL API 密钥为空以及各国价格条目格式不正确。每次保存设置时，取件点缓存都会被清除。
常规
Enable/Disable：在所有区域中同时启用或禁用该方式。
Name：向顾客显示的配送方式名称。默认：DHL Packstation。区域可以用自己的 Title 覆盖它。
Tax status：Taxable 会将 WooCommerce 税费计入运费，None 则不计入。
DHL Location Finder API
DHL API key：您在 developer.dhl.com 上的应用的 API 密钥。没有它时，结账页面会隐藏该方式。
Connection test：Test API key 按钮会使用已保存的密钥搜索 53113 Bonn 附近的取件点，并清除取件点缓存。请先保存设置。它会显示找到的取件点数量，或 DHL 拒绝密钥（401/403）的情况。
取件点
Location types：顾客可以选择的 DHL 取件点：Packstation (parcel locker)、Post Office (Postfiliale) 和 DHL Parcel Shop (Paketshop)。默认全部选中。如果一个都不选，该方式会被隐藏。选择 Packstation 时，顾客必须输入其 DHL Postnummer。
Search radius (meters)：所搜索邮编或城市周围的半径。默认：5000。DHL 最多允许 25000 米。
Max results：每次搜索显示的最多取件点数量。默认：20。DHL 最多允许 50。
Shipping address：将所选取件点用作订单的配送地址。默认开启。例如地址第 1 行变为“Packstation 105”，第 2 行为“Postnummer”加上编号，并附带取件点的邮编和城市，这样从订单打印的面单才能寄到正确的地点。Postnummer 还会保存为 _shipping_dhl_postnum，这是官方插件“DHL Shipping Germany for WooCommerce”读取的字段。
价格
Country prices：目的国的价格，以店铺货币计，格式为 CC:PRICE，用逗号或换行分隔。默认：DE:4.99, AT:5.99。也支持小数逗号（DE:4,99）。
Other countries：未在 Country prices 中列出的目的国价格。默认：5.99。留空则对这些国家隐藏该方式。
Calculation：Per order 只收取一次价格。Per item (price x quantity) 则按购物车中的商品数量相乘。
Free shipping from：购物车小计达到此金额即免运费。留空则永不免运费。
可用性
Min weight (kg)：购物车最小重量。商品重量会从店铺的单位换算。0 表示不限制。
Max weight (kg)：购物车重量超过此值时隐藏该方式。默认：31.5，因为 Packstation 最多接收 31.5 千克的包裹。0 表示不限制。
Minimum subtotal：仅当购物车小计至少达到此值时才显示该方式。留空则始终显示。
Excluded shipping classes：如果购物车中包含属于这些 WooCommerce 配送类别的商品，则隐藏该方式。
Ignore shipping zones：即使对应区域未包含该方式，也为下方列出的国家提供该方式。
Countries (ignore zones)：该模式的目的国。留空则适用于所有国家。仅与 Ignore shipping zones 一起使用。
高级
Debug log：在 WooCommerce > Status > Logs 中记录 API 请求和结账步骤，来源为 vfd-dhl-packstation。即使此选项关闭，API 错误也始终会被记录。API 密钥、Postnummer 和顾客地址绝不会被记录。
Remove data on uninstall：开启后，删除插件会移除其设置和区域配送方式。停用插件不会删除任何内容。所选取件点会保留在订单中。
结账时的工作方式
顾客输入配送地址时，WooCommerce 会向插件请求价格。插件检查购物车重量、最低小计和排除的配送类别，获取目的国的价格（或其他国家的价格），并在小计足够高时应用免运费。
该方式适用于经典结账以及购物车和结账区块。它与 WooCommerce 高性能订单存储（HPOS）兼容。
插件不会创建 DHL 运单、打印面单或跟踪包裹。请使用 DHL 商务客户门户或面单插件：订单中已包含 Packstation 地址和 Postnummer，格式符合 DHL 的要求。插件不计算 DHL 实时运费，也不显示地图。如果无法连接 DHL API，顾客会看到提示信息，在 API 恢复正常之前无法使用该方式。不支持手动输入 Packstation 编号。
取件点
顾客选择 DHL Packstation 后，配送选项下方会出现选择器。系统会加载配送邮编或城市附近的 DHL 取件点。顾客可以搜索其他邮编或城市。取件点按类型（Packstation、Post Office、Parcel Shop）分组，并按距离排序。
对于 Packstation，顾客必须输入 DHL Postnummer，即其 6–12 位的 DHL 客户编号，可在 DHL 应用或 DHL 账户中找到。对于其他取件点，该项为可选。没有取件点或 Postnummer 无效时，无法下单。该检查在服务器端进行，区块结账也同样适用。
搜索结果缓存 12 小时。失败的搜索缓存 10 分钟，这样结账页面在每次刷新时都不必等待 DHL。API 超时时间为 12 秒。
取件点（ID、类型、编号、名称、地址）和 Postnummer 会保存到订单中。它们会显示在订单页面的配送地址下方、感谢页面、My account > Orders 中，以及订单电子邮件（HTML 和纯文本）中，标签为 DHL pickup location 和 DHL Postnummer。
在订单页面，点击取件点旁边的 Edit，按邮编或城市搜索，选择其他取件点，修改 Postnummer，然后点击 Save location。每次修改都会添加一条订单备注。如果已开启 Shipping address，配送地址也会同步更新。刷新页面即可看到。
许可证密钥
插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > DHL Packstation 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期至何时以及您的域名。使用 Check now 重新检查状态，Change key 输入其他密钥，Remove key 将其从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，结账页面不会向顾客显示 DHL Packstation。已登录的店铺管理员仍可看到它，并标有 (unlicensed — visible to admins only)，方便您在购买密钥前完成设置和测试。插件页面和 WooCommerce 页面上会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续订。系统会在后台自动重新检查状态。
故障排除
结账页面中没有 DHL Packstation：请检查许可证是否有效、Enable/Disable 是否已开启、该方式是否已添加到顾客所在国家的区域中（或已开启 Ignore shipping zones 且允许该国家）。同时检查 DHL API key 是否已填写、是否至少选择了一种取件点类型、目的国是否有价格（或已设置 Other countries），以及重量、小计和配送类别规则是否将其隐藏。
未显示任何取件点：点击 Test API key。如果 DHL 拒绝密钥（401/403），请检查密钥，并确认您的应用已添加“Location Finder - Unified” API。开启 Debug log，然后打开 WooCommerce > Status > Logs，来源为 vfd-dhl-packstation。请检查您的 DHL 应用的请求上限是否已用尽。
某个地址附近没有取件点：增大 Search radius (meters) 或 Max results，或让顾客搜索其他邮编或城市。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件将沿用上一次已知的状态继续工作。
卸载
停用插件会保留所有设置，只会清除取件点缓存。要移除插件，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥和许可证状态始终会被移除，取件点缓存也会被移除。只有开启了 Remove data on uninstall，设置和区域配送方式才会被移除；否则将保留，以便日后重新安装。所选取件点会保留在订单中，现有订单也会保留其配送行。
DHL 和 Packstation 是其各自所有者的商标。本插件与 DHL 无关联，也未获得 DHL 的认可。