VibeFox DPD Pickup for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。没有 WooCommerce 时插件无法启用。
PHP：8.0 或更高版本。
DPD Baltic 凭据（立陶宛、拉脱维亚、爱沙尼亚）：取件点列表来自 DPD Baltic 网络服务。您需要 DPD 发放给企业客户的 API 用户名和密码。请向您的 DPD 客户经理或您所在国家的 DPD 客服咨询。一个账户即可列出立陶宛、拉脱维亚和爱沙尼亚的取件点。
DPD 斯洛伐克：DPD 斯洛伐克公开的 parcelshop 查询无需凭据。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_dpd_pickup 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox DPD Pickup，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 选择您的 DPD API。若使用 DPD 立陶宛、拉脱维亚或爱沙尼亚，请输入 API 用户名和密码。按国家输入价格并保存。点击 Refresh pickup points 检查连接（参见配置）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox DPD Pickup 添加到您的配送区域，或开启 Ignore shipping zones。
配置
所有设置都在同一页面：WooCommerce > Settings > Shipping > VibeFox DPD Pickup。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone):该区域结账时此选项的名称。留空则使用全局的 Name。
设置上方的警告会提示您 DPD Baltic 用户名或密码为空，以及未设置任何价格的情况。每次保存设置时，取件点缓存都会被清除。
常规
Enable/Disable:一次性在所有区域中启用或禁用该方式。
Name:结账时显示的配送方式名称。默认：DPD Pickup Point。
Tax status:Taxable 会将 WooCommerce 税费加到运费上，None 则不加。
DPD 取件点列表
取件点从 DPD 加载，并缓存 24 小时。
DPD API:您的账户所属的 DPD 公司。Baltic 账户使用其所在国家的网络服务。
API username (Baltic):您的 DPD Baltic 网络服务用户名。DPD 斯洛伐克无需此项。
API password (Baltic):您的 DPD Baltic 网络服务密码。DPD 斯洛伐克无需此项。
Pickup points:Refresh pickup points 按钮会清除缓存，并立即从 DPD 加载取件点：Baltic API 加载立陶宛、拉脱维亚和爱沙尼亚的取件点，DPD 斯洛伐克则在布拉迪斯拉发进行测试查询。结果按国家分别显示。请先保存设置。
价格
配送价格按国家固定，以店铺货币计。DPD 价格不会通过 API 请求。
Country prices:每个国家一行：CC:price，例如 EE:3.50。接受小数点。默认：SK:3.50、LT:4.00、LV:4.00、EE:4.00。
Fallback cost:不在 Country prices 中的国家所使用的价格。默认：5.00。留空则仅在列出的国家提供该方式。
Calculation type:Per order 按订单收取一次价格。Per item (price x quantity) 则按购物车中的商品数量相乘。
Free shipping from:订单小计（使用优惠券后）达到此金额时免运费。留空则关闭此功能。
可用性
当 DPD 未返回顾客地址的取件点，或无法连接 DPD API 时，该方式也会被隐藏，因为没有取件点的订单无法配送。
Min weight (kg):购物车的最小重量。商品重量会从您店铺的重量单位换算。留空或为 0 表示不限制。
Max weight (kg):超过此重量的购物车不会看到该方式。默认：31.5。0 表示不限制。请查看您所在国家 DPD Pickup 取件点和快递柜的包裹限制。
Minimum subtotal:仅当订单小计不低于此金额时才显示该方式。留空则始终显示。
Excluded shipping classes:如果购物车中含有属于这些 WooCommerce 运费类别的商品，则隐藏该方式。
Ignore shipping zones:即使顾客的配送区域未包含该方式，也为下方列出的国家提供该方式。关闭时，您需要像平常一样将该方式添加到配送区域。
Countries:此模式下的目标国家。留空表示所有国家。仅在 Ignore shipping zones 开启时使用。
取件点选择器
City order:优先显示主要城市（塔林、里加、维尔纽斯、布拉迪斯拉发等）。默认开启。
City list width:城市列表的 CSS 宽度，例如 100% 或 300px。默认：100%。
Pickup point list width:取件点列表的 CSS 宽度，例如 100% 或 400px。默认：100%。
高级
Debug log:在 WooCommerce > Status > Logs 中记录 API 请求和结账步骤，来源为 vfd-dpd-pickup。即使此选项关闭，API 错误仍会始终记录。凭据绝不会被记录。
Remove data on uninstall:开启时，删除插件会移除其设置和区域方式。停用插件从不会删除设置。订单中保存的取件点始终保留。
结账时的工作方式
顾客输入配送地址时，WooCommerce 会向插件请求价格。插件检查购物车重量、最低小计和排除的运费类别，获取该国家的价格（或备用价格），并在小计足够高时应用免运费。随后，插件加载该地址的 DPD 取件点。如果 DPD 未返回任何取件点、无法连接，或缺少 Baltic 凭据，则隐藏该方式。
取件点列表缓存 24 小时。失败的请求会记住 5 分钟，因此 DPD 故障永远不会拖慢结账。API 超时时间为 15 秒。
该方式适用于经典结账以及购物车和结账区块。它兼容 WooCommerce 高性能订单存储（HPOS）。
插件不会向 DPD 请求价格、创建 DPD 运单、打印面单、生成交接清单、预约快递上门取件、跟踪包裹或显示地图。仅支持 DPD Baltic 网络服务和 DPD 斯洛伐克 parcelshop 查询。
取件点
顾客选择 DPD Pickup 后，该方式下方会出现城市列表和取件点列表。顾客地址所在城市会被预先选中。使用 DPD 斯洛伐克时，顾客先输入城市和邮政编码，然后才能看到附近的取件点。选择取件点是必需的。服务器会检查该取件点是否属于顾客的国家和地址，因此伪造或过期的选择会被拒绝。
所选取件点会保存在订单中。它会显示在订单页面的配送地址下方、感谢页面、My account > Orders 中，以及订单电子邮件（HTML 和纯文本）中，标签为 DPD pickup point。订单中保存的名称来自 DPD，而不是来自浏览器。
在订单页面上，点击取件点旁边的 Edit，选择城市和另一个取件点。该取件点会根据订单地址的 DPD 列表进行核对。订单必须有配送城市和邮政编码才能更改取件点。
许可证密钥
本插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox DPD Pickup 页面顶部。将密钥粘贴到 License key 中并点击 Activate。该区块会显示状态，例如许可证有效期的截止日期以及您的域名。使用 Check now 可重新检查状态，Change key 用于输入其他密钥，Remove key 用于从本站点移除密钥。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放该域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，DPD Pickup 不会在结账时向顾客显示。已登录的店铺管理员仍能看到它，并标注为 (unlicensed — visible to admins only)，这样您可以在购买密钥之前设置和测试插件。插件页面和 WooCommerce 页面上会出现提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续订。系统会在后台自动重新检查状态。
故障排除
DPD Pickup 未出现在结账页面：请检查许可证是否有效，Enable/Disable 是否开启，以及该方式是否已添加到顾客所在国家的配送区域（或 Ignore shipping zones 已开启且允许该国家）。查看设置页面顶部的警告，并点击 Refresh pickup points。检查重量和小计限制、排除的运费类别，以及该国家是否设有价格（或备用费用）。
点击 Refresh pickup points 后显示 "Login failed"：DPD 拒绝了 Baltic 凭据，因此无法加载任何取件点。请与 DPD 核对 API 用户名和密码。
DPD 斯洛伐克没有显示取件点：取件点在顾客输入城市和邮政编码后才会显示。DPD 只列出该地址 50 公里范围内的取件点。
查找原因：开启 Debug log。每个决策都会写入 WooCommerce > Status > Logs，来源为 vfd-dpd-pickup。API 错误始终会被记录。API 用户名和密码绝不会写入日志。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件将继续使用最后一次已知的状态工作。
卸载
停用插件会保留所有设置，仅清除取件点缓存。要删除插件，请在 Plugins 页面中停用并删除。本插件的许可证密钥和许可证状态始终会被删除，取件点缓存也一样。设置和区域方式仅在 Remove data on uninstall 开启时才会被删除；否则它们会保留，以便日后重新安装。订单中保存的取件点永远不会被删除，现有订单也会保留其配送项目。
DPD 是其各自所有者的商标。本插件与 DPD 没有关联，也未获得 DPD 的认可。