VibeFox Bob Go for WooCommerce — 帮助

系统要求

WordPress：5.8 或更高版本。

WooCommerce：5.0 或更高版本，已安装并启用。没有 WooCommerce 时插件无法激活。

PHP：8.0 或更高版本。

Bob Go 账户（仅实时运费需要）：Bob Go 没有 API 密钥。您需要一个 Bob Go 账户（bobgo.co.za），在 Bob Go 账户中将您的 WooCommerce 店铺安装为销售渠道（Sales channels），并为该渠道启用「Rates at checkout」，同时在 Bob Go 中设置好服务和价格。如果您只使用固定运费，则无需 Bob Go 账户。

VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。

安装

1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 vfd_bob_go 文件夹上传到 /wp-content/plugins/。

2. 点击 Activate。

3. 在您的 Bob Go 账户中，将 WooCommerce 店铺安装为销售渠道。为该渠道启用「Rates at checkout」，并设置您的服务和价格。

4. 打开设置：WooCommerce > Settings > Shipping > VibeFox Bob Go，或在插件页面点击插件名称下方的 Settings。

5. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。

6. 检查店铺域名、发货地址（ship from），如果店铺货币不是 ZAR，还要检查 ZAR 汇率（参见「配置」）。

7. 在 WooCommerce > Settings > Shipping > Shipping zones 中，将 VibeFox Bob Go 添加到南非的配送区域，或开启 Ignore shipping zones。

配置

所有设置都在同一页面：WooCommerce > Settings > Shipping > VibeFox Bob Go。这些设置适用于所有配送区域。每次保存设置时，缓存的 Bob Go 运费都会被清除。将该方式添加到某个区域时，区域窗口中只有一个字段：

Title (zone)：该区域中固定运费和免运费显示的名称。留空则使用全局的 Method title。实时 Bob Go 运费始终使用在 Bob Go 中配置的服务名称显示。

常规

Enable/Disable：一次性在所有区域中启用或禁用该方式。

Method title：在固定运费和免运费时显示给顾客。区域可以覆盖此名称。实时 Bob Go 运费使用 Bob Go 中的服务名称显示，例如 "The Courier Guy - Economy"。默认值：Bob Go。

Shipping cost：运费的计算方式。

实时运费缺失的原因会写入日志，从不向顾客显示。

Bob Go 账户

此部分显示 Bob Go 对您店铺域名的最近一次响应：connected、the WooCommerce channel is not installed on Bob Go (HTTP 404)、"Rates at checkout" is not enabled for this channel (HTTP 401)，或其他错误。如果店铺货币不是 ZAR 且未设置汇率，此处还会提示未请求实时运费。

Store domain：Bob Go 通过域名识别您的店铺。留空则使用您网站的域名。只有当您在 Bob Go 中的渠道安装在其他地址时才需要输入其他域名，例如子文件夹中的店铺可填写 example.co.za/shop。

ZAR conversion rate：Bob Go 以南非兰特（ZAR）报价。如果店铺货币不是 ZAR，请输入 1 ZAR 等于店铺货币的金额，例如 EUR 填写 0.05。运费会据此换算，商品价格会以 ZAR 发送给 Bob Go。留空则不以您的货币使用 Bob Go 实时运费（固定运费仍可使用）。如果店铺货币就是 ZAR，请留空。小数点和逗号都可以作为小数分隔符。

Delivery dates：在运费名称中显示 Bob Go 提供的预计送达日期范围。该预计日期始终与订单一同保存，并显示在订单页面上。

发货地（出发地址）

每次请求运费时，出发地址都会发送给 Bob Go。如果您在 WooCommerce > Settings > General 中设置的店铺地址位于同一国家，则空白字段会从中自动填写。

Origin country：您发货所在的国家。默认：南非。Bob Go 仅在南非境内配送。

Origin province：南非的一个省，或 Store province (if in South Africa)。

Origin city / suburb：您发货所在的城市或郊区，例如 Johannesburg。

Origin postal code：您发货所在的邮政编码，例如 2001。

Origin street address：您发货所在的街道地址。

固定运费（用于固定模式，以及在 Bob Go 未返回运费时作为备用方案）

Price per country：每个国家一行：2 位国家代码、等号以及以店铺货币表示的价格，例如 ZA=99.99。使用 * 表示所有其他国家，例如 *=199.99。格式不符的行会在保存时被删除。

Flat price：对于上方没有对应行的国家，以店铺货币表示的价格。留空则对这些国家隐藏该方式。

Fixed price applies：Per order 只收取一次价格。Per item (price × quantity) 则按购物车中的商品数量相乘。实时 Bob Go 运费始终针对整个发货。

条件

Minimum weight (kg)：购物车重量低于此值时隐藏该方式。0 表示无限制。

Maximum weight (kg)：购物车重量高于此值时隐藏该方式。0 表示无限制（默认）。

Minimum order amount：仅当购物车小计（折扣后、税前）至少达到此金额时才显示该方式。留空则始终显示。

Excluded shipping classes：如果购物车中包含属于这些 WooCommerce 配送类别的任何商品，则隐藏该方式。

Free shipping：达到下方设置的订单金额时开启免运费。

Free shipping from：享受免运费所需的购物车小计（折扣后、税前）。仅在 Free shipping 开启时使用。此时不会向 Bob Go 请求运费。

