VibeFox Estafeta for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。没有 WooCommerce 时，插件无法激活。
PHP：8.0 或更高版本。
DrEnvio 账户（仅用于实时运费）：Estafeta 的实时运费来自 DrEnvio，即 Estafeta 在墨西哥的合作伙伴。请在 drenvio.com 创建账户，启用 Estafeta，在那里设置您的取件地址，并从 DrEnvio 面板复制 API 密钥。这与官方 DrEnvio 插件使用的密钥相同。如果您只使用自有价格，则无需 DrEnvio 账户。
商品：使用实时运费时，商品需要设置重量。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_estafeta 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox Estafeta，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入 DrEnvio API 密钥，并可选择输入发货地邮政编码。如果您的店铺货币不是 MXN，请输入 MXN exchange rate。如果希望在 DrEnvio 没有运费时仍显示该配送方式，请为 MX 设置国家价格或备用费用。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Estafeta 添加到墨西哥配送区域；或开启 Ignore shipping zones 并选择国家。
配置
所有设置都在同一页面：WooCommerce > Settings > Shipping > VibeFox Estafeta。这些设置适用于所有配送区域。将该配送方式添加到某个区域时，区域窗口只有一个字段：
Title (zone)：结账时此选项的名称。留空则使用全局 Name。
页面顶部会显示插件的警告：未设置 DrEnvio API 密钥；店铺货币不是 MXN 且未设置汇率；或未为 MX 设置国家价格也未设置备用费用（此时若没有实时运费，该配送方式会被隐藏）。每次保存设置时，DrEnvio 的缓存运费都会被清除。数字字段可接受小数点或逗号。无效的数字会在保存时被清除并提示。
常规
Enable/Disable：同时在所有区域启用或禁用 Estafeta 配送。默认：开启。
Name：结账时向客户显示的配送方式名称。默认：Estafeta。
Tax status：Taxable 允许 WooCommerce 在运费上加收税费，None 则不加。DrEnvio 价格是否包含 IVA 取决于您的 DrEnvio 账户。如果价格已包含 IVA，请选择 None。默认：Taxable。
实时运费（DrEnvio API）
为该地址提供最便宜的 Estafeta 服务。没有密钥时，使用下一部分的价格。
DrEnvio API key：DrEnvio 面板中的 API 密钥。
Origin country：取件地址的两位国家代码。默认：MX。仅在同时设置发货地邮政编码时发送。
Origin postcode：取件地址的 5 位邮政编码。留空则使用您 DrEnvio 账户中保存的发货地址。不是 5 位数字的邮政编码会在保存时被清除。
MXN exchange rate：DrEnvio 以墨西哥比索报价。仅在店铺货币不是 MXN 时需要：1 MXN 等于多少店铺货币，例如 0.05。没有它，就不会使用实时运费。
无实时运费时的价格
在没有 API 密钥，或 DrEnvio 未返回 Estafeta 运费时使用（API 不可用、邮政编码未知、尚未输入邮政编码）。价格以店铺货币计。
Country prices：每行一个目的国家，格式为 CC:PRICE，例如 MX:150。请使用小数点或逗号，不要使用千位分隔符。格式不符的部分会被忽略，并在保存时提示。
Fallback cost：既没有实时运费也没有国家价格时的价格。留空则隐藏该配送方式；0 表示免运费。
Calculation type：Per order 只收取一次价格。Per item (price x number of items) 则按可发货商品数量相乘。这适用于 Country prices 和 Fallback cost。DrEnvio 实时运费始终是整个包裹的价格。
条件
Free shipping from：购物车小计达到此金额时免运费。此时不会向 DrEnvio 发出请求。留空则从不提供免运费。
Minimum subtotal：仅当购物车小计至少达到此金额时显示该配送方式。留空则始终显示。
Min weight (kg)：配送方式显示所需的最低购物车重量。0 表示不限制。
Max weight (kg)：购物车最高重量。超过时隐藏该配送方式。默认：30。0 表示不限制。
Excluded shipping classes：如果购物车中有商品属于这些 WooCommerce 配送类别之一，则隐藏该配送方式。
商品重量会从店铺单位换算为 kg。
无配送区域时的可用性
Ignore shipping zones：即使未将该配送方式添加到任何配送区域，也会为下方指定的国家提供该方式。
Countries：此模式下的目的国家。留空表示所有国家。仅在开启 Ignore shipping zones 时使用。
高级
Debug log：将 API 请求和运费计算记录到 WooCommerce > Status > Logs，来源为 vfd-estafeta。API 错误始终会被记录。API 密钥和客户地址从不记录。
Remove data on uninstall：开启后，删除插件会移除所有插件设置和区域配送方式。停用插件不会删除任何内容。
结账时的工作方式
客户输入收货地址时，WooCommerce 会向插件请求运费。插件首先检查购物车重量、最低小计和排除的配送类别。如果适用免运费，则以零价格显示该配送方式，并且不会向 DrEnvio 发出请求。
否则，插件会向 DrEnvio 发送目的国家和邮政编码、购物车重量、商品数量和小计，并在您设置了发货地邮政编码时一并发送。墨西哥邮政编码必须为 5 位数字；在客户输入之前，不会发出请求。DrEnvio 会返回您账户中所有承运商的报价。插件只使用 Estafeta 报价，忽略零价格，选择最便宜的一个，并将其转换为店铺货币。Estafeta 服务和配送时间会与订单的配送行一同保存，并显示在后台订单页面。
每个响应缓存 1 小时。失败的请求或没有 Estafeta 运费的路线会记录 5 分钟，因此缓慢或故障的 API 不会拖慢每次结账更新。API 超时时间为 12 秒。在这些情况下，客户不会看到任何错误：使用国家价格或备用费用，若两者均未设置，则隐藏该配送方式。
该配送方式适用于经典结账以及购物车和结账区块。它与 WooCommerce 高性能订单存储（HPOS）兼容。
插件只计算运费。它不创建发货单，不打印运单（guías），也不追踪包裹；请在您的 DrEnvio 或 Estafeta 账户中创建发货单。客户无法选择特定的 Estafeta 服务或 Estafeta 网点，汇率也不会自动更新。
许可证密钥
插件需要使用从 vibefox.net 获取的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Estafeta 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，Estafeta 不会在结账时向客户显示。已登录的店铺管理员仍可看到它，并标有 (unlicensed — visible to admins only)，这样您可以在购买密钥前设置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
结账时不显示 Estafeta：请检查许可证是否有效、Enable/Disable 是否开启，以及该配送方式是否已添加到客户所在国家的区域（或已开启 Ignore shipping zones 且该国家已允许）。请查看设置页面顶部的提示、重量限制、Minimum subtotal 和 Excluded shipping classes。如果没有 API 密钥，或 DrEnvio 没有 Estafeta 运费，该配送方式需要目的地的国家价格或备用费用。
实时运费不显示：开启 Debug log，刷新结账页面，然后打开 WooCommerce > Status > Logs，来源为 vfd-estafeta。日志会显示原因：没有 API 密钥、非 MXN 店铺没有汇率、邮政编码缺失或无效、API 密钥被拒绝（HTTP 401 或 403），或该路线没有 Estafeta 运费。
价格是否包含 IVA？这取决于您的 DrEnvio 账户。如果 DrEnvio 价格已包含 IVA，请将 Tax status 设为 None。
修改后运费看起来过时：保存设置页面即可。这会清除缓存的 DrEnvio 运费。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件会继续使用最后已知的状态运行。
卸载
停用插件会保留所有设置，只清除运费缓存。如需移除，请先停用插件，然后在 Plugins 页面中删除。该插件的许可证密钥和许可证状态、缓存的运费以及旧日志文件始终会被删除。只有开启了 Remove data on uninstall，设置和区域配送方式才会被删除；否则它们会保留，供以后重新安装时使用。订单永远不会被改动，现有订单会保留其配送行。
Estafeta 和 DrEnvio 是其各自所有者的商标。本插件与 Estafeta 或 DrEnvio 无关联，也未获得其认可。