VibeFox Packeta for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。未安装时插件无法启用。
PHP：8.0 或更高版本。
Packeta API 密钥：可在 Packeta 客户区（client.packeta.com）的 Client support 下找到。它由 16 个字母和数字组成。小部件需要它才能在结账时打开，因此只有输入 API 密钥后，顾客才会看到该配送方式。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_packeta 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox Packeta，或在插件页面的插件名称下点击 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入您的 Packeta API key 和价格：至少添加一行 Country prices（例如 * Default），或设置 Fallback cost。然后保存。页面会显示 Packeta 是否接受了该密钥。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Packeta 添加到捷克共和国、斯洛伐克、匈牙利或罗马尼亚的配送区域，或开启 Ignore shipping zones。
配置
所有设置都位于同一页面：WooCommerce > Settings > Shipping > VibeFox Packeta。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：顾客在该区域看到的名称。留空则使用全局的 Name。
该方式仅面向 Packeta 自有取件点网络中的国家：CZ、SK、HU 和 RO。在设置上方，页面会显示 API 密钥检查结果以及问题警告，例如缺少 API 密钥、缺少价格，或所选国家不在 Packeta 网络内。
所有价格和限制都接受逗号或小数点作为小数分隔符（4,99 或 4.99）。无效数字会被拒绝并给出提示，且保留原值。
常规
Enable/Disable：一次性在所有区域中启用或禁用该方式。
Name：顾客看到的配送方式名称。区域可以用自己的 Title 覆盖它。默认值：Packeta pickup point。
API key：您在 client.packeta.com > Client support 中获得的 Packeta API 密钥。您也可以粘贴 32 个字符的 API 密码：只保存前 16 个字符，即 API 密钥。API 密钥是公开的：它会被发送到顾客的浏览器以打开小部件。保存新密钥时，会与 Packeta 承运商数据源核对，页面会显示 Packeta API key verified，或显示 Packeta 已拒绝该密钥。如果无法完成核对，密钥仍会保存，并在您下次保存时再次核对。
Widget language：取件点小部件的语言。Store / visitor language（默认）跟随页面语言。您也可以将其固定为捷克语、斯洛伐克语、匈牙利语、罗马尼亚语、英语、德语、波兰语或乌克兰语。
Pickup point types：小部件提供的 Packeta 网点类型。
Tax status：Taxable 会将 WooCommerce 税费加到运费上，None 则不加。
价格
Packeta 没有公开的运费 API。价格取自此表，并以店铺货币输入。
Calculation type：Per order 按订单收取一次费用。Per item (price x quantity) 则将价格乘以购物车中可配送商品的数量。
Country prices：按目的国家和包裹重量设置价格。点击 + Add 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，即免运费。保存前请选择国家并输入价格，否则请删除该行。如果同一国家出现在两行中，保存时只保留第一行。
Fallback cost：当国家表中没有目的地对应的行，且没有 * Default 行时使用。留空则不在该地区提供此方式。
Free shipping from：购物车小计（折扣后、不含税）达到该金额后，Packeta 配送免运费。仅适用于已设置价格的情况：国家行、* Default 行或备用费用。留空则从不提供免运费。
可用性
Minimum weight (kg)：购物车重量低于该值时隐藏此方式。购物车重量会从店铺的重量单位换算。留空或为 0 表示无限制。
Maximum weight (kg)：购物车重量超过该值时隐藏此方式。默认值：15。Packeta 取件点和 Z-BOX 通常接受最多 15 kg 的包裹；请查看您与 Packeta 的合同。留空或为 0 表示无限制。
Minimum cart subtotal：仅当购物车小计（折扣后、不含税）达到该金额时才提供此方式。
Excluded shipping classes：购物车中包含以下任一 WooCommerce 配送类别的商品时，隐藏此方式。
Ignore shipping zones：开启后，即使未将此方式添加到对应的配送区域，也会为下方所选国家提供此方式。关闭时，仅在已添加该方式的区域中提供。
Countries (ignore zones mode)：此模式下的目的国家。留空则使用所有 Packeta 国家。不在 Packeta 取件点网络内的国家会被跳过。仅当 Ignore shipping zones 开启时才使用此字段。
高级
Debug log：将运费计算和取件点选择写入 WooCommerce > Status > Logs（来源为 "vfd-packeta"）。不会记录顾客个人数据和 API 密钥。API 密钥检查失败时始终会记录。使用完毕后请关闭日志。
Remove data on uninstall：开启后，删除插件会移除此方式的设置和区域实例。停用插件从不删除任何内容。订单中保存的取件点始终会保留。
结账时的工作方式
顾客输入收货地址后，WooCommerce 会向插件请求运费。插件检查以下条件：收货国家是否在 Packeta 网络内、API 密钥、购物车重量、购物车最低小计和排除的配送类别。价格先取自国家表，其次取自备用费用。若没有价格，则隐藏此方式。若适用免运费，顾客将看到该方式且无需付费。
顾客选择 Packeta 方式后，其下方会出现 Choose pickup point 按钮。它会在顾客的浏览器中打开 Packeta 官方小部件，并带上收货国家、购物车重量、所选网点类型和小部件语言。顾客选定取件点后，其名称和地址会显示在该方式下方，按钮变为 Change pickup point。结账页面刷新或重新加载后，该选择仍保存在顾客的会话中。
结账时，您的服务器不会向 Packeta 请求任何内容。小部件脚本从 widget.packeta.com 加载。如果该脚本被拦截（被广告或隐私拦截器、内容安全策略或 Packeta 故障拦截），顾客会看到提示：“The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.”
该方式适用于经典结账以及购物车和结账区块，并兼容 WooCommerce 高性能订单存储（HPOS）。
Packeta 价格不会实时查询，而是取自您的价格表。插件不会创建 Packeta 运单、打印面单或跟踪包裹，也不默认提供上门配送或合作承运商的取件点。请按您平时的方式将订单中的取件点 ID 提交给 Packeta，例如在 client.packeta.com 中导入。
取件点
取件点为必选项。如果顾客未选择取件点就下单，结账会停止，并提示“Please choose a Packeta pickup point.”。如果所选取件点与收货地址不在同一国家，结账会停止，并提示“The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.”。这两项检查都在服务器端完成，经典结账和区块结账均适用。插件不会向 Packeta 验证取件点 ID；它只检查是否已选择取件点，以及该取件点的国家是否匹配。
取件点会在订单创建时与订单一同保存：
管理后台订单页面：Packeta pickup point，包括名称、地址、Pickup point ID 和国家，位于收货地址下方。如果 Packeta 订单没有取件点，页面会显示“No pickup point was selected for this order.”。
感谢页面和订单查看页：Packeta pickup point:，包括名称和地址。
订单电子邮件：HTML 和纯文本电子邮件中的取件点名称和地址。发给管理员的邮件还包括 Pickup point ID。
在数据库中，取件点保存在订单元数据 _vfd_pckt_point_id、_vfd_pckt_point_name（名称和地址）和 _vfd_pckt_point_country 中。
许可证密钥
本插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Packeta 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，结账页面不会向顾客显示 Packeta。已登录的店铺管理员仍会看到该方式，并标注 (unlicensed — visible to admins only)，以便您在购买密钥前完成设置和测试。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响。
许可证过期后，插件仍可继续运行，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账时不显示 Packeta：请检查许可证是否有效、Enable/Disable 是否开启、是否已输入 API key，以及目的国家是否为 CZ、SK、HU 或 RO。检查该国家是否已设置价格（国家行、* Default 行或 Fallback cost）、重量和小计限制、Excluded shipping classes，以及该方式是否已添加到对应区域（或已开启 Ignore shipping zones）。设置页面顶部会列出配置问题。开启 Debug log，即可在 WooCommerce > Status > Logs 中查看原因。
Packeta 拒绝了 API 密钥：请从 client.packeta.com > Client support 重新复制 API 密钥并保存。在此之前，小部件无法在结账时打开。
小部件无法打开：Packeta 脚本被广告或隐私拦截器、内容安全策略或 Packeta 故障拦截。请在内容安全策略中允许 widget.packeta.com。开发人员可以使用 vfd_pckt_widget_url 过滤器更改脚本 URL。
运费错误地显示为免费：请检查 Country prices 中 Price 为 0 的行，尤其是通过 + Add country 添加且未填写的 * Default 行。
其他国家或承运商：默认情况下，该方式适用于 CZ、SK、HU 和 RO。开发人员可以使用 vfd_pckt_countries 过滤器添加国家，并使用 vfd_pckt_widget_options 过滤器将承运商 ID 传递给小部件。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已用于其他域名，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件将沿用最后一次已知的状态继续运行。
卸载
停用插件会保留所有数据。如需删除，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥和许可证状态始终会被删除，已保存的 API 密钥检查记录也会一并删除。只有开启了 Remove data on uninstall 时，设置和区域方式才会被删除；否则它们会保留，供以后重新安装时使用。现有订单会保留其配送行和已保存的取件点。
Packeta 是其各自所有者的商标。本插件与 Packeta 无关联，也未获得 Packeta 的认可。