VibeFox EasyPost for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。没有 WooCommerce，插件无法启用。
PHP：8.0 或更高版本。
EasyPost 账户（仅用于实时运费）：在 EasyPost 网站创建账户，在 EasyPost 控制面板中连接您的承运商账户（USPS、UPS、FedEx 等），并从 EasyPost Dashboard > Account Settings > API Keys 复制 API 密钥。EasyPost 对购买的运单收费，而不对运费请求收费。如果您只使用备用价格，则无需 EasyPost 账户。
商品：商品需要设置重量，最好同时设置尺寸。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_easypost 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox EasyPost，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 粘贴您的 EasyPost API 密钥，并填写 Ship from 地址。实时运费需要邮政编码。
6. 如果您的店铺货币不是美元，请输入 USD exchange rate。您也可以选择输入备用价格（参见配置）。
7. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox EasyPost 添加到某个配送区域；或者开启 Ignore shipping zones 并选择国家。
配置
所有设置都位于同一页面：WooCommerce > Settings > Shipping > VibeFox EasyPost。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone): 顾客在该区域看到的配送方式名称。留空则使用全局的 Name。
页面顶部，当无法使用实时运费时，插件会显示警告：未设置 API 密钥、未设置发货邮政编码或国家，或店铺货币不是美元且未设置汇率。设置测试 API 密钥时还会显示提示。每次保存设置时，缓存的 EasyPost 运费都会被清除。
常规
Enable/Disable: 一次性在所有区域中启用或禁用该方式。默认：开启。
Name: 购物车和结账页面中显示的配送方式名称。区域可以用自己的 Title 覆盖它。默认：EasyPost Shipping。
EasyPost 账户
API key: 您在 EasyPost Dashboard > Account Settings > API Keys 中的 EasyPost API 密钥。正式密钥（以 EZAK 开头）返回真实运费。测试密钥（以 EZTK 开头）返回 EasyPost 测试运费；仅用于测试。
Allowed carriers / services: 可选，用逗号分隔。按 EasyPost 的命名输入承运商（USPS）或承运商和服务（USPS:Priority、UPS:Ground）。显示允许范围内最便宜的运费。留空则显示任何承运商中最便宜的运费。
发货地址
您的包裹寄出的地址。如果 Country 是您店铺所在国家，空白字段将从 WooCommerce > Settings > General 中的店铺地址获取（寄件人姓名则取自网站标题）。
Sender name / company: 寄件人姓名或公司名称。
Street address: 发货地址的街道。
City: 发货城市。
State: 两位州代码，例如 CA 或 NY。
ZIP code: 发货邮政编码。实时运费必填。
Country: 您发货所在的国家。默认：United States。
运费
Parcels: 购物车如何发送至 EasyPost。
重量会从店铺的重量单位换算为盎司（最少 1 oz），尺寸换算为英寸。如果某个商品没有尺寸，则仅按重量计算包裹运费。
USD exchange rate: EasyPost 运费以美元计价。输入 1 美元对应的店铺货币价格，例如 0.92。未设置时不使用实时运费，只使用备用价格。店铺货币为美元时无需设置。美元和加元店铺会要求 EasyPost 以各自货币报价。小数点和逗号均可作为小数分隔符。
Tax status: Taxable 表示 WooCommerce 会根据您的税务规则对运费征税，None 表示不征税。EasyPost 运费不含销售税。默认：Taxable。
备用价格
在没有实时运费时使用：未设置 API 密钥、无法连接 EasyPost、密钥被拒绝，或没有任何承运商对该地址提供运费。价格以店铺货币计。若要在这种情况下隐藏该方式，请将两个字段都留空。
Country prices: 每个国家一行：两位国家代码、冒号和价格，例如 US:9.99。格式不正确的行会被忽略，并在保存时列在错误消息中。
Other countries: 上方列表中未包含的国家的价格。留空则对这些国家隐藏该方式。
条件
Free shipping from: 购物车小计达到该金额即免运费。此时不会向 EasyPost 发送任何请求。留空则关闭此功能。
Minimum subtotal: 仅当购物车小计至少达到该金额时才显示该方式。留空则始终显示。
Minimum weight: 当购物车重量低于该值时隐藏该方式（以店铺重量单位计）。0 表示无限制。
Maximum weight: 当购物车重量高于该值时隐藏该方式（以店铺重量单位计）。0 表示无限制。
Disabled shipping classes: 当购物车包含任一这些 WooCommerce 配送类别中的商品时隐藏该方式。
不使用配送区域时的可用性
Ignore shipping zones: 无论该方式是否已添加到某个区域，都为下列国家提供该方式。
Countries: 该模式下的目标国家。留空则使用店铺配送的所有国家。该字段仅在开启 Ignore shipping zones 时使用。
高级
Debug log: 将 EasyPost 请求写入 WooCommerce > Status > Logs，来源为 vfd-easypost。即使此选项关闭，API 错误也始终会记录。API 密钥和顾客地址绝不会被记录。
Remove data on uninstall: 开启后，删除插件时会移除其设置和区域方式。停用插件从不删除设置。
结账时的工作方式
顾客输入配送地址时，WooCommerce 会向插件请求运费。插件首先检查条件：配送国家、购物车重量、最低小计和已禁用的配送类别。如果适用免运费，则以零价格显示该方式，且不会向 EasyPost 发送请求。
否则，插件会将发货地址、配送地址和包裹发送给 EasyPost，并接收您所有承运商账户的运费。它会选择允许范围内最便宜的运费，将其换算为店铺货币，并显示在您的方式名称下。对于需要邮政编码的国家，只有在顾客输入邮政编码后才会发出请求。
对于相同的地址和包裹，每个响应缓存 1 小时。没有可用运费的地址会被记住 10 分钟。发生超时、密钥被拒绝、速率限制或 EasyPost 服务器错误后，5 分钟内不会发出任何请求。API 超时时间为 10 秒。在所有这些情况下，顾客都不会看到错误：会使用备用价格；如果没有备用价格，则隐藏该方式。
所选承运商和服务，以及在单包裹模式下的预计送达天数，会保存在订单的配送行中。您可以在后台订单页面查看。
该方式适用于经典结账页面以及购物车和结账区块。它与 WooCommerce 高性能订单存储（HPOS）兼容。
插件仅计算运费。它不购买运单、不跟踪包裹、不验证地址、不提供取件或投递网点，也不添加保险或签名选项。它只显示一个选项（允许范围内最便宜的运费），而不是服务列表。除将商品装入一个包裹外，不进行装箱优化，也不加收运费加价或手续费。
许可证密钥
插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox EasyPost 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接可打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，结账页面不会向顾客显示 EasyPost。已登录的店铺管理员仍可看到该方式，并标记为 (unlicensed — visible to admins only)，以便您在购买密钥前设置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。
故障排除
结账页面中没有显示 EasyPost：请检查许可证是否有效、Enable/Disable 是否已开启，以及该方式是否已添加到顾客所在国家的区域中（或已开启 Ignore shipping zones 且该国家被允许）。检查重量限制、Minimum subtotal 和 Disabled shipping classes。没有实时运费时，该方式需要为该国家或 Other countries 设置备用价格。
实时运费不显示：请先阅读设置页面顶部的警告，然后开启 Debug log，刷新结账页面，并打开 WooCommerce > Status > Logs，来源选择 vfd-easypost。常见原因：未设置 API 密钥或发货邮政编码；非美元店铺且未设置 USD exchange rate；顾客尚未输入邮政编码；您的 EasyPost 账户中没有承运商服务该地址；或 Allowed carriers / services 过滤掉了所有运费。
运费看起来像测试价格：已设置测试密钥（EZTK...）。请在正式店铺中使用正式密钥（EZAK...）。
运费暂停了几分钟：发生超时、密钥被拒绝或 EasyPost 服务器错误后，插件会暂停请求 5 分钟，并使用备用价格。请检查 API 密钥和日志。
是否含税？EasyPost 运费不含销售税。当 Tax status 为 Taxable 时，WooCommerce 会根据您的税务设置对运费征税。
更改后运费看起来过时：保存设置页面即可。这会清除缓存的 EasyPost 运费。
开发者钩子：过滤器 vfd_ep_shipment_request（请求正文）、vfd_ep_selected_rate（所选运费）、vfd_ep_api_url（API 基础 URL）以及 woocommerce_shipping_vfd_easypost_is_available 可用于调整插件。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件将继续使用最后已知的状态运行。
卸载
停用插件会保留所有设置，仅清除缓存的运费。要删除插件，请先停用，然后在 Plugins 页面中将其删除。本插件的许可证密钥和许可证状态、缓存的运费以及旧日志文件始终会被删除。只有开启了 Remove data on uninstall 时，设置和区域方式才会被删除；否则它们会保留，以便之后重新安装。现有订单会保留其配送行。
EasyPost 是其各自所有者的商标。本插件与 EasyPost 无关联，也未获得 EasyPost 的认可。