VibeFox Frenet for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：5.0 或更高版本，已安装并启用。没有 WooCommerce 时插件无法激活。
PHP：8.0 或更高版本。
Frenet 账户（仅用于实时报价）：在 Frenet 面板（painel.frenet.com.br）中创建免费账户，启用您使用的承运商，并复制您的 API 令牌。如果您只使用固定价格，则不需要 Frenet 账户。
商品：填写重量和尺寸以获得准确价格。未填写的商品按 0.3 kg 和 16 × 11 × 2 cm 报价（Correios 最小包装箱）。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_frenet 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox Frenet，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 粘贴 API 令牌并输入始发 CEP。如果您的店铺货币不是 BRL，请输入 BRL 汇率。可选择添加固定价格和备用运费。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Frenet 添加到巴西的配送区域，或开启 Ignore shipping zones 并选择国家。
配置
所有设置都在同一个页面：WooCommerce > Settings > Shipping > VibeFox Frenet。它们适用于所有配送区域。将该方式添加到某个区域时，区域窗口只有一个字段：
Title (zone)：客户为该区域看到的名称。留空则使用全局的 Method title。
页面顶部插件会显示警告：没有 API 令牌（仅使用固定价格；若也没有固定价格，则该方式不会显示）、没有 8 位数字的始发 CEP，或店铺货币不是 BRL 且未设置汇率。每次保存设置时，缓存的报价都会被清除。价格字段的小数分隔符既可以输入句点，也可以输入逗号。
常规
Enable/Disable：一次性在所有区域中关闭或开启该方式。默认：on。
Method title：购物车和结账时显示的配送方式名称。区域可以覆盖此名称。默认：Frenet。
Frenet 实时报价
Frenet 会比较您 Frenet 账户中启用的承运商，并返回它们对购物车的报价。只有巴西地址且 CEP 完整（8 位数字）时，才会请求实时报价。
API token：来自 Frenet 面板的 Frenet API 令牌。留空则仅使用固定价格。
Origin CEP：包裹的发货邮政编码（CEP），例如 00000-000。如果店铺地址在巴西，可留空以使用店铺邮编。不足 8 位数字的 CEP 会在保存时提示。
Service to offer：Cheapest service（默认）或 Fastest service。Frenet 会返回多个服务，但该方式只显示一个价格。
BRL exchange rate：Frenet 以巴西雷亚尔报价。如果店铺货币不是 BRL，请输入 1 BRL 等于多少店铺货币，例如 0.16。报价和申报的订单金额将按此汇率换算。未设置汇率时不使用实时报价。店铺货币为 BRL 时无需设置。
固定价格
在没有 API 令牌时、针对 Frenet 不服务的国家，以及 Frenet 未返回价格时（API 不可用、CEP 不在服务范围内）使用。
Price per country：一个表格，包含 Country、Price、XS、S、M、L 和 XL 列，价格以店铺货币计。点击 + Add country 添加一行，点击叉号（×）删除一行。尺寸列取决于购物车重量：XS 为 1 kg 以内，S 为 2 kg 以内，M 为 3 kg 以内，L 为 5 kg 以内，XL 为 5 kg 以上。尺寸列为空时使用 Price。Price 为 0 表示该国家免运费。其他所有国家请使用 * Default。保存时会删除没有任何价格的行。
Fallback cost：当 Frenet 和表格都没有给出价格时使用。留空则隐藏该方式。
Fixed price applies：Per order 只收取一次价格。Per item (price × quantity) 则按商品数量乘以价格。此设置仅适用于固定价格和备用运费。Frenet 报价已覆盖整个购物车。
条件
Minimum weight (kg)：购物车重量低于此值时隐藏该方式。0 表示不限制。
Maximum weight (kg)：购物车重量高于此值时隐藏该方式。默认：30。0 表示不限制。
Minimum order amount：仅当购物车小计（折扣后、税前）不低于此金额时才显示该方式。留空则始终显示。
Excluded shipping classes：如果购物车中包含这些 WooCommerce 配送类别中任一类别的商品，则隐藏该方式。
Free shipping from：购物车小计（折扣后、税前）达到此金额即免运费。留空则从不提供免运费。
Tax status：Taxable 会在运费上加收 WooCommerce 税费；None 则不加收。Frenet 价格是承运商的最终价格；如果不希望 WooCommerce 对其加税，请选择 None。
商品重量会从店铺的计量单位换算为 kg。
不使用配送区域时的可用性
Ignore shipping zones：即使未将 Frenet 添加到配送区域，也会为下列国家提供该方式。
Countries：此模式下的目标国家。留空则使用您配送的所有国家。仅在开启 Ignore shipping zones 时使用。
高级
Debug log：将每个报价请求和响应记录到 WooCommerce > Status > Logs，来源为 vfd-frenet。API 错误始终会被记录。令牌永远不会被记录，客户的 CEP 会被缩短。完成后请关闭。
Remove data on uninstall：开启后，删除插件会移除所有 Frenet 设置和区域方式。停用插件永远不会删除设置。缓存的报价始终会被删除。
结账时如何工作
客户输入配送地址后，WooCommerce 会向插件请求运费。插件首先检查购物车重量、最低订单金额和排除的配送类别。若适用免运费，则以零价格显示该方式，并且不会向 Frenet 发出请求。
对于 CEP 完整（8 位数字）的巴西地址，插件会向 Frenet 发送始发和目的 CEP、每个购物车商品（重量 kg、尺寸 cm、数量、SKU 和分类）、BRL 计价的订单金额，以及第一个应用的优惠券。CEP 不完整时不会发出请求。Frenet 返回已启用承运商的服务。出错或没有价格的服务会被跳过。插件选择最便宜或最快的服务，并将价格换算为店铺货币。承运商、服务和送达时间会与订单的运费行一起保存，并显示在后台订单页面上。
同一购物车和地址的每个响应会缓存 1 小时。失败的请求，或没有任何已启用承运商服务的 CEP，会记住 10 分钟。API 超时为 10 秒。在这些情况下，客户不会看到任何错误：会使用固定价格或备用运费；如两者都没有，则隐藏该方式。对于巴西以外的地址，仅使用固定价格。
该方式适用于经典结账以及购物车和结账区块。它与 WooCommerce 高性能订单存储（HPOS）兼容。
插件仅计算运费。它不创建发货单、不打印面单、不跟踪包裹；这些功能由 Frenet 在其自己的面板中提供。每个购物车只显示一个 Frenet 服务，而不是多个，并且不提供自提点或智能储物柜。Frenet 仅提供巴西境内的报价；其他国家请使用固定价格。
许可证密钥
插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Frenet 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将密钥从此站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放该域名的名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，Frenet 不会在结账时显示给客户。已登录的店铺管理员仍能看到它，并标记为 (unlicensed — visible to admins only)，因此您可以在购买密钥前设置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
Frenet 未在结账时显示：检查许可证是否有效、Enable/Disable 是否开启，以及该方式是否已添加到客户所在国家的区域中（或已开启 Ignore shipping zones 且允许该国家）。请查看设置页面顶部的警告、重量限制、Minimum order amount 和 Excluded shipping classes。常见原因：客户尚未输入完整的 8 位 CEP 且没有固定价格，或 Frenet 未为该路线返回服务且没有固定价格。
实时报价未显示：开启 Debug log，重新加载结账页面，然后打开 WooCommerce > Status > Logs，来源选择 vfd-frenet。其中会显示原因：令牌被拒绝（HTTP 401 或 403）、没有始发 CEP、没有 BRL 汇率、Frenet 面板中没有启用任何承运商，或被跳过服务的消息。
我的店铺以欧元或美元销售：Frenet 以 BRL 响应。请输入 BRL exchange rate（1 BRL 等于多少店铺货币）。
修改后报价看起来过时：保存设置页面即可清除缓存的报价。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件将沿用最后已知的状态继续工作。
卸载
停用插件会保留所有设置，只清除缓存的报价。要移除插件，请先停用，然后在 Plugins 页面删除。此插件的许可证密钥和许可证状态、缓存的报价以及旧日志文件始终会被删除。只有开启了 Remove data on uninstall 时，设置和区域方式才会被删除；否则它们会保留，以便日后重新安装。现有订单会保留其使用 Frenet 承运商的运费行。
Frenet 是其各自所有者的商标。本插件与 Frenet 没有关联，也未获得 Frenet 的认可。