Tax status：Taxable 会将 WooCommerce 税费加到运费上，None 则不加。Bob Go 运费通常已包含增值税（VAT）。在这种情况下请选择 None，以免重复收税。

无配送区域时的可用性

Ignore shipping zones：即使未将该方式添加到配送区域，也为下方指定的国家提供 Bob Go。

Countries：该模式的目的地国家。留空则使用您发货的所有国家。仅在 Ignore shipping zones 开启时使用。

高级

Debug log：将运费计算和 Bob Go 请求记录到 WooCommerce > Status > Logs，来源为 "vfd_bob_go"。不记录顾客地址。即使此选项关闭，API 错误仍会被记录。

Remove data on uninstall：开启时，删除插件将移除所有 Bob Go 设置、区域方式和缓存的运费。停用插件从不会删除任何内容。

结账时的工作方式

顾客输入配送地址后，插件会检查购物车重量、Minimum order amount 和 Excluded shipping classes。如果适用免运费，顾客会看到该方式显示为 Bob Go (free)，并且不会向 Bob Go 发送任何请求。

在实时模式下，插件会向 Bob Go 发送您的店铺域名、发货地址和配送地址，以及购物车商品（商品价格以 ZAR 计）。只有在顾客输入城市或邮政编码之后才会请求实时运费。Bob Go 返回的每项服务都会作为单独的配送选项显示，并带有其 Bob Go 名称；如果开启了 Delivery dates，还会显示预计送达日期。当店铺货币不是 ZAR 时，ZAR 运费会使用 ZAR conversion rate 换算。

运费按购物车和地址缓存 1 小时，因此同一购物车不会触发新的请求。失败的请求会缓存 5 分钟，超时时间为 12 秒，因此 Bob Go 故障不会拖慢每次结账页面更新。请求失败绝不会导致结账中断：该方式会被隐藏，或在备用模式下使用固定价格。原因会写入 WooCommerce 日志。

所选的 Bob Go 服务代码和送达预估会与订单的配送行一同保存，并在订单页面上以 Bob Go service 和 Estimated delivery 显示。

该方式适用于经典结账以及购物车和结账区块。它兼容 WooCommerce 高性能订单存储（HPOS）。

插件仅显示运费。它不会创建发货单、运单或面单，不跟踪包裹，不会将订单同步到 Bob Go，也不发送电子邮件通知。发货请使用 Bob Go 控制面板（或 Bob Go 自身的订单同步功能）。它不提供自提点或智能柜选择（Bob Box、Pargo），结账时也没有额外的郊区字段。Bob Go 仅在南非境内配送。

许可证密钥

本插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Shipping > VibeFox Bob Go 页面的顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。

一个密钥只能用于一个域名。从站点移除密钥并不会释放其域名名额，请在您的 vibefox.net 账户中释放该名额。

没有有效密钥时，结账页面不会向顾客显示 Bob Go。已登录的店铺管理员仍能看到它，并标有 (unlicensed — visible to admins only)，这样您可以在购买密钥之前设置和测试插件。插件页面和 WooCommerce 页面上会出现提醒。现有订单不受影响。

许可证到期后，插件仍可继续工作，但更新和支持需要续费。状态会在后台自动重新检查。

故障排除

结账页面中没有 Bob Go：请检查许可证是否有效、Enable/Disable 是否开启、该方式是否已添加到顾客所在国家的配送区域（或已开启 Ignore shipping zones 且该国家被允许）。检查重量限制、Minimum order amount 和 Excluded shipping classes。在固定模式下，请检查该国家、* 或 Flat price 是否设置了价格。

未显示任何 Bob Go 运费：打开插件设置。Bob Go account 部分显示 Bob Go 的最近一次响应。「Channel is not installed」（HTTP 404）表示店铺域名不是 Bob Go 中的销售渠道：请检查 Store domain。「Rates at checkout is not enabled」（HTTP 401）表示该渠道未启用此功能。同时请确认顾客已输入城市或邮政编码，并且对于非 ZAR 店铺已设置 ZAR conversion rate。开启 Debug log，然后在 WooCommerce > Status > Logs（来源 "vfd_bob_go"）中查看详细信息。启用 Bob Go live rates, fixed prices if Bob Go returns no rates 后，在您修复问题期间，顾客仍会获得固定价格。

我的店铺不使用兰特：Bob Go 以 ZAR 报价。请输入 1 ZAR 等于店铺货币的金额（例如 EUR 填写 0.05）。否则插件不会向 Bob Go 请求运费。固定运费仍可使用。

运费被重复收税：Bob Go 运费通常已包含增值税（VAT）。请将 Tax status 设为 None。

修改后运费看起来过时：保存设置页面。这会清除缓存的 Bob Go 运费。您在 Bob Go 账户中的更改会在 1 小时缓存过期后或保存设置时生效。

许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 以为新域名激活该密钥。如果无法连接许可证服务器，插件将继续使用最后一次已知的状态工作。

卸载

停用插件会保留所有数据。要删除它，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥和许可证状态始终会被删除。设置、区域方式和缓存的运费仅在 Remove data on uninstall 开启时才会被删除；否则会保留，以便日后重新安装时使用。现有订单会保留其配送行。

Bob Go 是其各自所有者的商标。本插件与 Bob Go 无关联，也未获得 Bob Go 的认可。