VibeFox Australia Post for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：5.0 或更高版本，已安装并启用。未安装 WooCommerce 时插件无法激活。
PHP：8.0 或更高版本。
Australia Post PAC API 密钥（仅实时运费需要）：实时运费使用 Australia Post 包裹计价计算器（PAC）API。该密钥免费：请在 Australia Post Developer Centre（developers.auspost.com.au）注册以获取 PAC API 密钥。您还需要所发货地址的 4 位澳大利亚邮政编码。如果只使用按国家设置的固定价格，则无需 API 密钥。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_australia_post 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Shipping > VibeFox Australia Post，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 选择 Rate source。如需实时运费，请输入 PAC API 密钥、发货邮政编码；如果店铺货币不是 AUD，还需输入 AUD 汇率（参见「配置」）。
6. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Australia Post 添加到某个配送区域；或者开启 Ignore shipping zones 并选择国家。
配置
所有设置都在同一页面：WooCommerce > Settings > Shipping > VibeFox Australia Post。这些设置适用于所有配送区域。将该方式添加到某个区域时，区域窗口中只有一个字段：
Title (zone)：此区域中向顾客显示的名称。留空则使用全局的 Method title。
每次保存设置时，Australia Post 的运费缓存都会被清除。如果选择了实时运费，但缺少 API 密钥、发货邮政编码或 AUD 汇率，保存后会显示警告。
常规
Enable/Disable：一次性在所有区域中启用或禁用该方式。
Method title：结账时向顾客显示的配送方式名称。某个区域可以用自己的标题覆盖它。默认值：Australia Post。
Tax status：Taxable 会在配送费上加收 WooCommerce 税费，None 则不加收。
Rate source：价格的计算方式。
错误详情会记录到日志中，绝不会显示给顾客。
Australia Post API（实时运费）（固定价格无需此项）
PAC API key：您的免费 Australia Post PAC API 密钥。它会在 AUTH-KEY 请求头中发送给 Australia Post。
Ship-from postcode：包裹的发货地 4 位澳大利亚邮政编码，例如 2000。
Domestic service：用于澳大利亚境内配送（最大 22 kg，每边最长 105 cm）：Parcel Post（默认）或 Express Post。
International service：用于境外配送（最大 20 kg）：International Standard（默认）、International Express 或 International Courier。
Remove GST：将国内 API 价格除以 1.1。Australia Post 的国内价格包含 10% 的 GST。当 WooCommerce 自行对运费征税（Tax status = Taxable）时开启此选项，以免重复征收 GST。国际邮费免征 GST，且绝不会被修改。
AUD → (your currency) rate：Australia Post 的价格以 AUD 计。如果您的店铺货币不是 AUD，请输入 1 AUD 等于多少您的货币单位，例如 0.61。未设置此项时不会使用实时运费。如果店铺货币是 AUD，请留空。小数点和逗号均可作为小数分隔符。
实时运费的包裹设置
购物车将作为一个包裹发送。商品重量和尺寸会从您店铺的单位换算为千克和厘米。以下数值用于没有重量或尺寸的商品。
Default product weight (kg)：用于没有重量的每件商品，适用于 Australia Post 请求以及 Min cart weight / Max cart weight 检查。默认值：1。
Default parcel length (cm)：当购物车中没有任何商品有尺寸时使用。默认值：22。
Default parcel width (cm)：当购物车中没有任何商品有尺寸时使用。默认值：16。
Default parcel height (cm)：当购物车中没有任何商品有尺寸时使用。默认值：8。
固定价格（用于固定价格模式，也用作实时运费的备用价格）
Country prices：一个表格，包含 2 位国家代码（AU、NZ、US 等）以及以您店铺货币计价的价格。点击 + Add row 添加国家，点击删除按钮删除一行。使用 * 代表所有其他国家。没有价格的国家（且没有 * 行）不会获得固定运费，因此对该国家隐藏此方式。在您添加价格之前，表格为空。
Fixed price per：Order 按订单收取一次价格。Item (price × quantity) 则按购物车中的商品数量相乘。此设置仅适用于固定价格。实时运费始终按整个包裹计算。
条件
Min cart weight (kg)：购物车重量低于此值时隐藏该方式。0 表示无限制。
Max cart weight (kg)：购物车重量高于此值时隐藏该方式。默认值：22。0 表示无限制。Australia Post 包裹限制：国内 22 kg，国际 20 kg。
Minimum order amount：仅当购物车小计达到此金额时才显示该方式。留空则始终显示。
Excluded shipping classes：如果购物车中任一商品属于这些 WooCommerce 配送类别，则隐藏该方式。
Free shipping：开启满额免运费，门槛见下方。
Free shipping from：购物车小计达到此金额时免运费。在这种情况下不会向 API 发送请求。
不使用配送区域时的可用范围
Ignore shipping zones：无论匹配哪个区域，都为下方指定的国家提供该方式。
Countries：此模式下的目的地国家。留空则使用您店铺可配送的所有国家。仅在开启 Ignore shipping zones 时使用。
高级
Debug log：将运费计算记录到 WooCommerce > Status > Logs，来源为「vfd-australia-post」。API 错误始终会被记录。API 密钥和顾客邮政编码不会被记录。
Remove data on uninstall：开启后，删除插件时会移除其设置、区域方式和缓存的运费。停用插件不会删除任何内容。
结账时的工作流程
顾客输入配送地址后，WooCommerce 会向插件请求运费。插件首先检查购物车重量、Minimum order amount 和 Excluded shipping classes。如果适用免运费，则运费为 0，且不会向 Australia Post 发送请求。
在固定价格模式下，价格取自表格。在实时运费模式下，插件会向 Australia Post 发送包裹重量；国内配送时还会发送发货和收货邮政编码以及包裹尺寸；国际配送时发送目的国家。只有顾客输入 4 位邮政编码后，才会请求国内实时运费。如果包裹超出 Australia Post 限制（国内 22 kg 或 105 cm，国际 20 kg），则不发送请求。AUD 价格按您的汇率换算；如果开启了 Remove GST，国内价格中的 GST 会被扣除。
每个成功的响应缓存 1 小时，因此同一购物车不会再次触发请求。失败的请求缓存 10 分钟，因此结账页面不会在每次刷新时都等待 Australia Post。API 错误绝不会显示给顾客：该方式会被隐藏，或在备用模式下使用固定价格。
该方式适用于经典结账以及购物车和结账区块。它兼容 WooCommerce 高性能订单存储（HPOS）。
插件仅计算运费。它不会创建配送标签、eParcel 或 MyPost Business 发货单或舱单，不跟踪包裹，也不允许顾客选择包裹储物柜或邮局。购物车始终按一个包裹计价。信件、satchel 包裹和合同（eParcel）运费不在此范围内。
许可证密钥
插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Australia Post 的顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入另一个密钥，使用 Remove key 将其从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，结账时不会向顾客显示 Australia Post。已登录的店铺管理员仍能看到该方式，并带有 (unlicensed — visible to admins only) 标记，以便您在购买密钥之前设置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响。
许可证过期后，插件仍可继续工作，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账时没有显示 Australia Post：请检查许可证是否有效、Enable/Disable 是否开启，以及该方式是否已添加到顾客所在国家的区域中（或已开启 Ignore shipping zones 且允许该国家）。检查购物车重量限制、Minimum order amount 和 Excluded shipping classes。在固定价格模式下，请检查该国家或 * 是否设置了价格。
实时运费不显示：开启 Debug log，重新加载结账页面，然后打开 WooCommerce > Status > Logs（来源「vfd-australia-post」）。日志会显示原因：缺少 API 密钥或发货邮政编码、尚未输入 4 位收货邮政编码、包裹超出限制、缺少 AUD 汇率，或 Australia Post 返回的错误信息。使用 Live rates, fixed price if the API gives no rate 时，顾客在您解决问题期间仍会看到固定价格。
我的店铺不是 AUD：在 AUD → (your currency) rate 中输入汇率（1 AUD 等于多少您的货币单位）。固定价格始终以您店铺的货币计价。
运费被重复征收 GST：Australia Post 的国内价格包含 10% 的 GST。如果 Tax status 为 Taxable，请开启 Remove GST。
价格过高或过低：请检查商品重量和尺寸，以及 Parcel for live rates 中的默认值。使用 Item (price × quantity) 时，固定价格会乘以商品数量。
修改后运费看起来过时：保存设置页面。这会清除 Australia Post 的缓存运费。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 以便为新域名激活密钥。如果无法连接许可证服务器，插件将继续使用最近一次已知的状态运行。
卸载
停用插件会保留所有数据。要删除插件，请先停用，然后在 Plugins 页面中删除。该插件的许可证密钥和许可证状态始终会被删除。只有在开启了 Remove data on uninstall 的情况下，设置、区域方式和缓存的运费才会被删除；否则它们会保留，以便之后重新安装时使用。现有订单会保留其配送明细。
Australia Post 是其各自所有者的商标。本插件与 Australia Post 无关联，也未获其认可。